gphoto2-abilities-list.h File Reference

List of supported camera models including their abilities. More...

#include <gphoto2-context.h>
#include <gphoto2-list.h>
#include <gphoto2-port-info-list.h>

Go to the source code of this file.

Data Structures
struct	CameraAbilities
	Describes the properties of a specific camera. More...
Typedefs
typedef _CameraAbilitiesList	CameraAbilitiesList
	List of supported camera models including their abilities.
Enumerations
enum	CameraDriverStatus { GP_DRIVER_STATUS_PRODUCTION, GP_DRIVER_STATUS_TESTING, GP_DRIVER_STATUS_EXPERIMENTAL, GP_DRIVER_STATUS_DEPRECATED }
enum	CameraOperation {   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 }
enum	CameraFileOperation {   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 }
enum	CameraFolderOperation {   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 }
Functions
int	gp_abilities_list_new (CameraAbilitiesList **list)
int	gp_abilities_list_free (CameraAbilitiesList *list)
	Free the given CameraAbilitiesList object.
int	gp_abilities_list_load (CameraAbilitiesList *list, GPContext *context)
	Scans the system for camera drivers.
int	gp_abilities_list_reset (CameraAbilitiesList *list)
	Reset the list.
int	gp_abilities_list_detect (CameraAbilitiesList *list, GPPortInfoList *info_list, CameraList *l, GPContext *context)
int	gp_abilities_list_append (CameraAbilitiesList *list, CameraAbilities abilities)
	Append the abilities to the list.
int	gp_abilities_list_count (CameraAbilitiesList *list)
	Count the entries in the supplied list.
int	gp_abilities_list_lookup_model (CameraAbilitiesList *list, const char *model)
	Search the list for an entry of given model name.
int	gp_abilities_list_get_abilities (CameraAbilitiesList *list, int index, CameraAbilities *abilities)
	Retrieve the camera abilities of entry with supplied index number.
const char *	gp_message_codeset (const char *)

---

Detailed Description

List of supported camera models including their abilities.

Author:

Copyright © 2000 Scott Fritzinger

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.

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.

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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

---

Typedef Documentation

typedef struct _CameraAbilitiesList CameraAbilitiesList

List of supported camera models including their abilities.

The internals of this list are hidden - use the access functions.

---

Function Documentation

int gp_abilities_list_append	(	CameraAbilitiesList *	list,
		CameraAbilities	abilities
	)

Append the abilities to the list.

Parameters:

	list	CameraAbilitiesList
	abilities	CameraAbilities

Returns:

a gphoto2 error code

This function is called by a camera library on camera_abilities() in order to inform libgphoto2 about a supported camera model.

int gp_abilities_list_count

(

CameraAbilitiesList *

list

)

Count the entries in the supplied list.

Parameters:

a

CameraAbilitiesList

Returns:

The number of entries or a gphoto2 error code

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

Parameters:

	list	a CameraAbilitiesList
	info_list	a GPPortInfoList
	l	a CameraList

Returns:

a gphoto2 error code

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

int gp_abilities_list_free

(

CameraAbilitiesList *

list

)

Free the given CameraAbilitiesList object.

Parameters:

list

a CameraAbilitiesList

Returns:

a gphoto2 error code

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

Retrieve the camera abilities of entry with supplied index number.

Parameters:

	list	a CameraAbilitiesList
	index	index
	abilities	CameraAbilities

Returns:

a gphoto2 error code

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

int gp_abilities_list_load	(	CameraAbilitiesList *	list,
		GPContext *	context
	)

Scans the system for camera drivers.

Parameters:

	list	a CameraAbilitiesList
	context	a GPContext

Returns:

a gphoto2 error code

All supported camera models will then be added to the list.

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

Search the list for an entry of given model name.

Parameters:

	list	a CameraAbilitiesList
	model	a camera model name

Returns:

Index of entry or gphoto2 error code

int gp_abilities_list_new

(

CameraAbilitiesList **

list

)

Allocate the memory for a new abilities list.

Parameters:

list

CameraAbilitiesList object to initialize

Returns:

gphoto2 error code

You would then call gp_abilities_list_load() in order to populate it.

int gp_abilities_list_reset

(

CameraAbilitiesList *

list

)

Reset the list.

Parameters:

list

a CameraAbilitiesList

Returns:

a gphoto2 error code

const char* gp_message_codeset

(

const char *

codeset

)

Set the codeset for all messages returned by libgphoto2.

Parameters:

codeset

New codeset for the messages. For instance "utf-8".

Returns:

old codeset as returned from bind_textdomain_codeset().

You would then call gp_abilities_list_load() in order to populate it.

---