Chapter 10: PowerScript Functions

GetAllowedImageAttributes

Description

Returns the set of allowed image attributes for a specific device.

Applies to

Camera objects

Syntax

objectname.GetAllowedImageAttributes ( attrValue } )

Argument	Description
objectname	The name of the camera object that you want to inquire about
attrValue	An array of values of the CameraImageAttributes structure returned by reference that contains the set of attributes available on a specific device

Returns

Integer. Returns 1 for success, and one of the following negative values if an error occurs:

-1 Unspecified error
-2 Supporting DLL not loaded
-3 Other initialization error
-5 Inconsistency in this object instance
-6 Call to the driver or device failed
-7 Unsupported option
-8 Value for option is out of range

Usage

Use this function to determine which attributes, such as image size and zoom factors, can be set on the current device. For a list of values, see the CameraImageAttributes variable on the Enumerated tab page in the Browser.

Examples

Example 1

This example gets the attributes that are available for a device in an array of CameraImageAttributes structures and displays them to the user so that the user can select the set of attributes to be used for preview and capture:

CameraImageAttributes AllowedConfigs[]
g_myCam.GetAllowedImageAttributes(AllowedConfigs)

// Display choices to user and let user select
// a preview and capture configuration
...
// User chose 1 for preview, 3 for capture
g_myCam.SetPreviewImageAttributes(AllowedConfigs[1])
g_myCam.SetCaptureImageAttributes(AllowedConfigs[3])