Full download Multimedia on symbian os inside the convergence device symbian press 1st edition adi r

Page 1


https://ebookgate.com/product/multimedia-onsymbian-os-inside-the-convergence-device-symbianpress-1st-edition-adi-rome/

More products digital (pdf, epub, mobi) instant download maybe you interests ...

The Symbian OS Architecture Sourcebook Design and Evolution of a Mobile Phone OS Symbian Press 1st Edition Ben Morris

https://ebookgate.com/product/the-symbian-os-architecturesourcebook-design-and-evolution-of-a-mobile-phone-os-symbianpress-1st-edition-ben-morris/

Qt for Symbian 1st Edition Frank H. P. Fitzek

https://ebookgate.com/product/qt-for-symbian-1st-edition-frank-hp-fitzek/

MacRuby The Definitive Guide Ruby and Cocoa on OS X 1st Edition Matt Aimonetti

https://ebookgate.com/product/macruby-the-definitive-guide-rubyand-cocoa-on-os-x-1st-edition-matt-aimonetti/

In the Name of Rome The Men Who Won the Roman Empire First Yale University Press Edition Adrian Goldsworthy

https://ebookgate.com/product/in-the-name-of-rome-the-men-whowon-the-roman-empire-first-yale-university-press-edition-adriangoldsworthy/

From Paul to Valentinus Christians at Rome in the First Two Centuries 1st Fortress Press Ed Edition Peter Lampe

https://ebookgate.com/product/from-paul-to-valentinus-christiansat-rome-in-the-first-two-centuries-1st-fortress-press-ed-editionpeter-lampe/

The History of Make Believe Tacitus on Imperial Rome 1st Edition Holly Haynes

https://ebookgate.com/product/the-history-of-make-believetacitus-on-imperial-rome-1st-edition-holly-haynes/

Perspectives on Multimedia Communication Media and Information Technology 1st Edition Robert Burnett

https://ebookgate.com/product/perspectives-on-multimediacommunication-media-and-information-technology-1st-editionrobert-burnett/

Handbook of Research on Mobile Multimedia Ismail Khalil Ibrahim (Editor)

https://ebookgate.com/product/handbook-of-research-on-mobilemultimedia-ismail-khalil-ibrahim-editor/

Patterns on z OS connecting self service applications to the enterprise 1st ed Edition Franck Injey

https://ebookgate.com/product/patterns-on-z-os-connecting-selfservice-applications-to-the-enterprise-1st-ed-edition-franckinjey/

MultimediaonSymbianOS

InsidetheConvergenceDevice

LeadAuthors

AdiRomeandMarkWilcox

With KevinButchart,JohnForrest,RobertHeal,KostyantynLutsenko, JamesNash

Foreword

AndrewTill(Motorola)

Reviewers

FadiAbbas(Scalado),PhyllisiaAdjei,LesClark,Patrick Cumming,JamesCurry,BrianEvans,MagnusIngelsten (Scalado),AmandaKamin,PetteriKangaslampi,RomanKleiner, PamelaLopez,AnthonyNewpower, MikeRoshko,JoStichbury,G ´ aborT ¨ or ¨ ok

HeadofSymbianPress FreddieGjertsen

ManagingEditor SatuMcNabb

A John Wiley and Sons, Ltd., Publication

MultimediaonSymbianOS

InsidetheConvergenceDevice

MultimediaonSymbianOS

InsidetheConvergenceDevice

LeadAuthors

AdiRomeandMarkWilcox

With KevinButchart,JohnForrest,RobertHeal,KostyantynLutsenko, JamesNash

Foreword

AndrewTill(Motorola)

Reviewers

FadiAbbas(Scalado),PhyllisiaAdjei,LesClark,Patrick Cumming,JamesCurry,BrianEvans,MagnusIngelsten (Scalado),AmandaKamin,PetteriKangaslampi,RomanKleiner, PamelaLopez,AnthonyNewpower, MikeRoshko,JoStichbury,G ´ aborT ¨ or ¨ ok

HeadofSymbianPress FreddieGjertsen

ManagingEditor SatuMcNabb

A John Wiley and Sons, Ltd., Publication

Copyright  2008JohnWiley&SonsLtd,TheAtrium,SouthernGate,Chichester, WestSussexPO198SQ,England

Telephone(+44)1243779777

Email(forordersandcustomerserviceenquiries):cs-books@wiley.co.uk VisitourHomePageonwww.wileyeurope.comorwww.wiley.com

AllRightsReserved.Nopartofthispublicationmaybereproduced,storedinaretrievalsystemortransmittedinanyform orbyanymeans,electronic,mechanical,photocopying,recording,scanningorotherwise,exceptunderthetermsofthe Copyright,DesignsandPatentsAct1988orunderthetermsofalicenceissuedbytheCopyrightLicensingAgencyLtd, 90TottenhamCourtRoad,LondonW1T4LP,UK,withoutthepermissioninwritingofthePublisher.Requeststothe PublishershouldbeaddressedtothePermissionsDepartment,JohnWiley&SonsLtd,TheAtrium,SouthernGate, Chichester,WestSussexPO198SQ,England,oremailedtopermreq@wiley.co.uk,orfaxedto(+44)1243770620. Designationsusedbycompaniestodistinguishtheirproductsareoftenclaimedastrademarks.Allbrandnamesand productnamesusedinthisbookaretradenames,servicemarks,trademarksorregisteredtrademarksoftheirrespective owners.ThePublisherisnotassociatedwithanyproductorvendormentionedinthisbook.

Thispublicationisdesignedtoprovideaccurateandauthoritativeinformationinregardtothesubjectmattercovered.It issoldontheunderstandingthatthe Publisherisnotengagedin renderingprofessionalservices.Ifprofessionaladviceor otherexpertassistanceisrequired,theservicesofacompetentprofessionalshouldbesought.

OtherWileyEditorialOffices

JohnWiley&SonsInc.,111RiverStreet,Hoboken,NJ07030,USA

Jossey-Bass,989MarketStreet,SanFrancisco,CA94103-1741,USA Wiley-VCHVerlagGmbH,Boschstr.12,D-69469Weinheim,Germany

JohnWiley&SonsAustraliaLtd,42McDougallStreet,Milton,Queensland4064,Australia

JohnWiley&Sons(Asia)PteLtd,2ClementiLoop#02-01,JinXingDistripark,Singapore129809 JohnWiley&SonsCanadaLtd,6045FreemontBlvd,Mississauga,Ontario,L5R4J3,Canada Wileyalsopublishesitsbooksinavarietyofelectronicformats.Somecontentthatappears inprintmaynotbeavailableinelectronicbooks.

BritishLibraryCataloguinginPublicationData

AcataloguerecordforthisbookisavailablefromtheBritishLibrary ISBN978-0-470-69507-4

Typesetin10/12OptimabyLaserwordsPrivateLimited,Chennai,India

PrintedandboundinGreatBritainbyBell&Bain,Glasgow

Thisbookisprintedonacid-freepaperresponsiblymanufacturedfromsustainableforestry inwhichatleasttwotreesareplantedforeachoneusedforpaperproduction.

Authors’Biographiesxvii

Authors’Acknowledgementsxxi

SymbianPressAcknowledgmentsxxiii CodeConventionsandNotationsxxv 1Introduction1

1.1TheConvergenceDevice1

1.2TransformationoftheMediaIndustry3

1.3SymbianOS5

1.4TheCuttingEdge6

1.5EvolutionoftheMultimediaSubsystemin SymbianOS8

1.6APeekintotheFuture12 2MultimediaArchitecture15

2.1TheECOMFramework15

2.2PlatformSecurity16

2.3TheContentAccessFramework21

2.4MultimediaSubsystem23

2.5FutureMultimediaSupport31

3TheOnboardCamera35

3.1Introduction35

