Camera API Technical Report:
Composite Attribute Procedures

Composite Attribute Procedures

The iim camera interface allows for the setting of a set of values simultaneously. This is convenient and often more efficient. In the camera library these are provided via set, get and check routines for a CameraSetAttributes structure and for the input or output windows.

#include <camera.h>

int CameraSetAtt( cam, set_att )
Camera                  cam;
CameraSetAttributes     *set_att;

int CameraGetAtt( cam, set_att )
Camera                  cam;
CameraSetAttributes     *set_att;

int CameraCheckAtt( cam, set_att )
Camera                  cam;
CameraSetAttributes     *set_att;

int CameraSetWindow( cam, input_win, output_win )
Camera          cam;
CameraWindow    *input_win;
CameraWindow    *output_win;

int CameraGetWindow( cam, input_win, output_win )
Camera          cam;
CameraWindow    *input_win;
CameraWindow    *output_win;

int CameraCheckWindow( cam, input_win, output_win )
Camera          cam;
CameraWindow    *input_win;
CameraWindow    *output_win;

CameraSetAtt(), CameraGetAtt() and CameraCheckAtt() set, get and check all values in the composite attribute structure set_att. In the case of the iim camera interface these are set simultaneously as a camera state. The functions return zero on success, non-zero otherwise. The check function will return nearest legal values for each attribute and return non-zero if any have been changed.

CameraSetWindow, CameraGetWindow and CameraCheckWindow perform similar functions for just the input and/or output windows. In each procedure the output window argument can be NULL. If it is non-NULL then it has priority in terms of setting the window and the input window is set to the corresponding value. The set function will call CameraCheckWindow first and return a non-zero value if the windows have been changed. In either case the camera windows will be reset.