<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE task
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-DA1D89FF-52BD-5876-B7A1-300F5EBB9884" xml:lang="en"><title>Converting
Manual Aperture to Automatic Aperture</title><shortdesc>This topic explains how to prepare the camera for the automatic
aperture setting. By default, the automatic aperture setting is used if no
manual aperture value has been given. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<prereq id="GUID-8FE6CE45-D57D-5E9C-A7AE-F11A228AB300"><p>Before you start
you should understand the <xref href="GUID-80EC80E2-E197-50F7-B1FD-720A00AC3B4D.dita">Onboard
Camera Overview</xref> topic. </p> </prereq>
<context id="GUID-AC862FBE-5E7E-438A-B853-1299F55CEE19"><p>The automatic aperture
setting is implementation specific as to whether the default aperture is auto-aperture
or any other value. If the camera cannot determine the aperture value being
used, the <codeph>KErrNotFound</codeph> error is returned. </p> </context>
<steps id="GUID-29060A3C-94A7-5260-924C-C40101B94C8F">
<step id="GUID-4CDAE835-DC3A-50E8-86F6-C314EBBDAFDE"><cmd/>
<info>Pass <xref href="GUID-C238291A-D9C7-3F2A-AABB-23C315D09517.dita"><apiname>KUidECamEvent2CameraSettingAutoAperture</apiname></xref> as a
value to <xref href="GUID-6A60F684-76BF-3001-ABB8-E6A8DB32663B.dita"><apiname>TECAMEvent2</apiname></xref> to notify the camera that the auto
aperture setting is to be used. <xref href="GUID-6A60F684-76BF-3001-ABB8-E6A8DB32663B.dita#GUID-6A60F684-76BF-3001-ABB8-E6A8DB32663B/GUID-63D4B29B-1337-3AF0-82E6-218C9C706993"><apiname>TECAMEvent2::iParam</apiname></xref> represents
the actual numerical value of aperture being used for the auto aperture setting. </info>
</step>
<step id="GUID-D5F27CFB-B712-572B-A245-409FAA22541A"><cmd/>
<info>Use the <xref href="GUID-C238291A-D9C7-3F2A-AABB-23C315D09517.dita"><apiname>KUidECamEvent2CameraSettingAutoAperture</apiname></xref> value
when you do not specify an aperture value in the <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita"><apiname>CCameraAdvancedSettings::SetAperture(TInt)</apiname></xref> function
or when you select exposure to the <codeph>EExposureAuto</codeph> or <codeph>EExposureShutterPriority</codeph> value. </info>
<info>Note: By default <codeph>CCamera</codeph> has an automatic aperture
setting . </info>
</step>
</steps>
</taskbody><related-links>
<link href="GUID-6A7F8298-F3E9-513C-8C1F-D057AC62E5E3.dita"><linktext>Advanced
Settings for Focus, Drive Modes, and Bracket Modes</linktext></link>
</related-links></task>