# GPhoto2 API Reference Manual

Lutz
Müller

    	    lutz@users.sf.net

2000
The Free Software Foundation

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to:

              The Free Software Foundation, Inc.,
              59 Temple Place - Suite 330,
              Boston, MA 02111-1307,
              USA

<chapter id="gphoto2" <title>GPhoto2 Overview

GPhoto2 is a library for accessing a wide range of digital cameras. It works on many UNIX-like platforms. GPhoto2 is released under the GNU Library General Public License (GNU LGPL), which allows for flexible licensing of client applications. GPhoto2 is written entirely in C and has an object-oriented architecture that makes it easy for other programming languages to access GPhoto2.

GPhoto2 doesn't depend on any external library. However, it is strongly recommended that you have some library installed that handles locking of serial ports. GPhoto2 currently supports

ttylock.h

  ttyLock, a header file provided by several locking libraries (i.e. LockDev), and

lockdev.h

  LockDev, a library available for several systems including Red-Hat and Debian

## GPhoto2 Utilities

GPhoto2's core provides some utility functions and general datatypes. In contrast to the objects presented later, they cannot be classified as objects, and are therefore presented upfront.

&gphoto2-result; &gphoto2-library;

## GPhoto2 Objects

In order to simplify programming with GPhoto2, an object oriented approach has been used. The different objects are presented in the following sections.

&gphoto2-camera; &gphoto2-filesys; &gphoto2-widget; &gphoto2-list; &gphoto2-abilities-list; &gphoto2-file;

## License

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library 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 Library General Public License for more details.

You may obtain a copy of the GNU Library General Public License from the Free Software Foundation by visiting their Web site or by writing to:

            Free Software Foundation, Inc.
            59 Temple Place - Suite 330
            Boston, MA 02111-1307
            USA