Remove generated files
[framework/connectivity/libgphoto2.git] / camlibs / spca50x / README.spca50x
1 This is a gphoto2 driver for cameras with a SunPlus spca504 chip and for the
2 Mustek gSmart mini, which has a spca500. It supports cameras with sdram, flash
3 and card storage or a combination of those. Currently we know of the following
4 models:
5
6 Mustek gSmart mini
7 Mustek gSmart mini 2
8 Mustek gSmart mini 3
9 So. Show 301
10 Aiptek Pencam
11 Aiptek Pencam without flash storage (needs --camera "Pencam without flash")
12 Medion MD 5319
13 nisis Quickpix Qp3
14 Trust Spyc@m 500F FLASH
15 Aiptek 1.3 mega PocketCam
16 Maxell Max Pocket
17 Aiptek Smart Megacam
18 Benq DC1300
19 D-Link DSC 350+
20 Trust Familycam 300
21 Minton S-Cam F5
22 Pure Digital Ritz disposable cam
23
24 There are probably more cameras with these chips out there and they probably
25 work with this driver as well.
26
27
28 Notes
29 -----
30 The cameras always delete the last file on them, no matter what file number is
31 passed to it for deletion. It is impossible to delete a specific image or
32 movie on the camera.
33
34 Webcam mode
35 -----------
36 The cameras of this series are based on the spca504a and spca500 chip
37 manufactured by Sunplus. Both chips are capable of streaming, so there's a
38 project working on video4linux support for them. spca50x.sourceforge.net
39 We have been succesfull in getting some of the cameras supported by this
40 camlib working as part of that project. :)
41
42 Authors
43 -------
44 Till Adam <till@adam-lilienthal>
45 based on the work of others and with help from a lot of people listed below.
46 The initial support for the Mustek gsmart mini 2 was based on the sources
47 of the windows driver kindly provided by Mustek.
48
49 Ian MacArthur <ian@imm.uklinux.net>
50 support for spca500 based cams with flash storage.
51
52
53 This camlib is the result of merging several others that were created before
54 it was clear how they relate to each other. The thank you sections of the old
55 READMEs are listed here in no particular order.
56
57 Post merge thanks
58 -----------------
59 A lot of people helped with testing the merged camlib. Most of them are listed
60 below anyway, so I wont list them again.
61
62 Big thanks to Richard Curnow <rc@rc0.org.uk> who fixed several bug in the
63 gsmart mini support. His patches went in during the merge.
64
65 Hartmut Henkel <hartmut_henkel@gmx.de> helped debug a crash with thumbnails.
66 Rupert Levene <r.levene@lancaster.ac.uk> helped debug the merged camlib.
67 Norbert Möndjen <Norbert.Moendjen@t-online.de> found out that the pencams
68 don't react well to the reset command.
69 Walt Boring <waboring@3gstech.com> helped debug the above reset problem.
70 John Feuerstein <bizkit@baze.de> helped figuring out and testing the 
71 workaround for Pencams without flash.
72
73 Thanks to John Maushammer <gphoto2@maushammer.com> for adding support for the
74 Dakota disposable cameras.
75
76
77 Thanks from the Benq README
78 ---------------------------
79 Johan Nilsson <jni@users.sourceforge.net> made windows snoops, tested the
80 early versions and helped debug them. Without him, this would not have been
81 possible.
82
83
84 Thanks from the gsmart README
85 -----------------------------
86 Special thanks go to Bjorn Borud <borud@gua.no> who extorted the above
87 mentioned sources for the windows driver from Mustek and to Buster Lee at
88 Mustek for being helpful and responsive.
89
90 Special thanks also to Tim Sampson <tim@columbia-staver.co.uk>, who made the
91 support for spca500 based cams (such as the gsmart mini) possible by boldly
92 trying out my untested alpha versions.
93
94 Adam Pribyl <covex@ahoj.fsik.cvut.cz> helped debugging the lowest resolution
95 of the gsmart mini and had to put his cam in the fridge (!) several times in
96 the process. Brave man. ;)
97
98 Michel Xhaard <mxhaard@free.fr> helped add support for the Maxell Max Pocket
99 with patches and testing. Thanks a lot.
100
101 Very special thanks to Piotr Pawlow <pp@siedziba.pl> for adding avi index
102 functionality and fixing a few bugs.
103
104 Also thanks to the following people for testing and feedback:
105
106 Torfinn Ingolfsen <torfinn.ingolfsen@broadpark.no>
107 Mikael Nilsson <mini@nada.kth.se>
108 Miah Gregory <mace@darksilence.net>
109 Soenke Reimers <soenke.reimers@freenet.de>
110 Gerd Flaig <gefla@pond.sub.org>
111
112 Thanks from the spca504_flash README
113 ------------------------------------
114 This owes everything to the work of Mark Zimmermann <mark@foresthaven.com> whose
115 pencamread tool I have simply ported to a gphoto2 camlib. The macam driver by
116 Matthias Krauß was also helpfull. All features are theirs, all bugs are mine.
117
118 I dont own a camera of this type, so I had to rely on Armin Janssen
119 <unclebenz@foni.net> to tirelessly produce usb snoops, test and give feedback.
120 Without Armin this would not have been possible, so if you own a camera that
121 is supported by this driver consider sending him an email and thanking him for
122 risking his cam so yours works on linux ;).
123
124 Thanks also to Martyn Ranyard <ranyardm@lineone.net> for testing and reporting
125 success with the nisis Quickpix Qp3. He also helped debug the beginnings of
126 avi support.