3.2AccessingtheCamera36

3.3CameraControl39

3.4DisplayingtheViewfinder43

3.5CapturingStillImages46

3.6CapturingVideo49

3.7ErrorHandling52

3.8AdvancedTopics53

4MultimediaFramework:Video55

4.1VideoConcepts55

4.2SymbianOSVideoArchitecture57

4.3ClientAPIIntroduction60

4.4IdentifyingVideoControllers61

4.5ControllingVideoPlayback62

4.6ControllingScreenOutput71

4.7GettingVideoInformation81

4.8AccessingMetadata83

4.9ControllingtheAudioOutput84

4.10StreamingPlayback87

4.11RecordingVideo88

4.12ControllingtheVideothatIsRecorded93

4.13ControllingtheAudiothatIsRecorded97

4.14StoringMetadata100

4.15CustomCommands101

4.16ExamplesandTroubleshooting102

5MultimediaFramework:Audio105

5.1Introduction105

5.2AudioInputandOutputStreams107

5.3AudioPlayerUtility117

5.4AudioRecorderUtility122

5.5FileConversion127

5.6ToneUtility129

5.7DevSound134

5.8AudioPolicies135

5.9PrioritySettings137

5.10Miscellaneous138

6ImageConversionLibrary141

6.1Introduction141

6.2DecodingImages144

6.3EncodingImages174

6.4DisplayingImages181

6.5TransformingImages185

6.6NativeBitmapOperations189

6.7MiscellaneousAPIs193

7TheTunerAPI197

7.1Introduction197

7.2GettingStarted198

7.3BasicUseCases201

7.4FutureTechnologies206

7.5SampleCode207

8BestPractice209

8.1AlwaysUseanActiveScheduler209

8.2UseAPPARCtoRecognizeAudioandVideo210

8.3Don’tUsetheVideoPlayertoOpenAudioFiles212

8.4KnowthatMMFandICLCannotDetectSome Formats212

8.5Don’tUse CMdaAudioOutputStream for NetworkStreaming213

8.6Use CMdaAudioPlayerUtility toPlayTone SequenceFiles215

8.7Use CMdaAudioPlayerUtility toPlayClips215

8.8Don’tHardwireControllerUIDsinPortableCode216

8.9SetControllerThreadPrioritiesBeforePlayingor Recording217

8.10RecognizethatBehaviorVarieswhenSeveral ClientsAreActive218

8.11UnderstandthattheSystemisBasedonPlug-ins219

8.12Use RFile and TMMSource InsteadofPassinga FileName221

8.13ConsidertheVolumeControl222

8.14KnowWhentoUseThreadedRequestsonICL222

8.15Don’tHavetoomanyClients223

8.16UnderstandtheMulti-heapProblem224

ReferencesandResources229 Index233

Foreword

It’snolongernewsthattheworldoftechnologyhasgonemobile.As Symbiancelebratesitstenthanniversary,wecanreflectonthemassive globaluptakeofmobiledevicesoverthepastdecade,whichhasbrought uslaptops,mobilephones,MP3players,digitalcamerasandhandheld videocameras,amongstothers.

InthetenyearssinceSymbianformed,we’vealsoseenthewaywe usetheInternetchangeimmeasurably.Ithasevolvedfromasource ofstaticinformationtodynamic,real-timecontentandameansof socialinteraction.Weincreasinglyseekourentertainmentonlineandwe alsousetheInternettoinstantaneouslysharecontentandengagewith others.Entertainmentisnolongerjustapassive,first-personexperience. Traditionalactivities,suchaswatchingTVorgoingtothemovies,are beingchallengedbyinteractiveexperiencesthatputtheconsumerfirmly incontrol,suchasdigitalandwebTVandstreamedvideoservices.We furtherextendtheexperiencebyusingsharingsitessuchasYouTube; readingandwritingreviewsonblogs;holdingdiscussionsonforums; oraccessingcontentonline.Ourexperiencecanbepersonalizedand sharedinwaysthatwereinconceivablewhenSymbianfirstopenedits doorsforbusiness.

Oncemobiletechnologyandinteractiveentertainmentbecamemainstream,thenextstepwasforthemtoconvergetoyieldentertainmentona mobiledevice.Thedemandformobileentertainmenthasgrownyearon year.Whileitwasoncelimitedtopassiveconsumptionusinghandheld gamesconsolesorportablemusicplayers,itisnowfarmoredynamic. Mobilephonesareameansofdeliveringhigh-qualitymultimedia,such asstreamingmusicormobileTV.Likeafixedcameraorcamcorder, mobilephonescanbeusedtotakepicturesandvideos,buttheycanalso gofarbeyondtheseexperiences,enablingseamlessuploadingdirectly

toblogsorsharingwebsitessuchasFacebook,MySpaceor,more recently,Motorola’sHelloMoto(www.hellomoto.co.uk)andNokia’sOvi (www.ovi.com)services.AswellasplayingMP3sandhigh-qualityringtones,aphonecanalsoplayinteractive,multimediagames,makingthe experiencefarmoresophisticatedthroughmultiplayermodesoronline communities.Theconvergeddeviceoffersmobileconnectedentertainment,withtheabilitytomakecalls,sendmessages,andbrowsethe web–combiningmobility,theInternetandinteractiveentertainmentin asmall,yetpowerfuldevice.

Mobilemultimediaisnolongersomethingwearelookingtoevolveasa marketopportunity;itisalreadyarealityformillionsofconsumersaround theworld.In2007,mobileentertainmentapplicationsalesovertook featureapplicationssuchasPDFreadersandcalculatorapplications. Handango’sYardstick1 dataforsalesofsmartphoneapplicationsby categoryshowsentertainmentproducts–mediaplayersandmobileTV products–asthemostpurchasedduring2007.Thisfigureexcludes games,whichhavetraditionallybeenseenastheprimaryentertainment add-onbythosepurchasingafter-marketapplicationsfortheirphones. Thefigurealsoexcludesdownloadsoffreeapplicationssuchasmobile widgetstoaccessonlinemobileservices.Inshort,thetimeofthemobile multimediadeveloperhasarrived.

Thisenthusiasticuptakeinconsumptionofmedia-richcontentand applicationsis,inpart,downtoanewgenerationofconsumer–‘GenerationC’.Thisgenerationhasgrownupinaworldwherethe Internet,textmessagingandon-demandserviceshavebeenanatural partofthefabricofday-to-daylife.Mobiletechnology,theInternet, interactiveentertainmentandsocialnetworkingarebasicfactorsintheir lives.It’snotanexclusiveclub,though;thesetechnologiesareadopted byabroaddemographicacrosseverycontinent.

ThesuccessofNokia’sNseriesphones,inparticular,theuptakeofthe popularNokiaN95,confirmstheappealoftheconvergeddevice.Itoffers functionalitysuitedtohigh-qualitymultimediaentertainment,surpassing dedicatedsingle-functionconsumerdevicesinmanycategories.ProductsfromMotorola,SamsungandSonyEricssonthathavefocusedon particulartypesofmobileentertainment,suchasphotographyormusic, havecementedtheSymbiansmartphoneastheconsumerconvergence platformofchoice.Atthetimeofgoingtopress,HandangoYardstick datashowedthatthereweremorenewmobilecontenttitlesreleasedfor SymbianOSthananyothersinglesmartphoneplatformin2007andjust over206millionSymbiansmartphonesshippedworldwide;ittookeight yearstoship100millionunitsandonlyafurther18monthsforthenext 100million.

1 TheHandangoYardstickisareportaboutmobileapplications.Yardstickdatais availablefromthePressRoomat corp.handango.com

