Camera API Technical Report:
Camera Attribute Values - SetVal, GetVal and CheckVal

Camera Attribute Values - SetVal, GetVal and CheckVal

There are three ways to set and get camera attributes, the most general is to use SetVal(), GetVal() and CheckVal(). Procedures for setting subsets of the attributes and the windows are given later.

#include <sys/types.h>
#include <camera.h>

int CameraSetVal( cam, val_type, val )
Camera                  cam;
CameraValueType		val_type;
caddr_t			val;

int CameraGetVal( cam, val_type, val )
Camera                  cam;
CameraValueType		val_type;
caddr_t			val;

int CameraCheckVal( cam, val_type, val )
Camera                  cam;
CameraValueType		val_type;
caddr_t			val;

CameraSetVal( cam, val_type, val ) will set an attribute value of type val_type and value val. See below for defined value types. Zero is returned on success, 1 otherwise.

CameraGetVal( cam, val_type, val ) will get the current value, note that val must now be a pointer to the required value. Returns zero on success.

CameraCheckVal( cam, val_type, val ) will either confirm that the given value is valid or return the nearest legal value. This is particularly important for window constraints with respect to binning and sampling. Returns zero if the given value was valid, non-zero if the given value has been changed.