Overview

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.

Purpose

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 CCamera API.

Advanced Camera Settings Library Details

The DLL that provides the functionality and the library to which your code must link is identified below.

DLL LIB Short Description
ecamadvsettings.dll ecam.lib

These files are used for implementing the Advanced Settings.

Architectural Relationship

The Advanced Settings is a part of the camera component.

Description

The advanced settings class, CCamera::CCameraAdvancedSettings, provides access to common camera hardware settings related to image acquisition for still images and video.

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.

Key Advanced Settings API Classes

The key classes that make up the Advanced Settings are as follows:

  • CCamera::CCameraAdvancedSettings

Using Advanced Camera Settings

Clients can use the Advanced Settings to:

  • Build up a configuration set for a camera including:

    • Camera type. CCamera::CCameraAdvancedSettings::TCameraType

    • Stabilization mode. CCamera::CCameraAdvancedSettings::TStabilizationMode

    • Focus Mode. CCamera::CCameraAdvancedSettings::TFocusMode

    • plus several other configuration specifiers such as TDriveMode, TBracketMode, TPictureOrientation and several others.

  • List the UIDs of the supported and currently active settings, so that the user interface can be updated accordingly.

  • Support the continuous digital zooming functionality.