AtMotorola,weareexcitedbythechancetouseSymbianOSto deliverthebestinteractivemobileapplicationsandexperiences.The MOTORIZRZ8introducedsingle-clickusabilityforseamlessmedia sharing,forexamplewhilephoto-blogging.WiththeMOTOZ10we furtherbuiltonthis,placingprofessionalvideo-editingcapabilitiesinto handsetsforthefirsttime,allowingausertoquicklycreateavideo blogwithaudiodubbing,transitioneffectsandtextoverlays.Theclose relationshipbetweenSymbian,chipsetmanufacturersandUIvendors formsapowerfulplatformforphonemanufacturerslikeustobuildon. WehavebeenabletouseSymbianOStocreatefully-featureddevices whichofferanintuitiveuserexperienceformultimediacreationand playbackandforsharingandeasilydiscoveringnewcontent.Asan openplatformforaftermarketdevelopers,SymbianOSalsohasastrong developerecosystemtoeasethecreationofapplications.Inthefirst quarterof2008,Symbianreportedthat9282third-partySymbianOS applicationshadbeenreleased,a24%increaseon31March2007.2

ThisbookhasbeencreatedbysubjectexpertsinsideSymbianand third-partydeveloperswhohaveworkedwithSymbianOS.Ifyouare planningtoworkwithmobilemultimedia,itdemonstrateshowtouse SymbianOStowriteapowerfulmultimediaapplicationandhowto managethecomplexityandexploitthepoweroftheplatform.Youcan benefitfromthecombinationoftheauthors’experienceandknowledge whilelearninghowtobuildmobileentertainmentapplicationsthatride thewaveofconvergence.

AndrewTill,Motorola,2008.

2 SymbianFastFactsareavailableat www.symbian.com/about/fastfacts.html.

AboutthisBook

ThisbookformspartoftheSymbianPressTechnologyseries.Itexplains theservicesavailabletoC++developerswishingtocreaterichmultimedia experiencesforsmartphonesbuiltonSymbianOSv9.1andlater.

WhatIsCovered?

Chapter1introducestheconvergencetrendsthatmakemobilemultimediaanexcitingmarketsectorinwhichtowork.Thehistoryandevolution ofmultimediaonSymbiansmartphonesiscovered,alongwithalook atwhatthenearfutureholdsintermsofnewfeaturesandfunctionality. Thefirstchapteravoidstechnicaljargonwhereverpossibleandshould beofinteresttoanyonewantingtocatchupwiththelatesttechnological developmentsinthemultimediasectoringeneral,andonSymbianOS inparticular.

Theremainingchaptersofthebookaretechnicalandtargetedat developersworkingwithSymbianOSv9.1andlater.WherethefunctionalitydiscussedisnotavailableinSymbianOSv9.1,butinlaterversions only,thisishighlightedandtheversionwhereitwasintroducedislisted. AlthoughmanyoftheAPIsdescribedwereavailableearlierthanSymbian OSv9.1,wegivenodetailsoftheiruseinearlierversionsandwemake noguaranteesofsourcecompatibility.

DevicesbuiltonSymbianOSv9.1includethosebasedonS603rd Edition(startingwiththeNokia3250,N80andE60)andthosebuilton UIQ3.0(startingwiththeSonyEricssonP990,M600andW950).Alllater

devicesbasedonthesameUIplatformsshouldhavebothsourceand binarycompatibilitywiththeseoriginaldevices(although,ofcourse,they addfurtherfeatures).ForS60thisincludes,forexample,theNokiaN95 andLGKS10(basedonS603rdEditionFeaturePack1,usingSymbian OSv9.2)aswellastheNokiaN96andtheSamsungSGH-L870(based onS603rdEditionFeaturePack2,usingSymbianOSv9.3).OntheUIQ platform,thisalsoincludestheMotorolaMOTORIZRZ8andMOTOZ10 (basedonUIQ3.1andUIQ3.2respectively,bothusingSymbianOS v9.2).

Chapter2looksatthearchitectureofthemultimediasubsystemon SymbianOS,givinganoverviewofthestructure,frameworksandcomponentparts.Italsoprovidessomeessentialbackgroundmaterialonother keyplatformfeaturesrelatedtomultimedia–theECOMframework, platformsecurityandthecontentaccessframework.

Chapter3providesacompleteguidetotheonboardcameraAPI, whichallowsdeveloperstoaccessthedigitalcamerahardwarepresent onmanySymbiansmartphones.Thestepsrequiredtoquerythepresence ofcamerasonadeviceandreservethemforuseareexplained,followed bydetailsofviewfinder,stillimageandvideoframecapturefunctions.

Chapters4and5arededicatedtothevideoandaudiofeatures, respectively,oftheMultimediaFramework(MMF).Thevideochapter explainssomeimportantbackgroundconceptsrelatingtodigitalvideo storageanddelivery.Itthengoesontodescribethecomponentsofthe MMFvideoarchitectureandtheirrolesinplaybackandrecordingbefore examiningtheAPIsavailableforclientapplications.Theaudiochapter deliversanexample-basedwalkthroughofthevariousAPIsavailablefor playingandrecordingsounds,explainingwhichonestouseindifferent scenarios.Followingthat,thereisadiscussionofthelowerlevelsofthe audioinfrastructure,uponwhichtheclientAPIsarebuilt.

Chapter6isanin-depthexplorationoftheImageConversionLibrary (ICL),thepartofSymbianOSusedforanymanipulationofstillimagesor smallanimations.Itcoversencoding,decoding,scalingandrotationof imagesinanyoftheformatssupportedbytheplatform.Someoftheuse casescanbequitecomplexsothereisplentyofexamplecodeavailable toclarifythedetails.Chapter7thenprovidesanintroductiontotheTuner API,whichcanbeusedtoaccessradiotunerhardwareonsomeSymbian smartphones.ItdiscussestheavailabilityanduseofthisfairlysimpleAPI, aswellassomepotentialfutureextensions.

Chapter8discussesbestpracticeformultimediadevelopers.It’s packedwithtipsandtricksthatcouldpotentiallysaveyouhoursof re-designordebugginglaterinyourprojectsandiswellworthaninitial read,thenbookmarkingandreferringtoasyouworkonyourmultimedia project.

WhoIsThisBookFor?

Thecoreaudienceforthisbookisexperiencedapplicationdevelopers wantinganintroductionandreferenceguidetothemultimediafeatures ofSymbianOS.Youwillalsofindthisbookusefulifyouare:

• portingmultimediacodefromotherplatforms

• workingforaphonemanufacturerorapartnercompany,creating newdevicesbasedonSymbianOS

• writingplug-instoextendthemultimediafunctionalityofnewor existingdevices.

Allchaptersbutthefirstinthisbookaretechnicalandassumeaworking knowledgeofSymbianC++.Thebasicidiomsanddetailsofday-to-day working,suchashowtogetaworkingdevelopmentenvironmentor howtocreate‘HelloWorld,’arenotincludedhere.Ifyouneedmore generalinformationaboutdevelopingonSymbianOSitcanbefoundin othertitlesintheSymbianPressseries(seetheReferencesandResources sectionattheendofthisbook).Inaddition,thereareanumberof freepapersandbookletsavailableontheSymbianDeveloperNetwork website(developer.symbian.com).

Whilethisbookdoesn’tcoverthelowestlevelsofthemultimedia subsysteminthedetailrequiredforthedevicecreationcommunity,it doesprovideausefuloverviewforthosehandsetdeveloperswhoare newtothearea.Chapter2,inparticular,shouldbeveryvaluablefor thoseworkingonhardwareabstractionandadaptation,aswellasbuilt-in multimediaapplications.

Similarly,forthosedevelopingmultimediaplug-ins,someoftheimplementationdetailsarebeyondthescopeofthisbook,butanunderstanding oftherelevantframeworkanditsusebyclientapplicationswillhelpyou todeliverbettercomponents.Inanycase,wherethedetailsaremissing fromthisbook,youshouldfindpointerstofurthermaterial.Failingthat, alistofotherresourcescanbefoundintheReferencesandResources section.

