Revision as of 15:30, 15 October 2008 by seppo_fn (Talk | contribs)

Using the camera autofocus feature in Symbian

From Nokia Developer Wiki
Jump to: navigation, search


Article Metadata
Tested with
Devices(s): Devices that support autofocus
Platform(s): S60 3rd Edition
S60 3rd Edition, Feature Pack 1
S60 3rd Edition, Feature Pack 2
S60 5th Edition
S60 5th Edition
S60 3rd Edition FP2
S60 3rd Edition FP1
S60 3rd Edition (initial release)
S60 3rd Edition and S60 3rd Edition, FP1: MCamAutoFocusObserver, CCamAutoFocus
S60 3rd Edition, FP2 and S60 5th Edition: CCameraAdvancedSettings
Created: (08 Oct 2008)
Last edited: seppo_fn (15 Oct 2008)


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.

Using autofocus on S60 3rd Edition, FP2 and newer devices

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: File: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).

Using autofocus on S60 3rd Edition and S60 3rd Edition, FP1 devices

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.

119 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.


Thank you!

We appreciate your feedback.