1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-B57D7C53-DFDB-4590-8227-EA251D1ABBC7" xml:lang="en"><title>Using

    13 autofocus</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>Autofocus support for camera applications is controlled through the <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/reference/reference-cpp/Camera_Framework/CCameraClass.html#%3a%3aCCamera%3a%3aCCameraAdvancedSettings" format="application/java-archive">CCameraAdvancedSettings class</xref>. For more information on using autofocus,

    15 see <xref href="http://wiki.forum.nokia.com/index.php/TSS001129_-_Using_the_camera_autofocus_feature_in_S60_devices" scope="external">Using the camera autofocus feature in S60 devices</xref> on

    16 Forum Nokia.</p>

    17 <fig id="GUID-BD935125-B7F9-4223-BC94-0B4A663DE13C">

    18 <title>Implementation of autofocus</title>

    19 <image href="GUID-57C10E91-F0CD-494E-96CE-92FB1E06CB53_d0e488039_href.png" placement="inline"/>

    20 </fig>

    21 <p>Pressing the camera shutter key on the device halfway down generates additional

    22 key events. The key events can be used to activate autofocus if the camera

    23 hardware supports the functionality. Shutter release (image capture) can be

    24 triggered by pressing the key all the way down. The key presses generate separate

    25 key events. To capture other than autofocus key events from the shutter key,

    26 you need the <codeph>SwEvent</codeph> <xref href="GUID-6971B0A2-F79B-4E05-8AF3-BB1FC1932A22.dita">capability</xref>.</p>

    27 <p>The settings you can use in your application depend on the camera hardware

    28 on the device. The Camera API allows you to query almost all features of the

    29 device camera. For example, to get a list of supported advanced settings,

    30 use the <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/reference/reference-cpp/Camera_Framework/CCameraClass.html#%3a%3aCCamera%3a%3aCCameraAdvancedSettings%3a%3aGetSupportedSettingsL%28RArray%26lt%3b%20TUid%20%26gt%3b%20%26amp%3b%29const" format="application/java-archive"><codeph>CCameraAdvancedSettings::GetSupportedSettingsL()</codeph></xref> method.</p>

    31 <p>For more information on how to easily use the device camera with zoom and

    32 autofocus by using a CameraWrapper made by Forum Nokia, see <xref href="http://www.forum.nokia.com/info/sw.nokia.com/id/9a3e1226-79db-4c8e-bd70-7d9d22aaa6eb/S60_Platform_Camera_Example.html" scope="external">Camera Example</xref> on Forum Nokia. The Camera Wrapper

    33 provides a unified interface for various Symbian camera APIs.

    34 The example application supports the use of both the keypad and touch UI.

    35 The application can be self-signed, but it also provides an option to use

    36 the dedicated camera key (Symbian signing required).</p>

    37 <section id="GUID-0EABEC5B-D4B0-47F1-AEC1-11A929465BC5"><title>See also</title><p><xref href="GUID-6A7F8298-F3E9-513C-8C1F-D057AC62E5E3.dita">Advanced Settings for Focus,

    38 Drive Modes, and Bracket Modes</xref></p><p><xref href="GUID-0FD204B8-4207-577B-AF3A-6E210D63F78E.dita">Advanced

    39 Camera Settings Tutorial</xref></p></section>

    40 </conbody></concept>