diff options
author | Hans Ulrich Niedermann <gp@n-dimensional.de> | 2006-06-24 11:32:06 +0000 |
---|---|---|
committer | Hans Ulrich Niedermann <gp@n-dimensional.de> | 2006-06-24 11:32:06 +0000 |
commit | 0c5633f284927775566715e30998ddb9c2e02d88 (patch) | |
tree | 2e08558d15ed5b99a6b15cd45c3d6e5b75d04efd /README | |
parent | f567eeceabfcf7bfe248ea6797ccb5a2f3443ebe (diff) | |
download | libgphoto2-0c5633f284927775566715e30998ddb9c2e02d88.tar.gz |
Dummy README: Please read README.in or generate README by running a build.
git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@8967 67ed7778-7388-44ab-90cf-0a291f65f57c
Diffstat (limited to 'README')
-rw-r--r-- | README | 147 |
1 files changed, 2 insertions, 145 deletions
@@ -1,146 +1,3 @@ +This is a dummy place holder file - libgphoto2 - ---------- - -Hello and welcome to the wonderful world of gphoto! This is libgphoto2, the -successor of gphoto with lots of new features and additional camera -drivers. - -If you miss a feature, would like to report success or failure, or have any -questions, please don't hesitate to contact our mailing list. - - - -What is libgphoto2? -------------------- - -libgphoto2 is a library that can be used by applications to access various -digital cameras. - -For more information on gphoto, see - - http://www.gphoto.org/ - -There, you can also get information on mailing lists, supported cameras, -and availability of gphoto2. Another source of information is - - http://sourceforge.net/projects/gphoto - -where you can access our CVS server to fetch the source code of -gphoto2, gtkam and GnoCam (see below). - - - -What is libgphoto2 not? ------------------------ - -libgphoto2 itself is not a GUI application, opposed to gphoto. There are -GUI frontends for the gphoto2 library, however, such as gtkam for -example. - -libgphoto2 can only talk to cameras the language of those it understands. -That is, if you own a camera that speaks a language that isn't published -anywhere and nobody has been able to figure out the meaning of the sentences, -libgphoto2 cannot communicate with those cameras. - -Then, there are cameras supporting the so-called USB Mass Storage protocol. -This is a protocol that has been published and lets you access any storage -device, be it a camera or a disk connected via USB to your computer. As there -are already drivers for this protocol out there, you don't need an additional -library like libgphoto2. The list of camera that use USB Mass Storage is getting -longer everyday, so we won't publish it. - -For a more up to date list, you can consult - - http://www.teaser.fr/~hfiguiere/linux/digicam.html - -Your operating system will tell you about that because it is likely to recognise -the device as a SCSI disk that you can mount (for Linux 'dmesg' will tell you). -Again, those cameras *cannot* be accessed through libgphoto2. Some of them can -be switched to use a different communication protocol and might be in that case -useable with libgphoto2. - -Other camera support a protocol called PTP or USB Imaging Devices that has -been developped by Kodak and other. libgphoto2 does support PTP. -Here is a short incomplete list of camera that use this protocol: - - * HP PhotoSmart 318, 612, 715 - * Kodak DC-4800, DX-3215, DX-3500, DX-3600, DX-3700, DX-3900, MC3 and all the - camera that use Kodak Easy Share(tm) system. - * Sony DSC-P5, DSC-F707, DSC-P30, DSC-P50, DSC-S75, DSC-S85, MVC-CD300 - (all need user configuration of the camera) - -PTP camera unknown to libgphoto2 can be detected as a generic PTP camera and -will work as is. - -You still may try jPhoto <URL:http://jphoto.sourceforge.net/> for ptp cameras -alternatively if libgphoto2 fails. - - - -Platforms ---------- - -libgphoto2 should compile and run on pretty much all Unix-like platforms. -Additionally, there is a port for OS/2 available. libgphoto2 has _not_ (yet?) -been ported to any operating system from MicroSoft. - - - -How to set up libgphoto2 ------------------------- - -For information on how to set up libgphoto2 and its frontends, see -The gPhoto2 Manual. - -It is available at the following places: - - - At the gphoto website: http://www.gphoto.org/ - - - In the CVS module gphoto2-manual - -The gPhoto2 Manual includes information about setting up USB -hotplugging. - -If you run into problems, you may also consult the FAQ (also included -in The gPhoto2 Manual). - - - -Frontends ---------- - -gphoto2 is a command line frontend which is quite powerful, -especially in combination with scripts. See The gPhoto2 Manual -for a short description. - -For the GUI lovers, there are for example gtkam (GTK based), and -GnoCam (GNOME). Additionally, there are plugins for other programs -available like kio_gphoto (KDE - Konqueror). - - - -Reporting Bugs --------------- - -Every piece of software contains errors and flaws. So does -libgphoto2. When you encounter something that does not work, please do -the following: - -1. Find out whether this is a known problem. - -2. Reproduce the problem with debug output enabled and the language - set to English, so that the development team will understand the - messages. You can do this by running: - - env LC_ALL=C gtkam - - if you're using the gtkam frontend or running: - - env LC_ALL=C gphoto2 --debug <options> - - using the gphoto2 command line interface. - -3. Report the problem on the mailing list with the corresponding debug - output if it is small. If it is more than a few kilobytes, please - don't post the complete debug output on the list. +Please read README.in or generate README by running a build. |