CameraAbilitiesList

Details

enum CameraDriverStatus

typedef enum {
        GP_DRIVER_STATUS_PRODUCTION,
        GP_DRIVER_STATUS_TESTING,
        GP_DRIVER_STATUS_EXPERIMENTAL
} CameraDriverStatus;

enum CameraOperation

typedef enum {
        GP_OPERATION_NONE               = 0,
        GP_OPERATION_CAPTURE_IMAGE      = 1 << 0,
        GP_OPERATION_CAPTURE_VIDEO      = 1 << 1,
        GP_OPERATION_CAPTURE_AUDIO      = 1 << 2,
        GP_OPERATION_CAPTURE_PREVIEW    = 1 << 3,
        GP_OPERATION_CONFIG             = 1 << 4
} CameraOperation;

enum CameraFileOperation

typedef enum {
        GP_FILE_OPERATION_NONE          = 0,
        GP_FILE_OPERATION_DELETE        = 1 << 1,
        GP_FILE_OPERATION_PREVIEW       = 1 << 3,
        GP_FILE_OPERATION_RAW           = 1 << 4,
        GP_FILE_OPERATION_AUDIO         = 1 << 5,
        GP_FILE_OPERATION_EXIF          = 1 << 6
} CameraFileOperation;

enum CameraFolderOperation

typedef enum {
        GP_FOLDER_OPERATION_NONE        = 0, 
        GP_FOLDER_OPERATION_DELETE_ALL  = 1 << 0,
        GP_FOLDER_OPERATION_PUT_FILE    = 1 << 1,
        GP_FOLDER_OPERATION_MAKE_DIR    = 1 << 2,
        GP_FOLDER_OPERATION_REMOVE_DIR  = 1 << 3
} CameraFolderOperation;

CameraAbilities

typedef struct {
        char model [128];
        CameraDriverStatus status;

        /* Supported ports and speeds (latter terminated with a value of 0) */
        GPPortType port;
        int speed [64];

        /* Supported operations */
        CameraOperation       operations;
        CameraFileOperation   file_operations;
        CameraFolderOperation folder_operations;

        int usb_vendor, usb_product;
        int usb_class, usb_subclass, usb_protocol;

        /* For core use */
        char library [1024];
        char id [1024];

		/* Reserved space to use in the future w/out changing the struct size */
        int reserved1;
        int reserved2;
        int reserved3;
        int reserved4;
        int reserved5;
        int reserved6;
        int reserved7;
        int reserved8;
} CameraAbilities;

struct CameraAbilitiesList

struct CameraAbilitiesList;

A list of supported camera models including their abilities. The internals of this list are hidden - please use functions to access the list.

gp_abilities_list_new ()

int         gp_abilities_list_new           (CameraAbilitiesList **list);

Allocates the memory for a new abilities list. You would then call gp_abilities_list_load in order to populate it.

`list` :
Returns :	a gphoto2 error code

gp_abilities_list_free ()

int         gp_abilities_list_free          (CameraAbilitiesList *list);

Frees the list.

`list` :	a CameraAbilitiesList
Returns :	a gphoto2 error code

gp_abilities_list_load ()

int         gp_abilities_list_load          (CameraAbilitiesList *list,
                                             GPContext *context);

Scans the system for camera drivers. All supported camera models will then be added to the list.

`list` :	a CameraAbilitiesList
`context` :	a GPContext
Returns :	a gphoto2 error code

gp_abilities_list_detect ()

int         gp_abilities_list_detect        (CameraAbilitiesList *list,
                                             GPPortInfoList *info_list,
                                             CameraList *l,
                                             GPContext *context);

Tries to detect any camera connected to the computer using the supplied list of supported cameras and the supplied info_list of ports.

`list` :	a CameraAbilitiesList
`info_list` :	a GPPortInfoList
`l` :	a CameraList
`context` :
Returns :	a gphoto2 error code

gp_abilities_list_count ()

int         gp_abilities_list_count         (CameraAbilitiesList *list);

Counts the entries in the supplied list.

`list` :	a CameraAbilitiesList
Returns :	The number of entries or a gphoto2 error code

gp_abilities_list_lookup_model ()

int         gp_abilities_list_lookup_model  (CameraAbilitiesList *list,
                                             const char *model);

Searches the list for an entry of given model.

`list` :	a CameraAbilitiesList
`model` :	a camera model
Returns :	Index of entry or gphoto2 error code

gp_abilities_list_get_abilities ()

int         gp_abilities_list_get_abilities (CameraAbilitiesList *list,
                                             int index,
                                             CameraAbilities *abilities);

Retrieves the camera abilities of entry with supplied index. Typically, you would call gp_camera_set_abilities afterwards in order to prepare the initialization of a camera.

`list` :	a CameraAbilitiesList
`index` :	index
`abilities` :	CameraAbilities
Returns :	a gphoto2 error code

gp_abilities_list_append ()

int         gp_abilities_list_append        (CameraAbilitiesList *list,
                                             CameraAbilities abilities);

Appends the abilities to the list. This function is called by a camera library on camera_abilities in order to inform gphoto2 about a supported camera model.

`list` :	a CameraAbilitiesList
`abilities` :	CameraAbilities
Returns :	a gphoto2 error code