C O R I A N D E R
The Gnome IEEE-1394 Digital Camera Controller
(C) 2000-2013 by Damien Douxchamps <email@example.com>
Mailing list: firstname.lastname@example.org
Coriander is a GUI for controlling a Digital Camera (compatible with
the IIDC specs issued by the 1394 Trade Association ). Coriander
offers full camera control (including Format_7 and absolute settings),
live video display, images and streams saving, images posting with FTP
and last but not least video4linux (V4L) export. The latter service
allows you to use Coriander as a V4L video generator for popular
applications like GnomeMeeting, Effectv,... Due to the properties of
the IEEE1394 protocol, Coriander can even control an IEEE1394 camera
without interferring with the image flow from that camera. You can
thus setup a camera with Coriander while the video flow is used by
IMPORTANT NOTE: Coriander will NOT work with consumer-grade DV cameras
(e.g. cameras in which you can insert a tape). These cameras should be
controlled with he AV/C protocol, please refer to . Also, not all
industrial cameras are IIDC specs-compliant. Check  to have a list
of currently supported cameras.
Most image processing scientists using 1394 cameras under Linux know
about the libdc1394 library . However, it's a real problem when you
need to quickly setup a demo or get some frames for testing. If, just
like me, you also had this problem, Coriander is for you !
Contributors are most welcome so if you're interrested in making this
program better don't hesitate to contact me.
The latest version can be found on the SourceForge website:
There is a user manual available at the same URL. Please read it
before sending tons-o-emails to me!! ;-) You will also get a faster
reply if you send your e;ails to the mailing lists (see above).
As I can only test Coriander with the cameras I have which means some
features have not been tested. If you have another camera, please test
Coriander and send to the mailing list with the bugs you identified.
Last but not least, Coriander has received vision hardware donations or
lease and technical help from the following companies:
- Hamamatsu Photonics http://www.hpk.co.jp
- The Imaging Source http://www.1394imaging.com
- Point Grey Research http://www.ptgrey.com
- Basler GmbH http://www.balserweb.com
- Dage-MTI http://www.dagemti.com
- Viewplus http://viewplus.jp
Many thanks for their support!
Basically, you should just type:
If you got a GIT repo version you need to type
If you have troubles, please read the INSTALL file provided.
- A linux box,
- a 1394 card (OHCI)
- a digital camera compatible with IIDC specs v1.04 or later.
Software requirements are now more or less correctly probed by the configure
script: libdc1394, libraw1394, MMX/SSE capabilities, libftp and SDL libs are
- a kernel with 1394 support , preferably a recent 2.6.X
Kernel modules to be compiled: ieee1394, ohci1394, raw1394 and video1394
- XFree 3.3.6 (XFree 4.1.0 recommended for video overlay)
- Gtk 1.2 & Gtk-devel
- libraw1394  and libdc1394  installed. You need at least libdc1394
- ftplib installed for FTP support 
- SDL installed for display support 
- Glade (for development only)
- automake 1.4 (for development only)
- autoconf 2.13 (for development only)
- vloopback module v 0.92 for v4l support . You should apply the patch
found in the nice effectv program  the 0.90 version in order to have
it working. Effectv can be used to check that v4l is working. Note that
if you use videoN as v4l device in Coriander, the device other applications
can use is video(N+1). V4l service works also well with Gnomemeeting .
vloopback will only work with kernels 2.6 if you use the latest patch.
- libtiff for TIFF image output (incl. 16 bit tiffs!)
In order to have Xv support within SDL, you will maybe need some custom
drivers, e.g. for Nvidia chipsets  or for ATI Rage chipsets .
Debian-based distribution packages:
If you are using a Debian-based distribution, you can easily choose to
install the following packages that will allow you to compile the code:
libgnome-dev libgnomeui-dev libxv-dev libsdl-image1.2-dev
 1394 T.A. : http://www.1394ta.org
 libdc1394 : http://sourceforge.net/projects/libdc1394
 linux1394 : http://www.linux1394.org
 Coriander : http://sourceforge.net/projects/coriander
 linux1394 : http://sourceforge.net/projects/libraw1394
 LiViD : http://www.linuxvideo.org
 1394 IIDC camera list : http://www.tele.ucl.ac.be/PEOPLE/DOUXCHAMPS/ieee1394/cameras/
 linux1394 HOWTO : http://www.linux1394.org/start_req.html
 ftplib : http://nbpfaus.net/~pfau/ftplib/
 Nvidia : http://www.nvidia.com
 SDL : http://www.libsdl.org
 vloopback : http://motion.technolust.cx/vloopback/
 effectv : http://effectv.sf.net/
 Gnomemeeting : http://www.gnomemeeting.org