S60 Platform: Camera Example v2.0
-----------------------------------------
   
This C++ application implements basic features of the built-in camera using the On-board Camera 
API classes MCameraObserver and CCamera (supported from S60 2nd Edition onwards). The example 
demonstrates view finding, zooming, shooting a still image, and saving it.

For information on the support for the MCameraObserver2 and MCameraBuffer classes, see the 
known issues section in this release note.


-------------------------------------------------------------------------------

PREREQUISITES

- Symbian OS key concepts

--------------------------------------------------------------------------------

IMPORTANT FILES/CLASSES

CameraCaptureEngine.h	        | The main engine class. Owns an instance of CCamera and implements 
                                | the required observer interface class MCameraObserver. The engine 
                                | class is an active object, since the callback methods inMCameraObserver 
                                | are asynchronous by nature. 
                                | 

CameraCaptureEngine_3rd_Ed.h	| Another sample implementation of the engine class, which uses the 
				| newer MCameraObserver2 interface for observing the camera. See the 
				| known issues section below for more information.

CameraAppController.h           | A controller class for the engine. This class is also responsible for 
				| playing the shutter sound when an image is being snapped.

CameraAppView.h                 | The landscape (standard) view class.

CameraAppContainer.h            | A container class for the landscape view.

CameraAppPortraitView.h         | The portrait view class.

CameraAppPortraitContainer.h    | A container class for the portrait view.


Important Symbian classes: MCameraObserver and CCamera

--------------------------------------------------------------------------------

KNOWN ISSUES

- At the time of developing this example, there is no support for MCameraObserver2 and MCameraBuffer 
  classes in S60 3rd Edition devices. Therefore, despite Symbian's recommendation to use MCameraObserver2, 
  this example uses the older MCameraObserver class to observe the camera. However, for demonstration 
  purposes a non-tested example engine class using MCameraObserver2 and MCameraBuffer is also included 
  in the example (CameraCaptureEngine_3rd_Ed.cpp and CameraCaptureEngine_3rd_Ed.h) should it be possible 
  to use them in future S60 devices (note that it is currently unknown when they will be supported). 
  Follow the instructions in the CameraAppController.cpp file to switch to using this version of the 
  engine class. 

- In the S60 3rd Edition SDK emulator, the viewfinder is not available. Thus the application cannot 
  be fully tested on the S60 3rd Edition SDK emulator.

- In S60 3rd Edition, the device Media Gallery does not automatically update its view when the 
  application is launched by CameraApp. Currently there is no mechanism to force the update, so in 
  some cases all the pictures taken with CameraApp might not be visible in the Media Gallery view.

- The viewfinder frame does not support the skin correctly in S60 3rd Edition (the frame is always 
  white).

--------------------------------------------------------------------------------

RUNNING THE EXAMPLE

Launch the CameraApp application on your device. A screen displaying a view finder in landscape 
(standard) mode will appear and the application is ready for use.

The operations of the application are controlled using the actions found in the Options menu and by 
using the scroller key:

- Selection key or Options->Snap: snap an image and save it to the images folder
- Options->Go to gallery: Open the device's Media Gallery application to view the snapped images
- Right-arrow key: switch to portrait mode
- Left-arrow key: switch to landscape (standard) mode
- Up-arrow key: zoom in
- Down-arrow key: zoom out

After the image is snapped, it will be saved in the default Images folder on the device. The resulting 
file name is hard-coded with "CameraAppxx.jpg", where "xx" is a number automatically generated by the 
sample code.

The user can now either view the image using Media Gallery or snap a new image by selecting 
Options->New image.


--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS

MOBILE DEVICE (S60 3rd Edition)
------------------
    Go to /CameraApp/group
    bldmake bldfiles
    abld build gcce urel
    Go to /CameraApp/sis
    Edit the CameraApp_s60_3rd_ed.pkg's paths to match those on your system.
    makesis CameraApp_s60_3rd_ed.pkg
    
    Sign the SIS package:
	Sign the sis file (find out more about signing the sis file and 
        developer certificate from www.symbiansigned.com):
        signsis CameraApp_s60_3rd_ed.sis CameraApp3rdEd.sis YourCertificate.cer 
           YourKey.key YourPassword

    Install the signed .sis file to an S60 3rd Edition device.
    - If you get a "Certificate error" during the installation of a self-signed 
      package, check that App.Manager -> Settings -> Software Installation is 
      set to "All". 

MOBILE DEVICE (S60 2nd Edition)
------------------
    Go to /CameraApp/group
    bldmake bldfiles
    abld build thumb urel
    Go to /CameraApp/sis
    Edit the CameraApp.pkg's paths to match those on your system.

    makesis CameraApp.pkg

    Install the .sis file to your device.

EMULATOR
------------------
    Go to /CameraApp/group
    bldmake bldfiles
    abld build wins udeb
    - Make sure that the file /CameraApp/data/Camera1a_2_8kHz.wav has been copied to
      /epoc32/winscw/c/private/e01ff1d87Camera1a_2_8kHz.wav (in 3rd Edition SDK) or to
      /epoc32/winscw/system/Apps/cameraapp/Camera1a_2_8kHz.wav (in 2nd Edition SDK).

    Start the emulator.

--------------------------------------------------------------------------------

COMPATIBILITY

S60 3rd Edition
S60 2nd Edition

TESTED WITH Nokia 6670, Nokia 6630, Nokia N90, Nokia E70, Nokia N73, Nokia N80.
Created / tested with Series 60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 2, for C++, 
Supporting Metrowerks CodeWarrior
and S60 3rd Edition SDK for Symbian OS, for C++, Supporting Metrowerks CodeWarrior

--------------------------------------------------------------------------------

VERSION HISTORY

2.0	Support for S60 3rd Edition added. A sample class using the new MCameraObserver2 and 
	MCameraBuffer classes added. 
	Changes to the mechanism used to play a snap sound while snapping an image (the required 
	Camera1a_2_8kHz.wav file is no longer automatically present in newer devices, so now the file 
	is delivered in the installation package).

1.0	First release.

--------------------------------------------------------------------------------
EVALUATE THIS RESOURCE
Please spare a moment to help us improve documentation quality and recognize the examples 
you find most valuable, by rating this resource at
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId=e18d29cb-1d16-4974-88f9-712dfd9de436/S60_Platform_Camera_Example_v2_0_en.zip