Whereappropriate,we’veusedanumberofcodesnippetsineach chapter;thesehavebeentailoredspecificallytoillustratethetopicin question.Forreadability,wehaveavoidedusinglargechunksofexample code.WehaveputthefullcodeoftheprojectsforChapters3and6on thewebsiteforthisbook(developer.symbian.com/multimediabook).You willfindfurtherexamplecodeatthebook’spageontheSymbianDeveloperwiki(developer.symbian.com/multimediabook wikipage).Onthe

wikipage,you’llalsofindusefulinformationaboutthebook,suchas linkstodocumentationandtools,andanerratapage.Pleasefeelfreeto visititregularlyandtocontribute.

TheSymbianFoundation

InJune2008,aswepreparedtotakethisbooktopress,Symbian celebrateditstenthanniversary,andannouncedthatitsassetswouldbe divestedintoanot-for-profitorganizationcalledtheSymbianFoundation (www.symbianfoundation.org).

TheSymbianFoundationhasbeensetuptocreateacomplete,open andfreemobilesoftwareplatformforconvergedmobiledevices,enabling thewholemobileecosystemtoaccelerateinnovation.Toquotefromthe SymbianFoundation’swebsite:

TheSymbianFoundationplatformwillbeavailableunderaroyalty-free licensefromthisnon-profitfoundation.TheSymbianFoundationwill provide,manageandunifytheplatformforitsmembers.Themembership ofthefoundationisopentoanyorganization,withthefoundation’slaunch plannedforthefirsthalf2009 Thefoundationwillprovideoneunified platformwithoneUIframeworkwithfirstreleaseexpectedin2009.

Whilesomedetailsofthemultimediaservicesthisbookdescribes maychangeovertime,weconsiderthatmuchofthematerialit containswillbevalidfortheforeseeablefuture.Tofindthelatest informationandadviceonhowtousethisbookwiththeSymbian Foundationplatform,werecommendyouvisitthisbook’swikipageat developer.symbian.com/multimediabook wikipage.

Authors’Biographies

AdiRome

AdihasaBAinComputerSciencefromTelAvivUniversity.Afteraspellin teaching,sheworkedinqualityassurance,movingtoanalysis,designand implementationofembeddedsystems,beforejoiningSymbianin2004. HavingspentawhileintheMultimediateam,becominginvolvedinall aspectsofthedevelopmentanddeliverysoftwarelifecycle,Adijoined theDeveloperServicesteamasthemultimediaguru.Withinthisteam, shealsoprovidedtechnicalconsultancyacrossallareasofSymbian OS,withaspecialemphasisonhardware–shewasresponsiblefor communicatingtheSymbianroadmaptosiliconandmultimediapartners, andwasSymbian’sleadonthepartnercomponentvalidationprogram. Inaddition,AdiwasinvolvedinsettinguptheSymbianChinapartnerconsultingorganizationandwasingreatdemandforherpresentation skills,havinggivensessionsatawiderangeofpartnerandindustry events,including3GSMWorldCongress.Currentlysheisworkingasan independentconsultantforseveralcompaniesinthetelecommunications industryinIsrael.

MarkhasbeenplayingwithcomputerssincehisdadboughtaZX81when hewasfour.Hewrotehisfirstmultimediaapplication(athree-roomtext adventurewithsoundeffects!)onanAcornElectronwhenhewasseven. ThingswentdownhillfromthereandheendedupwithaMastersdegree inMathematicsfollowedbyabriefstintasaresearchpostgraduatein cyberneticintelligence.

MarkWilcox

In2001,hedecideditwastimetogetaproperjobandstarted developingsoftwareformobilephones.Sincethenhe’sbeeninvolvedin handsetdevelopmentprojectsforEricsson,Fujitsu,Nokia,Panasonicand Samsung.DuringthattimeheworkedoneverythingfromaGPRSstack, devicedriversandapowermanagementservertomessagingapplications andthecodethatdrawsthesoftkeys.However,itwaswhileworking asaSoftwareArchitectforNokia’sMultimediabusinessunit,developing theirflagshipNseriesproducts,thatMarkdevelopedhisinterestinthe multimediacapabilitiesofSymbianOS.

MarkbecameanAccreditedSymbianDeveloperandaForumNokia Championin2007.

JohnForrest

JohnhasbeenaSymbianOSengineerforadecade,workingbothinside andoutsideSymbian.Hewasamemberoftheoriginalteamforthe developmentofbothICLandMMF,andhasbeenaseniormember oftheMultimediateameversince.Priortothathewasalecturerat UMISTformanyyears,teachingprogramming,hardwarelogic,computer architectureandallthingsinbetween.JohnlivesinNorthLondonwith hispartnerandtwoboys.

RobertHeal

RobjoinedSymbianin2004workingasasoftwareengineerforthe Messagingteam.Hespenthisfirstyearintheroleofdefectcoordinator, beforemovingontoactastechnicalleadondevelopmentprojects.After threeyears,RobmovedtotheMultimediateamtobecomethevideo technologyowner,managingandprovidingtechnicalleadershipforthe Multimediavideogroup.

RobhasaBScinSoftwareEngineeringfromBirminghamUniversity. Sincegraduatinghehasworkedinsoftwaredevelopmentrolesfora numberofdifferentcompanies,mostlyinthetelecommunicationssector.

RoblivesinChelmsfordwithhiswife,Cheryl,anddaughter,Lauren. Heenjoysplayinghockeyandhefirmlybelievesthathismanyyearsof experienceinthegamemakeupforhislackofskillandpace.Histeam matesmaybeofadifferentopinion.

KostyantynLutsenko

KostyareceivedanMScequivalentfromtheNationalTechnicalUniversity(KhPI)ofKharkiv,Ukrainein1999.Heworkedforseveral

telecommunications-relatedstart-upsandthenmovedintoSymbian programmingin2002.KostyajoinedtheSymbianmultimediateam in2004wherehewasprimarilyworkingontheImageConversionand CameraAPIsubsystems.Helikesoptimizinggraphicsalgorithmsand takingpartinorienteeringcompetitions,equippedwithamapanda compass.

JamesNash

JamesjoinedSymbianin2005aftercompletingaComputerScience degreeatWarwickUniversity.HehasbeenpartoftheMultimediateam eversincehejoinedbuthasmanagedtogethimselfinvolvedinseveral extraactivitiessuchasassistingalicenseeon-site,performingtechnology demonstrationsattradeshowsand,mostrecently,contributingachapter tothisbook.

Whennotatworkplayingwithshinygadgets,heenjoysdrawing, watchingfilmsandcooking(aslongashedoesn’tneedtowashup afterwards).

Authors’Acknowledgements

AdiRome

Deliveringanewlifeandthismanuscriptatthesametimewasvery challenging.AspecialthankyoutoMarkforsteppinginandgetting involvedwhenIneededitmost.Furtherthankstoeachandeveryauthor andreviewerforbringingtheirbreadthofknowledgeandexperienceto thebookandsomakingitspecialandcolorful.

ItwasarealpleasureformetoworkwiththeSymbianPressteam: Satutrackedeverystepoftheprojectandmadesurethatalltaskswere deliveredonscheduleandJo’sdedication,wideknowledgeandopen mindmadeherawonderfulpersonforbrainstorming.

Finally,Iwouldalsoliketothankmyhusband,Isaac,forhisconstant supportandforputtingupwithmypregnancyhormonescombinedwith thepressureoftryingtocompletethebookbeforethebirthofourfirst child,Eyal.

