Categories: Symbian C++ | S60 3rd Edition | S60 3rd Edition, Feature Pack 1 | S60 3rd Edition, Feature Pack 2 | S60 5th Edition | Imaging | Technical Solution
| ID | TSS001129 | Creation date | October 8, 2008 |
| Platform | S60 3rd Edition S60 3rd Edition, Feature Pack 1 S60 3rd Edition, Feature Pack 2 S60 5th Edition | Devices | Devices that support autofocus |
| Category | Symbian C++ | Subcategory | Camera, Imaging |
| Keywords (APIs, classes, methods, functions): S60 3rd Edition and S60 3rd Edition, FP1: MCamAutoFocusObserver, CCamAutoFocus S60 3rd Edition, FP2 and S60 5th Edition: CCameraAdvancedSettings |
Some S60 3rd Edition and newer devices support the camera autofocus feature. There are also methods available to use the autofocus in third-party applications. Autofocus is officially supported in the S60 SDK since S60 5th Edition but interfaces are also available for S60 3rd Edition SDKs separately. Note that because the autofocus implementation has changed in S60 3rd Edition, FP2, there is a binary compatibility break between S60 3rd Edition, FP1 and S60 3rd Edition, FP2.
Autofocus can be controlled via the <CCamera::CCameraAdvancedSettings class, which is part of the Symbian Onboard Camera (CCamera) API. In the S60 5th Edition SDK for Symbian OS v0.9 it is defined in ecamadvsettings.h. This class is not part of the S60 3rd Edition, FP2 SDK for Symbian OS v1.1 but you can get it from the SDK API plug-in for the S60 3rd Edition SDK for Symbian OS, for C++, supporting Feature Pack 2 (in version 1.2). Note that the header file name (ecamadvancedsettings.h) and its dependencies somewhat differ from the corresponding file in S60 5th Edition.
Note also that camera hardware used in S60 devices does not support all the functionality defined in CCameraAdvancedSettings. The API provides functions for querying supported settings for each advanced camera feature.
For further information on the usage, see the article Symbian Onboard Camera Advanced Settings API.
Example application: Image:S60 Camera Example AutoFocus 3rd Ed FP2.zip
At least the following S60 3rd Edition, FP2 and newer devices support autofocus: Nokia 5800 XpressMusic, Nokia 6210 Navigator, Nokia 6220 Classic, Nokia N78.
Note: The key event codes and other features of the camera implementations may vary between devices. While supporting most S60 3rd Edition, FP2 devices, the current version of the example application does not yet support Nokia N79 and N96.
Note: When building the example application on the S60 5th Edition SDK, remember to modify the #include's to match the different header file name (ecamadvsettings.h instead of ecamadvancedsettings.h).
Autofocus is not part of the S60 SDK, but it is provided as a plug-in library, included in the S60 Platform: Camera Example with Autofocus Support available on the Forum Nokia Web site.
Further information on the usage: CS000954 - Implementing autofocus functionality (S60 3rd Edition, pre-FP2)
KIS000610 - AutoFocus API may return incorrect focus range
Example application: S60 Platform: Camera Example with Autofocus Support
The following S60 3rd Edition and S60 3rd Edition, FP1 devices support autofocus: Nokia E66, Nokia E71, Nokia E90 Communicator, Nokia N73, Nokia N82, Nokia N93, Nokia N93i, Nokia N95, Nokia N95-3 NAM, and Nokia N95 8GB.
| Thread | Thread Starter | Forum | Replies | Last Post |
|---|---|---|---|---|
| nokia (run camera in background) application development | vijay2008 | General Discussion | 3 | 2008-02-01 14:24 |
| Camera access restrictions | akamenov | Mobile Web Server | 9 | 2007-05-30 08:41 |
| Using camera from the emulator | atleta | Symbian Tools & SDKs | 2 | 2008-10-01 02:00 |
| Camera / camcorder app Uids | mike_brock | General Symbian C++ | 1 | 2006-09-12 16:27 |
| Nokia 6630 Camera API | ryanrst | Symbian Tools & SDKs | 2 | 2005-03-22 22:21 |