1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
/** \file gphoto2-abilities-list.h
* \brief List of supported camera models including their abilities.
*
* \author Copyright 2000 Scott Fritzinger
*
* \par
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* \par
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* \par
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301 USA
*/
#ifndef LIBGPHOTO2_GPHOTO2_ABILITIES_LIST_H
#define LIBGPHOTO2_GPHOTO2_ABILITIES_LIST_H
#include <gphoto2/gphoto2-context.h>
#include <gphoto2/gphoto2-list.h>
#include <gphoto2/gphoto2-port-info-list.h>
#include <gphoto2/gphoto2-port-log.h>
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/**
* Current implementation status of the camera driver.
*/
typedef enum {
GP_DRIVER_STATUS_PRODUCTION, /**< Driver is production ready. */
GP_DRIVER_STATUS_TESTING, /**< Driver is beta quality. */
GP_DRIVER_STATUS_EXPERIMENTAL, /**< Driver is alpha quality and might even not work. */
GP_DRIVER_STATUS_DEPRECATED /**< Driver is no longer recommended to use and will be removed. */
} CameraDriverStatus;
/**
* Type of the device represented. Currently we have Still Cameras
* and MTP Audio Players.
*/
typedef enum {
GP_DEVICE_STILL_CAMERA = 0, /**< Traditional still camera */
GP_DEVICE_AUDIO_PLAYER = 1 << 0 /**< Audio player */
} GphotoDeviceType;
/**
* A bitmask of remote control related operations of the device.
* Some drivers might support additional dynamic capabilities (like the PTP driver).
*/
typedef enum {
GP_OPERATION_NONE = 0, /**< No remote control operation supported. */
GP_OPERATION_CAPTURE_IMAGE = 1 << 0, /**< Capturing images supported. */
GP_OPERATION_CAPTURE_VIDEO = 1 << 1, /**< Capturing videos supported. */
GP_OPERATION_CAPTURE_AUDIO = 1 << 2, /**< Capturing audio supported. */
GP_OPERATION_CAPTURE_PREVIEW = 1 << 3, /**< Capturing image previews supported. */
GP_OPERATION_CONFIG = 1 << 4, /**< Camera and Driver configuration supported. */
GP_OPERATION_TRIGGER_CAPTURE = 1 << 5 /**< Camera can trigger capture and wait for events. */
} CameraOperation;
/**
* A bitmask of image related operations of the device.
*/
typedef enum {
GP_FILE_OPERATION_NONE = 0, /**< No special file operations, just download. */
GP_FILE_OPERATION_DELETE = 1 << 1, /**< Deletion of files is possible. */
GP_FILE_OPERATION_PREVIEW = 1 << 3, /**< Previewing viewfinder content is possible. */
GP_FILE_OPERATION_RAW = 1 << 4, /**< Raw retrieval is possible (used by non-JPEG cameras) */
GP_FILE_OPERATION_AUDIO = 1 << 5, /**< Audio retrieval is possible. */
GP_FILE_OPERATION_EXIF = 1 << 6 /**< EXIF retrieval is possible. */
} CameraFileOperation;
/**
* A bitmask of filesystem related operations of the device.
*/
typedef enum {
GP_FOLDER_OPERATION_NONE = 0, /**< No special filesystem operation. */
GP_FOLDER_OPERATION_DELETE_ALL = 1 << 0, /**< Deletion of all files on the device. */
GP_FOLDER_OPERATION_PUT_FILE = 1 << 1, /**< Upload of files to the device possible. */
GP_FOLDER_OPERATION_MAKE_DIR = 1 << 2, /**< Making directories on the device possible. */
GP_FOLDER_OPERATION_REMOVE_DIR = 1 << 3 /**< Removing directories from the device possible. */
} CameraFolderOperation;
#ifdef _GPHOTO2_INTERNAL_CODE
/* enum CameraOperation */
extern const StringFlagItem gpi_camera_operation_map[];
/* enum CameraFileOperation */
extern const StringFlagItem gpi_file_operation_map[];
/* enum CameraFolderOperation */
extern const StringFlagItem gpi_folder_operation_map[];
/* enum GphotoDeviceType */
extern const StringFlagItem gpi_gphoto_device_type_map[];
/* enum CameraDriverStatus */
extern const StringFlagItem gpi_camera_driver_status_map[];
#endif /* _GPHOTO2_INTERNAL_CODE */
/**
* \brief Describes the properties of a specific camera.
*
* The internals of this structures are used extensively by the
* camlibs, but the status regarding use by frontends is questionable.
*/
typedef struct {
char model [128]; /**< \brief name of camera model */
CameraDriverStatus status; /**< \brief driver quality */
/** \brief Supported port types. */
GPPortType port;
/** \brief Supported serial port speeds (terminated with a value of 0). */
int speed [64];
/* Supported operations */
CameraOperation operations; /**< \brief Camera operation funcs */
CameraFileOperation file_operations; /**< \brief Camera file op funcs */
CameraFolderOperation folder_operations;/**< \brief Camera folder op funcs */
int usb_vendor; /**< \brief USB Vendor D */
int usb_product; /**< \brief USB Product ID */
int usb_class; /**< \brief USB device class */
int usb_subclass; /**< \brief USB device subclass */
int usb_protocol; /**< \brief USB device protocol */
/* For core use */
char library [1024]; /**< \brief (Internal) library filename */
char id [1024]; /**< \brief (Internal) camera ID name */
GphotoDeviceType device_type; /**< \brief Device type. */
/** Reserved space to use in the future w/out changing the
* struct size */
int reserved2; /**< reserved space \internal */
int reserved3; /**< reserved space \internal */
int reserved4; /**< reserved space \internal */
int reserved5; /**< reserved space \internal */
int reserved6; /**< reserved space \internal */
int reserved7; /**< reserved space \internal */
int reserved8; /**< reserved space \internal */
} CameraAbilities;
/**
* \brief List of supported camera models including their abilities
*
* The internals of this list are hidden - use the access functions.
*/
typedef struct _CameraAbilitiesList 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_load_dir (CameraAbilitiesList *list, const char *dir, GPContext *context);
int gp_abilities_list_reset (CameraAbilitiesList *list);
int gp_abilities_list_detect (CameraAbilitiesList *list,
GPPortInfoList *info_list, CameraList *l,
GPContext *context);
int gp_abilities_list_append (CameraAbilitiesList *list,
CameraAbilities abilities);
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);
const char *gp_message_codeset (const char *);
int gp_init_localedir (const char *localedir);
/**
* Name of the environment variable which may contain the path where
* to look for the camlibs. If this environment variable is not defined,
* use the compiled-in default constant.
*
* \internal Internal use only.
*/
#ifdef _GPHOTO2_INTERNAL_CODE
#define CAMLIBDIR_ENV "CAMLIBS"
#endif /* _GPHOTO2_INTERNAL_CODE */
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* !defined(LIBGPHOTO2_GPHOTO2_ABILITIES_LIST_H) */
|