IwouldliketothankAdi,bothforherinitialworkonthebookand alsofordecidingthatdeliveringamanuscriptontimewasn’tsufficiently challengingandchoosingtodeliveranewlifeintotheworldinstead, givingmetheopportunitytogetmoreinvolvedwiththeproject.I’dalso liketothanktheotherauthors,withoutwhomtherewouldbenobook, andthereviewersforaddingtheiruniqueinsights.Specialmentionis duetoMikeRoshko,whowentbeyondthecallofdutytoreviewseveral chaptersoutsideofworkinghoursatthelastminuteandalsotracked downhiscolleaguestogetthemtoanswerqueries.

MarkWilcox

TheteamatSymbianPressarearealpleasuretoworkwith,eternally friendlyandhelpful.Satu’stactandskillatgettingsubmissionsand updatesfrombusycontributorsonscheduleistheonlyreasonyou’re abletoreadthisatall.Jo’sdedicationtotheclarityandaccuracyofthe texthasbeenarealinspiration;hertirelesseffortstofindtherightpeople toanswerqueriesandfillknowledgegapswillbenefiteveryonewho readsthisandwereverymuchappreciated.

Last,butnotleast,Iwouldliketothankmywife,Lara,forputting upwiththenearconstantpresenceofmylaptopandsupportingme throughout–despitemycompletelackofabilitytothinkandlistenatthe sametime!

SymbianPressAcknowledgments

SymbianPresswouldliketothankeveryoneinvolvedintheproductionof thisbook.InitiatedbyFreddieGjertsenandPhilNortham,itwasnurtured byPetteriKangaslampi,JamesNashandBrianEvans,beforewehanded itovertoAdiRome,ourleadauthor.Shebroughtordertoourproposed contents,withassistancefromAnthonyNewpowerandKevinButchart. WiththehelpofLesClarkandAndreasAndersen,wedraftedinauthors fromSymbianintheshapeofRobertHeal,JohnForrest,JamesNash,and weexpandedourauthorrosterwiththeexternalexpertiseofMarkWilcox andKostyaLutsenko.Satu,asever,managedthisprojectwithefficiency, tenacityandskill.TheexpertteamatWileyhavesteeredusthroughout. ThankyoutoRosie,Sally,Colleen,Hannah,Claire,BrettandShena.

Afewweeksbeforedeliveringthemanuscript,Adideliveredason, Eyal,andhandedcompletionoftheprojecttoMarkWilcox,whoeffortlesslyeditedthechaptersintotheirfinalform.We’reeternallygratefulto himforhiscontributionsthroughouttheproject,andtoAdiforherinitial workonthebook.We’dalsoliketothankallthereviewers,whogave exemplaryfeedbackundertightdeadlines.ThanksMike,Patrick,James, Roman,Brian,Petteri,G´abor,Pamela,LesandAnthony.We’dalsolike toacknowledgeMagnusIngelstenandFadiAbbasfromScalado,fortheir reviewofChapter3,andAndrewTillofMotorola,forcontributingthe Foreword.

ThanksalsogotoAnnabelCookefortheimagesusedinChapter1 andtoLaneRoberts,foractingasofficialarchivist,andcastinghismind backintimetothedaysofthemediaserver.

It’sbeenahugeproject,withmanypeopleinvolved.Ifwe’vemissed thankinganyonehere,weapologize.Youknowwhoyouare,andthank you!

CodeConventionsandNotations

Foryoutogetthemostoutofthisbook,let’squicklyrunthroughthe notationweuse.Thetextisstraightforwardandwherewequoteexample code,resourcefilesorprojectdefinitionfiles,theywillbehighlightedas follows:

Thisisexamplecode;

SymbianC++usesestablishednamingconventions.Weencourage youtofollowtheminorderforyourowncodetobeunderstoodmost easilybyotherSymbianOSdevelopers,andbecausetheconventions havebeenchosencarefullytoreflectobjectcleanupandownership, andtomakecodemorecomprehensible.Anadditionalbenefitofusing theconventionsisthatyourcodecanthenbetestedwithautomatic code-analysistoolsthatcanflagpotentialbugsorareastoreview.

Ifyouarenotfamiliarwiththem,thebestwaytogetusedtothe conventionsistolookatcodeexamplesinthisbookandthoseprovided withyourchosenSDK.

Capitalization

Thefirstletterofclassnamesiscapitalized:

classTColor;

Thewordsmakingupvariable,classorfunctionnamesareadjoining, withthefirstletterofeachwordcapitalized.Classesandfunctionshave theirinitiallettercapitalizedwhile,incontrast,functionparameters,local, globalandmembervariableshavealowercasefirstletter.

Apartfromthefirstletterofeachword,therestofeachwordisgiven inlowercase,includingabbreviations.Forexample:

voidCalculateScore(TIntaCorrectAnswers,TIntaQuestionsAnswered); classCActiveScheduler; TIntlocalVariable; CShape*iShape; classCBbc;//Abbreviationsarenotusuallywritteninuppercase

Membervariablesareprefixedwithalowercase‘i’whichstandsfor ‘instance’:

TIntiCount; CBackground*iBitmap;

Parametersareprefixedwithalowercase‘a’whichstandsfor‘argument’:

voidExampleFunction(TBoolaExampleBool,constTDesC&aName);

Wedonotuse‘an’forargumentsthatstartwithavowel: TBool aExampleBool ratherthan TBoolanExampleBool. Localvariableshavenoprefix:

TIntlocalVariable; CMyClass*ptr=NULL;

Classnamesshouldbeprefixedwiththeletterappropriatetotheir SymbianOStype(usually‘C’,‘R’,‘T’or‘M’):

classCActive; classTParse; classRFs; classMCallback;

Constantsareprefixedwith‘K’:

constTIntKMaxFilenameLength=256; #defineKMaxFilenameLength256

Enumerationsaresimpletypesandsoareprefixedwith‘T’.Enumerationmembersareprefixedwith‘E’:

enumTWeekdays {EMonday,ETuesday,...};

Suffixes

Atrailing‘L’onafunctionnameindicatesthatthefunctionmayleave:

voidAllocL();

Atrailing‘C’onafunctionnameindicatesthatthefunctionreturnsa pointerthathasbeenpushedontothecleanupstack:

CCylon*NewLC();

Atrailing‘D’onafunctionnamemeansthatitwillresultinthe deletionoftheobjectreferredtobythefunction.

TIntExecuteLD(TIntaResourceId);

Underscores

Underscoresareavoidedinnamesexceptinmacros(__ASSERT_DEBUG) orresourcefiles(MENU_ITEM).

CodeLayout

ThecurlybracketlayoutconventioninSymbianOScode,usedthroughoutthisbook,istoindentthebracketaswellasthefollowingstatement:

Another random document with no related content on Scribd:

suorittavat ne, jotka liikkuvat lukemattomilla merillä, monissa eri ilmastoissa ja useiden vieraiden kansojen keskuudessa hankkiakseen sitä, mitä nimitetään onnen antimiksi; ne taas, joihin ryhdytään sekä Jumalan että maailman tähden, kuuluvat urhoollisille sotureille, jotka tuskin ehtivät huomata vihollisen varustuksissa pyöreän tykinkuulan kokoisen aukon, kun jo yhtään pelkäämättä, ollenkaan harkitsematta ja varomatta uhkaavaa vaaraa, halunsa siivittäminä pyrkivät taistelemaan uskonsa, isänmaansa ja kuninkaansa puolesta syöksyen pelkäämättä niihin tuhansiin kuolemanvaaroihin, jotka ovat heitä odottamassa. Semmoisiin tehtäviin yleensä käydään, ja niistä koituu kunniaa, mainetta ja hyötyä, vaikka niihin liittyy lukemattomia vastuksia ja vaaroja; mutta siitä, jonka sinä sanot mieliväsi aloittaa ja toteuttaa, ei sinulle koidu Jumalan kunniaa, ei onnen antimia eikä mainetta ihmisten keskuudessa; vaikka näet suoriudutkin siitä toiveesi mukaisesti, et kumminkaan tule tyytyväisemmäksi, et rikkaammaksi etkä kunnioitetummaksi kuin olet nyt; jos taas et suoriudu, joudut suurimpaan kurjuuteen, mitä ajatella saattaa, sillä silloin ei sinun auta ajatella, ettei kukaan tiedä sinua kohdanneesta onnettomuudesta, koska sinua riittävästi kiduttaa ja tuhoaa se, että itse sen tiedät. Tämän totuuden varmennukseksi luen sinulle tässä stanssin, jonka on sepittänyt kuuluisa runoilija Luigi Tansillo[13] sijoittaen sen Pyhän Pietarin kyynelten ensimmäiseen osaan. Se kuuluu näin:

