Hans de Goede 6c5db352a6 Add st2205 lookup tables to st2205 camlib
A gphoto user has contacted me about getting what appears to be a new
version of a st2205 picture frame working with gphoto. The st2205 frames
use a rather funky image compression which involves 2 lookup tables:

1) lookup table with 8 byte patterns, a check is done if color
gradients in these blocks are close to a set of fixed patterns, if
they are they the block gets encoded in as a base color + gradient
pattern number

2) These devices do a number of transition effects, these effects
are part of the encoding, the transitions are mainly done to
hide the slowness of the device and the 8x8 blocks are stored
in transition order, so the first block to be shown is the first
one in the data stream, second block to be shown second, etc. This
means we need to know the location where each block will end up
on the screen to compress / decompress. There are a number of
fixed tables for this (1 set of tables per supported resution,
with 1 table per effect number).

So far we've been reading these tables from the firmware image
which can be accessed through the same interface as the picture
memory on these devices. But this new device does not have these
tables in its memory in any recognizable form.

This commits adds the necessary tables directly to the st2205 camlib,
to enable support for this new type of st2205 picture frames.


git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@15102 67ed7778-7388-44ab-90cf-0a291f65f57c
2014-07-22 11:20:36 +00:00
2011-10-22 07:54:52 +00:00
2014-07-22 06:30:49 +00:00
2014-06-27 05:15:03 +00:00
2014-07-02 06:28:13 +00:00
2014-05-10 16:22:18 +00:00
2014-06-27 05:16:32 +00:00
2010-03-14 22:06:29 +00:00
2014-07-02 07:47:30 +00:00
2002-12-15 11:45:10 +00:00
2014-05-04 10:44:48 +00:00
2007-09-03 10:40:38 +00:00
2013-05-27 13:40:01 +00:00
2014-07-22 11:20:36 +00:00
2012-07-10 07:36:10 +00:00
2010-11-01 06:10:47 +00:00

========================================================================
libgphoto2 README.packaging
========================================================================

This file describes a number of things you should know when building
packages (.debs, .rpms, ports, emerges, etc. pp.)


========================================================================
libgphoto2 and libgphoto2_port
==============================

The libgphoto2 library builds on the libgphoto2_port library, which is
thus internally contained within every libgphoto2 release. By
installing libgphoto2, you always also install libgphoto2_port.


========================================================================
Installed files
===============

A standard install of libgphoto2 does about this:

   * The most important files:
     * ${libdir}/libgphoto2.{a,la,so}
     * ${libdir}/libgphoto2/<VERSION>/*.{a,la,so}        (camlibs)
     * ${libdir}/libgphoto2_port.{a,la,so}
     * ${libdir}/libgphoto2_port/<VERSION>/*.{a,la,so}   (iolibs)
     In most cases, you can remove the *.a and *.la files from the
     list of files to ship.
   * Packaging helpers:
     * ${utilsdir}/libgphoto2/print-camera-list
     * ${utilsdir}/libgphoto2/print-usb-usermap (linux-hotplug, obsolete)
     * ${udevscriptdir}/check-mtp-device
     * ${udevscriptdir}/check-ptp-camera
     Defaults: utilsdir=${libdir}, ${udevscriptdir}=${libdir}/udev.
     You probably want to ./configure udevscriptdir=/lib/udev and possibly
     utilsdir='${libexecdir}', depending on your system.
   * Documentation:
     * Man pages:
       * ${mandir}/man3/libgphoto2.3
       * ${mandir}/man3/libgphoto2_port.3
     * ${docdir}/camlibs/README.*    (camlib docs)
     * ${docdir}/{README,AUTHORS,NEWS}
     * ${docdir}/apidocs.html/       API docs
     * ${docdir}/{README,AUTHORS,NEWS}
     You may want to install these files into your custom locations.
     If you separate library from libfoo-devel packages, the former
     should probably ship with the camlib docs, and the general README
     and NEWS. Try configure --with-docdir=.
   * Translated strings:
     * ${datadir}/locale/*/LC_MESSAGES/libgphoto2-2.mo
     * ${datadir}/locale/*/LC_MESSAGES/libgphoto2_port-0.mo
     * ${datadir}/libgphoto2/<VERSION>/konica/*
       These files are required for the konica camlib to work at all.
   * For developers:
     * ${includedir}/gphoto2/gphoto2*.h
     * ${libdir}/pkgconfig/libgphoto2.pc
     * ${libdir}/pkgconfig/libgphoto2_port.pc

Note that utilsdir, udevscriptdir, etc. can be set at configure
time. See "configure --help".


========================================================================
Permission setup
================

We consider it a bug in the package if the package does not offer a
way for the user to just plug in his camera and use it. This may at
most require adding the user to a "camera" or "plugdev" group.

You will want to create HAL or UDEV rules by running this utility:

   * print-camera-list

This utility requires libgphoto2 and its camlibs being installed,
either

   * at package building time by doing a DESTDIR based temporary
     install somewhere and setting LD_LIBRARY_PATH and CAMLIBS before
     running print-camera-list
   * at package installation time as a post installation hook

The UDEV rules require two helper scripts/binaries, which obviously
need to be installed by the package:

   * check-mtp-device (not working yet)
   * check-ptp-camera

You can either use fixed permissions in the generated rules, or call
your own permission setup script to dynamically decide what to do.

(Contemporary example scripts are not being shipped yet.)


========================================================================
Development packages
====================

The recommended way to use libgphoto2 in a build process is to use
pkg-config and thus these files really should be shipped in a package:

   * /usr/lib/pkgconfig/libgphoto2.pc
   * /usr/lib/pkgconfig/libgphoto2_port.pc

We are still shipping

   * /usr/bin/gphoto2-config
   * /usr/bin/gphoto2-port-config

for compatibility reasons, but that will obviously break when you have
a /usr/lib64 vs. /usr/lib conflict. That problem is one the packager
will have to resolve - we consider this mechanism obsolete.


========================================================================
End of file.
========================================================================
Languages
C 93.8%
M4 3%
Perl 0.9%
Meson 0.7%
Makefile 0.6%
Other 1%