Files
libgphoto2/camlibs/digigr8
Hans Ulrich Niedermann 767ee8bad4 Avoid accidental include file name collisions
There are five libgphoto2 internal *.h include files inside the
source tree's `libgphoto2/` folder. Internal means they are part
of the libgphoto2 implementation, and are not part of the public
libgphoto2 API or ABI. These files have names which are so
generic that it is difficult to see from a `#include` statement
that the included file is actually part of libgphoto2:

    bayer-types.h
    bayer.h
    exif.h
    gamma.h
    jpeg.h

While building, an additional file is created inside the `libgphoto2/`
folder with a name which does hint to its relationship with libgphoto2:

    gphoto2-endian.h

To reduce the probability of accidental conflicts with include files
which might also be called the same very generic name, this changes
the use of these include files to a preprocessor directive like

    #include "libgphoto2/bayer.h>

instead of

    #include "bayer.h"

To enforce the need for the "libgphoto2/" part in the #include
preprocessor directive, this also removes the respective `-I`
arguments for the `libgphoto2` subdir (both in source tree and in
build tree) from `*_CPPFLAGS`.

This change was inspired by `libgphoto2/` and `camlibs/stv0680/`
containing very different include files both called `bayer.h`.
2021-10-11 09:20:50 +02:00
..
2021-09-08 03:15:39 +02:00

/* This is one of the README files for libgphoto2/camlibs/digigr8. This is an 
 * integral part of the libgphoto2/camlibs/digigr8 library source code and is 
 * distributed with that source code under the LGPL license. a copy of which 
 * license may be seen in the head directory of libgphoto2, in the file 
 * COPYING.
 * This file copyright Theodore Kilgore, 05/10/2009.
 */ 

CONCERNING 0x2770:0x9052 CAMERAS

First, a general remark. The reader is strongly encouraged to read
README.905C as well as this file. That file in fact pertains to all of the
cameras which are supported by libgphoto2/camlibs/digigr8. All of what it says
pertains to the 0x2770:0x9052 cameras, too, unless something to the contrary is
stated below.


The only camera known to use the ID 0x2770:0x9052 a Disney Pix Micro camera. It
seems to be a VGA version of the smaller camera with the same name, which 
reports itself as 0x2770:0x9050. The new camera has the resolution settings 
640x480 and 320x240. Both cameras permit deletion of all photos. The same 
operations are used for that as for the capture of an image to the computer
(that is, the gphoto2 --capture-preview operation). The user is therefore 
advised that the --capture-preview operation will also clear the camera's 
memory and remove all images stored there. 

The camera also has kernel support for webcam mode. To run the camera as a
webcam will also delete all still photos stored in the camera.

For further details please consult the file README.9050.

Revised 01/12/2012