Kun aamu koittaa, mieltä Pietarin jää häpeä ja tuska tuivertamaan; hän yksin on, mut häpee kuitenkin, käy synnintunto sydänjuuriin hamaan: näät ilmitulo synnintuskihin jaloa miest' ei yksin murra lamaan — hän lankeemustaan häpee vaikertain, vaikk' ois sen nähneet maa ja taivas vain.

Sinä et siis voi tuskaasi välttää, vaikka sen salaat; päinvastoin: joudut itkemään lakkaamatta, ja elleivät silmäsi kostukaan, vuodatat kumminkin sydämen verikyyneliä, niinkuin niitä vuodatti se yksinkertainen tohtori, jonka runoilijamme kertoo tehneen maljakokeen,[14] minkä tekemisestä Rinaldo, paremmin asiaa harkiten, pidättyi; vaikka näet tuo onkin runoilijan keksimää, sisältyy siihen kumminkin salattua opettavaa tarkoitusta, joka kannattaa ottaa huomioon, ymmärtää ja omaksua toimintansa ohjeeksi. Sitä suuremmalla syyllä, kun sinä tulet siitä, mitä nyt aion sinulle sanoa, täysin tajuamaan, kuinka väärin mielit menetellä. Sanohan minulle, Anselmo: jos taivas tai onnellinen sattuma olisi tehnyt sinusta erinomaisen hienon timantin haltian ja laillisen omistajan ja kaikki jalokivisepät, joille sitä näyttäisit, olisivat vakuutettuja sen oivallisuudesta ja aitoudesta sekä kaikin yhteen ääneen ja yksimielisesti selittäisivät sen arvoltaan, oivallisuudeltaan ja puhtaudeltaan niin hyväksi kuin semmoinen kalleus konsanaan voi olla, ja sinä itse uskoisit samoin, tietämättä mitään, mikä saattaisi vakaumustasi horjuttaa, niin olisiko oikein, jos sinun tekisi mieli ottaa se timantti, asettaa se vasaran ja alasimen vähin ja vain huimasti iskemällä koetella, onko se niin luja ja hieno kuin väitetään? Entä sitten, jos aikeesi toteuttaisit: eihän jalokivi, jos se kestäisikin sellaisen mielettömän kokeen, siitä tulisi arvokkaammaksi eikä kuuluisammaksi, ja jos se murskautuisi, kuten saattaisi tapahtua, eikö se silloin olisi auttamattomasti hukassa? Epäilemättä, ja sen omistaja joutuisi sellaiseen maineeseen, että kaikki pitäisivät häntä houkkiona. Ajattelehan nyt, parahin Anselmo, että Camila on hienonhieno timantti, sekä omasta mielestäsi että toisten arvioinnin mukaan, ja ettei ole järjellistä saattaa sitä murskautumisen vaaraan; jos näet se säilyykin eheänä, ei se kumminkaan voi tulla entistä arvokkaammaksi, ja jos se olisi liian heikko eikä kykenisi koetta

kestämään, niin arvaathan jo ennakolta, miten sinun kävisi, kun sen menettäisit, ja kuinka aiheellisesti voisit syyttää itseäsi, koska olisit vikapää sen ja oman itsesi tuhoutumiseen. Ota huomioon, ettei maailmassa ole siveän ja kunniallisen naisen arvoista kalleutta ja että naisten kunniana on yksinomaan heidän nauttimansa hyvä maine; ja, koska puolisosi maine, kuten itse tiedät, on täysin moitteeton, miksi tahdot saattaa tämän varmuuden epäilyksenalaiseksi? Muista, ystäväni, että nainen on epätäydellinen olento ja ettei hänen tielleen pidä asettaa loukkauskiviä, joihin hän kompastuu ja kaatuu, vaan on niitä raivattava pois ja puhdistettava hänen polkunsa kaikista esteistä, jotta hän voi vaivattomasti ja kevyin askelin rientää saavuttamaan kaipaamaansa täydellisyyttä, joka on siinä, että hän säilyy siveänä. Luonnontutkijat kertovat, että kärppä on pieni eläin, jolla on lumivalkea turkki, ja että metsästäjät sitä pyydystäessään käyttävät seuraavaa temppua: tuntien eläimen kulku- ja oleskelupaikat he sulkevat ne kasaamalla niihin lokaa ja säikyttävät sen sitten kulkemaan sinnepäin, ja kärppä, saavuttuaan lokaiseen paikkaan, pysähtyy ja antautuu saaliiksi, koska ei tahdo astua liejuun ja tahria ja tärvellä valkoista turkkiansa, jota pitää vapauttaan ja henkeään kalliimpana. Kunniallinen ja siveä vaimo on kärpän kaltainen, ja kunniallisuuden hyve on valkeampi ja puhtaampi kuin vitilumi; ja sen, joka ei tahdo nähdä naisen sitä menettävän, vaan haluaa sen säilyvän ja säästyvän, tulee menetellä toisin kuin kärppää pyydystettäessä, sillä hänen eteensä ei pidä asettaa tungettelevien rakastajien imartelun lokaa, koska hänessä kentiesi, ja varmaankaan, ei ole sellaista synnynnäistä kuntoa ja voimaa, että hän kykenisi omin neuvoin raivaamaan tieltään ja voittamaan mainitut esteet; niinmuodoin onkin välttämätöntä poistaa ne ja asettaa hänen näkyviinsä hyveen puhtaus ja hyvään maineeseen sisältyvä kauneus. Hyvä vaimo on myös kuin kirkas ja hohteleva kristallikuvastin; sen

saattaa huurtaa ja himmentää mikä hyvänsä siihen sattuva henkäys.

Kunniallista naista tulee kohdella niinkuin pyhäinjäännöksiä: palvoa, mutta ei koskettaa. Hyvää vaimoa tulee vaalia ja arvostaa niinkuin vaalitaan ja arvostetaan kaunista puutarhaa, joka on täynnä kukkia ja ruusuja ja jonka omistaja ei salli kenenkään siellä käyskelevän tai kukkiin kajoavan: he saavat tyytyä loitolta ja rautaristikon takaa nauttimaan niiden tuoksusta ja kauneudesta. Tahdon vielä lopuksi lausua sinulle muutamia mieleeni muistuneita säkeitä, jotka kuulin erästä uutta huvinäytelmää esitettäessä ja jotka mielestäni sopivat tässä käsittelemäämme asiaan. Eräs viisas vanhus neuvoo toista, jolla on tytär, pitämään tyttöä tarkan valvonnan alaisena, vartioimaan ja sulkemaan suojiinsa, ja esittää muiden syiden ohella tämänkin:

Lasia on nainen, mutta paha sulta järjen vei, jos et usko kokeilutta, särkyykö se vaiko ei.

Helposti sen rikki saa, siks' en järkees saata luottaa, jos noin aiot paloittaa, mit' et ehjäks taida juottaa.

Syystä kyllä sitä mieltä ovat kaikki, että jos Danacit'[17] on, silloinkos kultaa sataa taivaantieltä.

