Symbian3/SDK/Source/GUID-DA1D89FF-52BD-5876-B7A1-300F5EBB9884.dita
changeset 8 ae94777fff8f
parent 0 89d6a7a84779
equal deleted inserted replaced
7:51a74ef9ed63 8:ae94777fff8f
     7     Nokia Corporation - initial contribution.
     7     Nokia Corporation - initial contribution.
     8 Contributors: 
     8 Contributors: 
     9 -->
     9 -->
    10 <!DOCTYPE task
    10 <!DOCTYPE task
    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
    12 <task xml:lang="en" id="GUID-DA1D89FF-52BD-5876-B7A1-300F5EBB9884"><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><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 <codeph>KUidECamEvent2CameraSettingAutoAperture</codeph> as a value to <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita"><apiname>TECAMEvent2</apiname></xref> to notify the camera that the auto aperture setting is to be used. <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita"><apiname>TECAMEvent2::iParam()</apiname></xref> represents the actual numerical value of aperture being used for the the auto aperture setting. </info> </step> <step id="GUID-D5F27CFB-B712-572B-A245-409FAA22541A"><cmd/><info>Use the <codeph>KUidECamEvent2CameraSettingAutoAperture</codeph> 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
    12 <task id="GUID-DA1D89FF-52BD-5876-B7A1-300F5EBB9884" xml:lang="en"><title>Converting
    13                 Bracket Modes</linktext> </link> </related-links></task>
    13 Manual Aperture to Automatic Aperture</title><shortdesc>This topic explains how to prepare the camera for the automatic
       
    14 aperture setting. By default, the automatic aperture setting is used if no
       
    15 manual aperture value has been given. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
       
    16 <prereq id="GUID-8FE6CE45-D57D-5E9C-A7AE-F11A228AB300"><p>Before you start
       
    17 you should understand the <xref href="GUID-80EC80E2-E197-50F7-B1FD-720A00AC3B4D.dita">Onboard
       
    18 Camera Overview</xref> topic. </p> </prereq>
       
    19 <context id="GUID-AC862FBE-5E7E-438A-B853-1299F55CEE19"><p>The automatic aperture
       
    20 setting is implementation specific as to whether the default aperture is auto-aperture
       
    21 or any other value. If the camera cannot determine the aperture value being
       
    22 used, the <codeph>KErrNotFound</codeph> error is returned. </p> </context>
       
    23 <steps id="GUID-29060A3C-94A7-5260-924C-C40101B94C8F">
       
    24 <step id="GUID-4CDAE835-DC3A-50E8-86F6-C314EBBDAFDE"><cmd/>
       
    25 <info>Pass <xref href="GUID-C238291A-D9C7-3F2A-AABB-23C315D09517.dita"><apiname>KUidECamEvent2CameraSettingAutoAperture</apiname></xref> as a
       
    26 value to <xref href="GUID-6A60F684-76BF-3001-ABB8-E6A8DB32663B.dita"><apiname>TECAMEvent2</apiname></xref> to notify the camera that the auto
       
    27 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
       
    28 the actual numerical value of aperture being used for the auto aperture setting. </info>
       
    29 </step>
       
    30 <step id="GUID-D5F27CFB-B712-572B-A245-409FAA22541A"><cmd/>
       
    31 <info>Use the <xref href="GUID-C238291A-D9C7-3F2A-AABB-23C315D09517.dita"><apiname>KUidECamEvent2CameraSettingAutoAperture</apiname></xref> value
       
    32 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
       
    33 or when you select exposure to the <codeph>EExposureAuto</codeph> or <codeph>EExposureShutterPriority</codeph> value. </info>
       
    34 <info>Note: By default <codeph>CCamera</codeph> has an automatic aperture
       
    35 setting . </info>
       
    36 </step>
       
    37 </steps>
       
    38 </taskbody><related-links>
       
    39 <link href="GUID-6A7F8298-F3E9-513C-8C1F-D057AC62E5E3.dita"><linktext>Advanced
       
    40 Settings for Focus, Drive Modes, and Bracket Modes</linktext></link>
       
    41 </related-links></task>