diff options
Diffstat (limited to 'doc/api/gphoto2-api.sgml')
-rw-r--r-- | doc/api/gphoto2-api.sgml | 165 |
1 files changed, 165 insertions, 0 deletions
diff --git a/doc/api/gphoto2-api.sgml b/doc/api/gphoto2-api.sgml new file mode 100644 index 000000000..15ac32e0f --- /dev/null +++ b/doc/api/gphoto2-api.sgml @@ -0,0 +1,165 @@ +<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [ +<!entity hash "#"> +<!entity gphoto2-filesys SYSTEM "sgml/gphoto2-filesys.sgml"> +<!entity gphoto2-file SYSTEM "sgml/gphoto2-file.sgml"> +<!entity gphoto2-widget SYSTEM "sgml/gphoto2-widget.sgml"> +<!entity gphoto2-camera SYSTEM "sgml/gphoto2-camera.sgml"> +<!entity gphoto2-result SYSTEM "sgml/gphoto2-result.sgml"> +<!entity gphoto2-library SYSTEM "sgml/gphoto2-library.sgml"> +<!entity gphoto2-list SYSTEM "sgml/gphoto2-list.sgml"> +<!entity gphoto2-abilities-list SYSTEM "sgml/gphoto2-abilities-list.sgml"> +]> + +<book id="index"> + <bookinfo> + <title>GPhoto2 API Reference Manual</title> + <authorgroup> + <author> + <firstname>Lutz</firstname> + <surname>Müller</surname> + <affiliation> + <address> + <email>lutz@users.sf.net</email> + </address> + </affiliation> + </author> + </authorgroup> + + <copyright> + <year>2000</year> + <holder>The Free Software Foundation</holder> + </copyright> + + <legalnotice> + <para> + Permission is granted to copy, distribute and/or modify this + document under the terms of the <citetitle>GNU Free + Documentation License</citetitle>, 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 <citetitle>GNU Free + Documentation License</citetitle> from the Free Software + Foundation by visiting <ulink type="http" + url="http://www.fsf.org">their Web site</ulink> or by writing + to: + + <address> + The Free Software Foundation, Inc., + <street>59 Temple Place</street> - Suite 330, + <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>, + <country>USA</country> + </address> + </para> + </legalnotice> + </bookinfo> + + <chapter id="gphoto2" + <title>GPhoto2 Overview</title> + <para> +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. + </para> + <para> +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 +<variablelist> + <varlistentry> + <term>baudboy.h</term> + <listitem> + <para>BaudBoy, a library used on Red-Hat systems,</para> + </listitem> + </varlistentry> + <varlistentry> + <term>ttylock.h</term> + <listitem> + <para> + ttyLock, a header file provided by several locking libraries + (i.e. BaudBoy and LockDev), and + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>lockdev.h</term> + <listitem> + <para> + LockDev, a library available for several systems including + Red-Hat and Debian + </para> + </listitem> + </varlistentry> +</variablelist> + + </para> + </chapter> + + <chapter id="gphoto2base" role="no-toc"> + <title>GPhoto2 Utilities</title> + <para> + 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. + </para> + +&gphoto2-result; +&gphoto2-library; + + </chapter> + + <chapter id="gphoto2objects" role="no-toc"> + <title>GPhoto2 Objects</title> + <para> + In order to simplify programming with GPhoto2, an object oriented + approach has been used. The different objects are presented in + the following sections. + </para> + +&gphoto2-camera; +&gphoto2-filesys; +&gphoto2-widget; +&gphoto2-list; +&gphoto2-abilities-list; +&gphoto2-file; + + </chapter> + + <appendix id="license"> + <title>License</title> + + <para> + This library is free software; you can redistribute it and/or + modify it under the terms of the <citetitle>GNU Library General + Public License</citetitle> as published by the Free Software + Foundation; either version 2 of the License, or (at your option) + any later version. + </para> + + <para> + 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 + <citetitle>GNU Library General Public License</citetitle> for + more details. + </para> + + <para> + You may obtain a copy of the <citetitle>GNU Library General + Public License</citetitle> from the Free Software Foundation by + visiting <ulink type="http" url="http://www.fsf.org">their Web + site</ulink> or by writing to: + + <address> + Free Software Foundation, Inc. + <street>59 Temple Place</street> - Suite 330 + <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode> + <country>USA</country> + </address> + </para> + </appendix> + +</book> |