Kaikki, mitä olen toistaiseksi sanonut sinulle, Anselmo, on koskenut yksinomaan sinua, ja nyt on hyvä kuulla jotakin myös siitä, mikä liikuttaa minua; jos olen laajasanainen, suo anteeksi, sillä kaikki on tarpeen sen surmansokkelon vuoksi, johon olet eksynyt ja josta pyrit minun avullani pelastumaan. Sinä pidät minua ystävänäsi ja tahdot riistää minulta kunnian, mikä sotii kaikkea ystävyyttä vastaan, ja mielitpä vielä saada aikaan senkin, että minä riistän sinun

kunniasi. On selvää, että tahdot riistää minulta kunnian, sillä Camilan, kun hän huomaa, että häntä liehittelen, kuten vaadit, täytyy varmaan pitää minua kunniattomana ja halpamaisena miehenä, koska minä suunnittelen ja teen sellaista, mikä on niin kaukana kaikesta, niihin minua velvoittaa oma olemukseni ja sinun ystävyytesi. Aivan varmaa on, että tahdot riistää kunnian itseltäsi, sillä havaitessaan minun liehittelevän itseään Camila johtuu välttämättä ajattelemaan, että minä olen huomannut hänessä jonkinlaista kevytmielisyyttä ja sen rohkaisemana ilmaissut pahan himoni, ja koska hän niinmuodoin pitää itseään solvattuna, tulee solvaus koskemaan sinuakin, jonka oma hän on. Ja tästä johtuu yleinen käytäntö: että uskottoman vaimon miestä, vaikka hän ei tietäisikään eikä olisi antanut aihetta siihen, ettei hänen vaimonsa ole sellainen kuin hänen tulisi olla, ja vaikka vaimoa kohdanneen onnettomuuden ehkäiseminen ei olisi ollut hänen vallassaan eikä syyksi voitaisi katsoa hänen huolimattomuuttaan tai puutteellista varovaisuuttaan, kaikesta tuosta huolimatta mainitaan herjaavalla ja alhaisella nimellä ja että ne, jotka tietävät hänen vaimonsa kehnouden, katselevat häntä halveksuvin eikä säälivin silmin, kuten heidän pitäisi, koska näkevät, ettei hän ole joutunut tähän onnettomuuteen omasta syystään, vaan kehnon aviopuolisonsa himon vuoksi. Mutta mielinpä ilmaista sinulle, miksi huonon vaimon mies syystäkin saa häpeän kantaakseen, vaikka ei tiedäkään vaimon kehnoutta, ei ole siihen syypää eikä ole suonut hänelle aihetta eikä tilaisuutta. Älä väsy kuuntelemaan minua, sillä tuleehan tämän kaiken koitua sinun eduksesi. Pyhä Raamattu kertoo, että Jumala, luotuaan naisessa paratiisissa ensimmäisen isämme Aatamin, vaivutti hänet uneen ja hänen nukkuessaan otti hänen vasemmasta kyljestään luun, josta teki äitimme Eevan. Herättyään ja hänet nähtyään Aatami sanoi: »Tämä on liha minun lihastani ja luu minun

luustani». Ja Jumala sanoi: »Sentähden on miehen luopuminen isästänsä ja äidistänsä ja liittyminen vaimoonsa, ja he tulevat yhdeksi lihaksi.» Silloin perustettiin avioliiton pyhä sakramentti sellaisin sitein, että yksin kuolema voi ne purkaa. Ja tässä ihmeellisessä sakramentissa on sellainen voima ja vaikutus, että se tekee kaksi eri henkilöä yhdeksi lihaksi, ja moitteettomissa aviopuolisoissa sen vaikutus on vielä syvällisempi: vaikka näet heissä on kaksi sielua, on heillä kumminkin vain yksi ainoa tahto. Ja koska vaimon ja miehen liha on yhtä, johtuu siitä, että ne tahrat, joita vaimoon ilmaantuu, tai ne hairahdukset, joihin hän tekee itsensä vikapääksi, koituvat miehen lihan vahingoksi, vaikka hän, kuten sanottu, ei olisikaan antanut aihetta siihen onnettomuuteen. Jalan tai minkä tahansa ihmisruumiin muun jäsenen kipu tuntuu koko ruumiissa, koska se on kokonaisuudessaan samaa lihaa, joten pää tuntee kehräsluun kokeman vaurion, vaikka ei ole siihen syynä, ja samalla tavalla mies osallistuu vaimon häpeään, koska he molemmat ovat yhtä. Ja koska kaikki kunnia ja kunniattomuus tässä maailmassa riippuu ja syntyy lihasta ja verestä ja kehnon vaimon kunniattomuus on tätä lajia, täytyy miehen välttämättä saada siitä osansa ja joutua kunniattoman maineeseen, vaikka hän ei siitä mitään tietäisikään.

Harkitse siis, Anselmo, millaiseen vaaraan syöksyt tahtoessasi häiritä rauhaa, jossa hyvä puolisosi elää, ajattele, millaisen joutavan ja mielettömän uteliaisuuden vuoksi mielit kiihoittaa viettejä, jotka nyt uinuvat siveän puolisosi povessa; ota huomioon, että se, mitä saatat toivoa voittavasi, on vähäpätöistä, mutta se, mitä varmaan menetät, niin ylen tärkeätä, että jätän sen lähemmin selvittelemättä, koska minulta puuttuu sanoja sen riittävään tehostamiseen. Ellei kaikki, mitä olen sanonut, kumminkaan riitä estämään sinua ryhtymästä pahaan aikomukseesi, saat etsiä toisen välineen häpeääsi ja onnettomuuttasi varten, sillä minä en aio siihen suostua, vaikka

senvuoksi menettäisin ystävyytesi, mikä olisi suurin kaikista onnettomuuksista, joita kuvitella voin.

Tuon sanottuaan hyvä ja viisas Lotario vaikeni, ja Anselmo oli niin hämillään ja mietteissään, ettei kyennyt pitkään aikaan virkkamaan sanaakaan. Vihdoin hän kumminkin sanoi:

— Näithän, parahin Lotario, kuinka tarkkaavasti sinua kuuntelin, ja minä huomasin sinun sanoistasi, esimerkeistäsi ja vertauksistasi, kuinka älykäs olet ja kuinka erinomainen ja aito on sinun ystävyytesi. Käsitän ja tunnustan myös, että kieltäytyessäni noudattamasta sinun neuvoasi ja seuratessani omaa ajatustani pakenen hyvää ja tavoittelen pahaa. Sen myönnän, mutta sinun tulee ottaa huomioon, että minä olen nyt potemassa samaa sairautta kuin toisinaan naiset, joiden tekee mieli syödä multaa, kipsiä, hiiltä ja muita vielä pahempia aineita, jotka ovat tympäiseviä nähdä ja sitäkin mahdottomampia syödä. On siis välttämätöntä käyttää parantamisekseni jotakin temppua, ja niin voidaan helposti tehdä, kunhan sinä alat, vaikkapa vain laimeasti ja näennäisesti, mielistellä Camilaa, joka ei suinkaan liene niin hauras, että hänen siveytensä luhistuu ensimmäisistä iskuista. Minä tyydyn sellaiseen aloitteeseen, ja sinä tulet siten täyttäneeksi, mitä olet ystävyydellemme velkaa, koska et ainoastaan lahjoita minulle elämää, vaan annat vielä vakuuden, että kunniani säilyy. Ja sinä olet velvollinen sen tekemään yhdestä ainoasta syystä, nimittäin siksi, ettet nyt, kun olen tosiaan päättänyt suorittaa tämän kokeen, saa sallia minun ilmaisevan mieletöntä aiettani kenellekään muulle, koska siten menetellen panisin vaaralle alttiiksi kunniani, jota sinä yrität varjella; ja vaikka sinun kunniallisuutesi ei olekaan Camilan mielestä niin taattu kuin sen olla pitäisi, sinun häntä liehiessäsi, ei siitä koidu paljon, eipä mitäänkään haittaa, koska voit aivan pian, havaittuasi hänet niin

