imgGetCameraAttributeString
Usage
rval imgGetCameraAttributeString (SESSION_ID sid, const char* attributeString, char* currentValue, uInt32 sizeofcurrentValue);
Purpose
Gets the value of camera attributes. Camera attributes vary according to which camera you are using. Refer to Measurement & Automation Explorer (MAX) for information about valid camera attributes for your camera and image acquisition device. Use this function to get the value of string or numeric attribute types.
Parameters
Name | Type | Direction |
sid | SESSION_ID | input |
attributeString | const char* | input |
currentValue | char* | output |
sizeofcurrentValue | uInt32 | input |
rval | Int32 | output |
Parameter Discussion
sid: valid SESSION_ID.
attributeString: attribute name as described in the Camera Attributes tab in MAX.
currentValue: pointer to the array to receive the attribute. Upon success, the function populates the variable with the current value of the attribute.
sizeofcurrentValue: size of the currentValue that has been passed in. If the size of the string is not large enough to hold the attribute, the attribute is truncated.
Return Value
This function returns 0 on success. On failure, this function returns an error code. For more information about the error code, call imgShowError.