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

    15 using autofocus, see:</p>

    16 <ul>

    17 <li><p><xref href="GUID-6A7F8298-F3E9-513C-8C1F-D057AC62E5E3.dita">Advanced Settings

    18 for Focus, Drive Modes, and Bracket Modes</xref></p></li>

    19 <li><p><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

    20 Forum Nokia.</p></li>

    21 </ul>

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

    23 <title>Implementation of autofocus</title>

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

    25 </fig>

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

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

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

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

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

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

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

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

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

    35 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>

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

    37 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

    38 provides a unified interface for various Symbian camera APIs. The example

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

    40 can be self-signed, but it also provides an option to use the dedicated camera

    41 key (Symbian signing required).</p>

    42 <section id="GUID-0EABEC5B-D4B0-47F1-AEC1-11A929465BC5"><title>See also</title><p><xref href="GUID-0FD204B8-4207-577B-AF3A-6E210D63F78E.dita">Advanced Camera Settings

    43 Tutorial</xref></p></section>

    44 </conbody></concept>