12 <concept xml:lang="en" id="GUID-176913BA-3877-58E2-9E12-3606EE697813"><title> Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>This document introduces to the Advanced Camera Settings library in Ecam. The Advanced Camera Settings library is used by application developers to enable camera users to configure camera settings and by device creators to define default and mandatory software and hardware configuration settings. </p> <section><title>Purpose</title> <p>Advanced Camera Settings provides domain specific getters and setters for well known camera hardware settings. Image or video format, sizes and video frame rates are already well defined in the general <xref href="GUID-4E8A5141-5E4A-322A-9892-8DC49D04986E.dita"><apiname>Ccamera</apiname></xref> API. </p> <p><b>Advanced Camera Settings Library Details</b> </p> <p>The DLL that provides the functionality and the library to which your code must link is identified below. </p> <table id="GUID-9C053250-4959-5DB9-9646-6E50A3EDDE87"><tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><thead><row><entry>DLL</entry> <entry>LIB</entry> <entry>Short Description</entry> </row> </thead> <tbody><row><entry><p> <xref href="GUID-EC265726-FA8D-3D91-9ECC-F68E5D444534.dita"><apiname>ecamadvsettings.dll</apiname></xref>  </p> </entry> <entry><p> <xref href="GUID-B4E2E996-CFBE-3156-B02D-D0F2F634B3C7.dita"><apiname>ecam.lib</apiname></xref>  </p> </entry> <entry><p>These files are used for implementing the Advanced Settings. </p> </entry> </row> </tbody> </tgroup> </table> </section> <section><title>Architectural Relationship</title> <p>The Advanced Settings is a part of the camera component. </p> </section> <section><title>Description</title> <p>The advanced settings class, <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita#GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4/GUID-E31AEB11-B7A0-3637-BB31-866306F78118"><apiname>CCamera::CCameraAdvancedSettings</apiname></xref>, provides access to common camera hardware settings related to image acquisition for still images and video. </p> <p>To allow the settings to be both flexible and rich enough to work with different camera hardware, settings are identified by UID values. You can get a list of UIDs of the supported and currently active settings, so that a user interface of the available options can be updated accordingly. The class also allows the range of possible values for a setting to be obtained. </p> </section> <section><title>Key Advanced Settings API Classes</title> <p>The key classes that make up the Advanced Settings are as follows: </p> <ul><li id="GUID-64ACC4F4-4001-573D-B561-A1DBC1A1C3BD"><p> <xref href="GUID-055FE6AE-0489-325A-BC84-C387E946D50D.dita"><apiname>MCameraPresets</apiname></xref>  </p> </li> <li id="GUID-D54D56F3-0666-51FF-8A5C-17A9822FB1B0"><p> <xref href="GUID-8B30B504-513B-387D-9389-4C26DCEE8372.dita"><apiname>MCameraAdvancedSettings</apiname></xref>  </p> </li> <li id="GUID-FB3E0B7F-5815-5D4B-B8E6-C1F6CF87D53F"><p> <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita#GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4/GUID-E31AEB11-B7A0-3637-BB31-866306F78118"><apiname>CCamera::CCameraAdvancedSettings</apiname></xref>  </p> </li> </ul> </section> <section><title>Using Advanced Camera Settings</title> <p>Clients can use the Advanced Settings to: </p> <ul><li id="GUID-81F86379-88CF-522B-81C3-C0D6E34C1023"><p>Build up a configuration set for a camera including: </p> <ul><li id="GUID-61F644CD-BC21-51BF-A976-EE340AF19350"><p>Camera type. <xref href="GUID-E31AEB11-B7A0-3637-BB31-866306F78118.dita#GUID-E31AEB11-B7A0-3637-BB31-866306F78118/GUID-6C99156B-A23F-32C8-AA84-F7005EDEBD3E"><apiname>CCamera::CCameraAdvancedSettings::TCameraType</apiname></xref>  </p> </li> <li id="GUID-24923284-C4D4-5910-A990-7B3725A8DC7F"><p>Stabilization mode. <xref href="GUID-E31AEB11-B7A0-3637-BB31-866306F78118.dita#GUID-E31AEB11-B7A0-3637-BB31-866306F78118/GUID-48DF3436-E92C-341B-ABA2-73B7A32CEDCD"><apiname>CCamera::CCameraAdvancedSettings::TStabilizationMode</apiname></xref>  </p> </li> <li id="GUID-0370445E-0DFF-5BB6-B1FA-BD8991529898"><p>Focus Mode. <xref href="GUID-E31AEB11-B7A0-3637-BB31-866306F78118.dita#GUID-E31AEB11-B7A0-3637-BB31-866306F78118/GUID-877A6E33-8F63-3EFC-8D8C-F77857457B80"><apiname>CCamera::CCameraAdvancedSettings::TFocusMode</apiname></xref>  </p> </li> <li id="GUID-F09295E4-82A7-5D23-B2B6-0E29E6B3EF60"><p>plus several other configuration specifiers such as <xref href="GUID-FAF63EED-08F8-3374-AFF6-4FBD6F17CD3F.dita"><apiname>TDriveMode</apiname></xref>, <xref href="GUID-BF21D32B-91D3-321D-A900-96F6FC61D414.dita"><apiname>TBracketMode</apiname></xref>, <xref href="GUID-69C6A109-EF78-3A36-9E77-2B2007477B6B.dita"><apiname>TPictureOrientation</apiname></xref> and several others. </p> </li> </ul> </li> <li id="GUID-056CAC6B-4A4E-5A95-8988-0FB9E3C298F7"><p>List the UIDs of the supported and currently active settings, so that the user interface can be updated accordingly. </p> </li> <li id="GUID-58963101-6552-5FCD-AD8A-C94705F71279"><p>Support the continuous digital zooming functionality. </p> </li> </ul> </section> <section><title>See also</title> <p><xref href="GUID-36C3A2FD-F4F9-5B8C-91B7-40C29B3D2224.dita">Overview</xref> of Camera Framework </p> <p><xref href="GUID-6A7F8298-F3E9-513C-8C1F-D057AC62E5E3.dita">Advanced Settings for Focus, Drive Modes, and Bracket Modes</xref>  </p> <p><xref href="GUID-82B8C95E-F7E7-59C2-A71A-4C882653D555.dita">Continuous Digital Zooming</xref>  </p> </section> </conbody></concept>

    12 <concept id="GUID-176913BA-3877-58E2-9E12-3606EE697813" xml:lang="en"><title> Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    13 <p>This document introduces to the Advanced Camera Settings library in Ecam.

    14 The Advanced Camera Settings library is used by application developers to

    15 enable camera users to configure camera settings and by device creators to

    16 define default and mandatory software and hardware configuration settings. </p>

    17 <section id="GUID-8042E290-802C-44BB-93F3-538AB726E43C"><title>Purpose</title> <p>Advanced Camera Settings provides domain

    18 specific getters and setters for well known camera hardware settings. Image

    19 or video format, sizes and video frame rates are already well defined in the

    20 general <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita"><apiname>CCamera</apiname></xref> API. </p> <p><b>Advanced

    21 Camera Settings Library Details</b> </p> <p>The DLL that provides the functionality

    22 and the library to which your code must link is identified below. </p> <table id="GUID-9C053250-4959-5DB9-9646-6E50A3EDDE87">

    23 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>

    24 <thead>

    25 <row>

    26 <entry>DLL</entry>

    27 <entry>LIB</entry>

    28 <entry>Short Description</entry>

    29 </row>

    30 </thead>

    31 <tbody>

    32 <row>

    33 <entry>ecamadvsettings.dll </entry>

    34 <entry>ecam.lib </entry>

    35 <entry><p>These files are used for implementing the Advanced Settings. </p> </entry>

    36 </row>

    37 </tbody>

    38 </tgroup>

    39 </table> </section>

    40 <section id="GUID-7AEE09BE-2952-4FA2-8522-A4ED0B2DAC62"><title>Architectural Relationship</title> <p>The Advanced Settings

    41 is a part of the camera component. </p> </section>

    42 <section id="GUID-978DA3BF-7EFF-471A-95F2-1D4C3381A026"><title>Description</title> <p>The advanced settings class, <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita#GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4/GUID-E31AEB11-B7A0-3637-BB31-866306F78118"><apiname>CCamera::CCameraAdvancedSettings</apiname></xref>,

    43 provides access to common camera hardware settings related to image acquisition

    44 for still images and video. </p> <p>To allow the settings to be both flexible

    45 and rich enough to work with different camera hardware, settings are identified

    46 by UID values. You can get a list of UIDs of the supported and currently active

    47 settings, so that a user interface of the available options can be updated

    48 accordingly. The class also allows the range of possible values for a setting

    49 to be obtained. </p> </section>

    50 <section id="GUID-60DCE23C-D5B6-459B-A066-C5338A42184A"><title>Key Advanced Settings API Classes</title> <p>The key classes

    51 that make up the Advanced Settings are as follows: </p> <ul>

    52 <li id="GUID-64ACC4F4-4001-573D-B561-A1DBC1A1C3BD"><p> <xref href="GUID-055FE6AE-0489-325A-BC84-C387E946D50D.dita"><apiname>MCameraPresets</apiname></xref>  </p> </li>

    53 <li id="GUID-D54D56F3-0666-51FF-8A5C-17A9822FB1B0"><p> <xref href="GUID-8B30B504-513B-387D-9389-4C26DCEE8372.dita"><apiname>MCameraAdvancedSettings</apiname></xref>  </p> </li>

    54 <li id="GUID-FB3E0B7F-5815-5D4B-B8E6-C1F6CF87D53F"><p> <xref href="GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4.dita#GUID-021C509B-C821-3401-B2F4-DE7F52BB16D4/GUID-E31AEB11-B7A0-3637-BB31-866306F78118"><apiname>CCamera::CCameraAdvancedSettings</apiname></xref>  </p> </li>

    55 </ul> </section>

    56 <section id="GUID-60479960-CE90-483A-9E7D-B64D545F7CB3"><title>Using Advanced Camera Settings</title> <p>Clients can use

    57 the Advanced Settings to: </p> <ul>

    58 <li id="GUID-81F86379-88CF-522B-81C3-C0D6E34C1023"><p>Build up a configuration

    59 set for a camera including: </p> <ul>

    60 <li id="GUID-61F644CD-BC21-51BF-A976-EE340AF19350"><p>Camera type. <xref href="GUID-E31AEB11-B7A0-3637-BB31-866306F78118.dita#GUID-E31AEB11-B7A0-3637-BB31-866306F78118/GUID-6C99156B-A23F-32C8-AA84-F7005EDEBD3E"><apiname>CCamera::CCameraAdvancedSettings::TCameraType</apiname></xref>  </p> </li>

    61 <li id="GUID-24923284-C4D4-5910-A990-7B3725A8DC7F"><p>Stabilization mode. <xref href="GUID-E31AEB11-B7A0-3637-BB31-866306F78118.dita#GUID-E31AEB11-B7A0-3637-BB31-866306F78118/GUID-48DF3436-E92C-341B-ABA2-73B7A32CEDCD"><apiname>CCamera::CCameraAdvancedSettings::TStabilizationMode</apiname></xref>  </p> </li>

    62 <li id="GUID-0370445E-0DFF-5BB6-B1FA-BD8991529898"><p>Focus Mode. <xref href="GUID-E31AEB11-B7A0-3637-BB31-866306F78118.dita#GUID-E31AEB11-B7A0-3637-BB31-866306F78118/GUID-877A6E33-8F63-3EFC-8D8C-F77857457B80"><apiname>CCamera::CCameraAdvancedSettings::TFocusMode</apiname></xref>  </p> </li>

    63 <li id="GUID-F09295E4-82A7-5D23-B2B6-0E29E6B3EF60"><p>plus several other configuration

    64 specifiers such as <xref href="GUID-FAF63EED-08F8-3374-AFF6-4FBD6F17CD3F.dita"><apiname>TDriveMode</apiname></xref>, <xref href="GUID-BF21D32B-91D3-321D-A900-96F6FC61D414.dita"><apiname>TBracketMode</apiname></xref>, <xref href="GUID-69C6A109-EF78-3A36-9E77-2B2007477B6B.dita"><apiname>TPictureOrientation</apiname></xref> and

    65 several others. </p> </li>

    66 </ul> </li>

    67 <li id="GUID-056CAC6B-4A4E-5A95-8988-0FB9E3C298F7"><p>List the UIDs of the

    68 supported and currently active settings, so that the user interface can be

    69 updated accordingly. </p> </li>

    70 <li id="GUID-58963101-6552-5FCD-AD8A-C94705F71279"><p>Support the continuous

    71 digital zooming functionality. </p> </li>

    72 </ul> </section>

    73 <section id="GUID-565B80CB-0F0A-4E46-B05F-4B3718DCD7E4"><title>See also</title> <p><xref href="GUID-36C3A2FD-F4F9-5B8C-91B7-40C29B3D2224.dita">Overview</xref> of

    74 Camera Framework </p> <p><xref href="GUID-6A7F8298-F3E9-513C-8C1F-D057AC62E5E3.dita">Advanced

    75 Settings for Focus, Drive Modes, and Bracket Modes</xref>  </p> <p><xref href="GUID-82B8C95E-F7E7-59C2-A71A-4C882653D555.dita">Continuous

    76 Digital Zooming</xref>  </p> </section>

    77 </conbody></concept>