lujaksi kuin edellytämme, sanoa hänelle selvän totuuden juonestamme, joten pääset entiseen arvoosi. Ja koska vaarannat niin vähän, mutta voit samalla tuottaa minulle niin suuren tyydytyksen, pyydän sinua siihen suostumaan, vaikka näkisit siinä enemmänkin vaikeuksia, sillä minä, kuten jo sanoin, katson asian päätökseen saatetuksi, kunhan vain sen aloitat.

Lotario, joka havaitsi Anselmon pysyvän järkkymättä päätöksessään eikä osannut mainita enempiä esimerkkejä tai esittää lisää syitä saadakseen hänet aikeesta luopumaan ja nyt vielä kuuli hänen uhkaavan ilmaista pahan suunnitelmansa jollekin toiselle, päätti suurempaa onnettomuutta torjuakseen myöntyä ja tehdä, mitä hän pyysi, mutta vakavasti aikoen menetellä niin, että Anselmo tulisi tyydytetyksi Camilan mielenrauhan joutumatta järkytetyksi. Hän siis kehoitti Anselmoa olemaan mainitsematta aikeestaan kenellekään toiselle, lupasi ottaa tehtävän suorittaakseen ja aloittaa sen, milloin Anselmo hyväksi näkisi. Anselmo syleili häntä hellästi ja rakkaasti lausuen hänelle kiitokset hänen suostumuksestaan, ikäänkuin toinen olisi tehnyt hänelle jonkin erinomaisen palveluksen, ja he sopivat keskenään, että juoneen käytäisiin jo seuraavana päivänä. Anselmo lupasi hankkia Lotariolle aikaa ja tilaisuutta Camilan puhuttelemiseen kahden kesken sekä toimittaa hänelle rahoja ja koruja Camilalle annettaviksi ja tarjottaviksi. Hän neuvoi vielä Lotarioa pitämään hänelle serenadeja sekä sepittämään säkeitä hänen ylistyksekseen luvaten kirjoittaa ne itse, ellei Lotario mielinyt sitä vaivaa nähdä. Lotario selitti suostuvansa kaikkeen, vaikka hänen tarkoituksensa oli toisenlainen kuin Anselmo saattoi arvata, ja tämän sopimuksen solmittuaan he palasivat Anselmon kotiin, missä havaitsivat miestään odottaneen Camilan olevan levottomana ja huolestuneena, koska Anselmo oli sillä kertaa viipynyt poissa tavallista kauemmin.

Lotarion lähdettyä omaan asuntoonsa Anselmo jäi kotiin varsin tyytyväisenä; Lotario sitävastoin painui sangen syviin mietteisiin, koska ei tietänyt, mitä keinoa pitäisi onnellisesti suoriutuakseen tuosta arveluttavasta toimesta. Mutta samana yönä hän jo keksi keinon, miten pettäisi Anselmon loukkaamatta Camilaa, ja meni seuraavana päivänä päivälliselle ystävänsä luo. Camila tervehti häntä ystävällisesti ja kohteli kaikin puolin erittäin suopeasti, koska tiesi, kuinka miehensä oli häneen kiintynyt. Kun ateria oli päättynyt ja pöytäkalusto korjattu pois, Anselmo pyysi Lotarioa jäämään Camilan luo, hänen lähtiessään toimittamaan erästä välttämätöntä asiaa luvaten palata puolentoista tunnin kuluessa. Camila pyysi Anselmoa jäämään, ja Lotario tarjoutui lähtemään hänen kanssaan, mutta Anselmo ei suostunut mihinkään, pyysi vain pyytämällä, että Lotario jäisi häntä odottamaan, koska halusi myöhemmin keskustella hänen kanssaan eräästä erittäin tärkeästä seikasta. Hän kehoitti vielä Camilaa olemaan Lotarion seurassa, kunnes hän tulisi takaisin. Hän osasikin kuvailla, kuinka välttämätön hänen joutava poistumisensa oli, niin kekseliäästi, ettei kukaan olisi voinut havaita sitä teeskentelyksi. Anselmo lähti, ja Camila ja Lotario jäivät pöydän ääreen kahden kesken; kaikki talon palvelijat näet olivat menneet aterialle. Lotario näki nyt olevansa sillä taistelutanterella, jota hänen ystävänsä toivoi, edessään vihollinen, joka olisi voinut pelkällä kauneudellaan voittaa eskadroonan asestettuja ritareita, joten Lotariolla epäilemättä oli täysi syy häntä pelätä. Hän ei kumminkaan ryhtynyt mihinkään toimenpiteisiin, nojasihan vain kyynärpäänsä pöytään ja poskensa kämmenpohjaansa sekä pyysi Camilalta anteeksi epäkohteliaisuuttaan sanoen mielivänsä hiukan levätä, kunnes Anselmo ehtisi takaisin. Camila vastasi, että hän voisi levätä salin tyynyillä paremmin kuin tuolissa ja kehoitti siis häntä menemään sinne nukkumaan. Lotario ei kumminkaan huolinut

lähteä, vaan istui paikallaan unenhorroksissa, kunnes Anselmo palasi. Anselmo, joka oli viipynyt sangen kauan, näki Camilan olevan huoneessaan ja Lotarion uneen vaipuneena, otaksui heillä niinmuodoin olleen aikaa sekä keskustelemiseen että nukkumiseenkin eikä olisi mielellään malttanut odottaa Lotarion heräämistä, koska tahtoi päästä lähtemään hänen kanssaan ulos tiedustellakseen häneltä, kuinka yritys oli luonnistunut. Kaikki kävi hänen toivomustensa mukaan: Lotario heräsi, he lähtivät kohta talosta, Anselmo kysyi, mitä tietää halusi, ja Lotario vastasi, ettei ollut katsonut hyväksi ilmaista itseään täydellisesti ja että hän senvuoksi oli vain ylistänyt Camilaa kauniiksi, sanoen hänelle, ettei koko kaupungissa puhuttu muusta kuin hänen kauneudestaan ja älystään. Hän sanoi pitäneensä tuota hyvänä alkuna Camilan suosion voittamiseen ja hänen taivuttamiseen kuuntelemaan toiste mielellään; ja tässä menettelyssään Lotario oli käyttänyt samaa juonta kuin paholainen käyttää tahtoessaan pauloa jonkun, joka on varuillaan voidakseen puolustautua: hän, pimeyden enkeli, muuttuu silloin valkeuden enkeliksi ja asettaa hänen nähtäväkseen kauniin silmänlumeen lopulta ilmaisten itsensä ja saavuttaen tarkoituksensa, ellei hänen petoksensa tule ilmi heti alussa. Anselmo oli erittäin tyytyväinen tuohon kaikkeen ja sanoi järjestävänsä Lotariolle joka päivä samanlaisen tilaisuuden, vaikka ei kotoa poistuisikaan; hän näet sanoi askartelevansa kotona sellaisissa toimissa, ettei Camila voisi huomata hänen juontansa.

Kului sitten useita päiviä, joina Lotario ei virkkanut sanaakaan Camilalle, mutta siitä huolimatta Anselmon kysyessä sanoi keskustelleensa hänen kanssaan kumminkaan saamatta häneltä pienintäkään merkkiä siitä, että hän suostuisi mihinkään pahaan tai antaisi toivon varjoakaan; Lotario sanoi hänen päinvastoin uhanneen

Turn static files into dynamic content formats.

Create a flipbook
Issuu converts static files into: digital portfolios, online yearbooks, online catalogs, digital photo albums and more. Sign up and create your flipbook.
Full download Multimedia on symbian os inside the convergence device symbian press 1st edition adi r by larrygeraldo4125 - Issuu