| GPhoto2 API Reference Manual |
|---|
enum CameraDriverStatus; enum CameraOperation; enum CameraFileOperation; enum CameraFolderOperation; struct CameraAbilities; struct CameraAbilitiesList; int gp_abilities_list_new (CameraAbilitiesList **list); int gp_abilities_list_free (CameraAbilitiesList *list); int gp_abilities_list_load (CameraAbilitiesList *list, GPContext *context); int gp_abilities_list_detect (CameraAbilitiesList *list, GPPortInfoList *info_list, CameraList *l, GPContext *context); int gp_abilities_list_count (CameraAbilitiesList *list); int gp_abilities_list_lookup_model (CameraAbilitiesList *list, const char *model); int gp_abilities_list_get_abilities (CameraAbilitiesList *list, int index, CameraAbilities *abilities); int gp_abilities_list_append (CameraAbilitiesList *list, CameraAbilities abilities);
typedef enum {
GP_DRIVER_STATUS_PRODUCTION,
GP_DRIVER_STATUS_TESTING,
GP_DRIVER_STATUS_EXPERIMENTAL,
GP_DRIVER_STATUS_DEPRECATED
} CameraDriverStatus;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;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;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;struct CameraAbilities {
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;
};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.
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 |
int gp_abilities_list_free (CameraAbilitiesList *list);
Frees the list.
| list : | |
| Returns : | a gphoto2 error code |
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 : | |
| context : | a GPContext |
| Returns : | a gphoto2 error code |
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 : | |
| info_list : | |
| l : | |
| context : | |
| Returns : | a gphoto2 error code |
int gp_abilities_list_count (CameraAbilitiesList *list);
Counts the entries in the supplied list.
| list : | |
| Returns : | The number of entries or a gphoto2 error code |
int gp_abilities_list_lookup_model (CameraAbilitiesList *list, const char *model);
Searches the list for an entry of given model.
| list : | |
| model : | a camera model |
| Returns : | Index of entry or gphoto2 error code |
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 : | |
| index : | index |
| abilities : | |
| Returns : | a gphoto2 error code |
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 : | |
| abilities : | |
| Returns : | a gphoto2 error code |
| <<< CameraList | CameraFile >>> |