From 228c0df39528e15ce0aefbd2aa3d97339326cec1 Mon Sep 17 00:00:00 2001
From: Andreas Kopmann <andreas.kopmann@kit.edu>
Date: Wed, 1 Aug 2012 15:59:13 +0200
Subject: Added description of the camera data format

---
 admin.tex | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

(limited to 'admin.tex')

diff --git a/admin.tex b/admin.tex
index 51ce433..5bd8671 100644
--- a/admin.tex
+++ b/admin.tex
@@ -81,6 +81,77 @@ To autoload driver, copy \verb|misc/50-pcidriver.rules| into the \verb|/etc/udev
 
 \subsection{Universal camera layer -- libuca}
 
+Libuca is an abbreviation for Unified Camera access. It is a library to access two-dimensional pixel detectors most commonly called cameras. It gives the user a general interface to a variety of different cameras and camera types. It is used to configure them via a property based
+interface and acquire images.
 
+Installation instruction from libuca/INSTALL.
+
+\begin{verbatim}
+Simple install procedure
+========================
+
+  $ tar xfz libuca-0.x.tar.gz
+  $ cd libuca-0.x
+  $ mkdir build
+  $ cd build/
+  $ cmake ..
+  $ make
+
+  [ Become root if necessary ]
+  $ make install
+
+
+Requirements
+============
+
+libuca requires CMake and pkg-config for building libraries and accompanying
+tools. Information about CMake can be found at:
+
+    http://www.cmake.org
+
+and pkg-config at:
+
+    http://www.freedesktop.org/software/pkgconfig
+
+libuca depends on the GObject library for object oriented programming.
+Information about this library can be found at:
+
+    http://developers.gnome.org/gobject/stable
+
+Each specific camera needs a camera SDK and/or a driver:
+
+    - UFO camera: pcilib
+    - pco.edge, pco.4000, pco.dimax cameras: SiliconSoftware menable IV driver
+      and SDK as well as the libpco wrapper.
+
+The control tools require Gtk+ GUI toolkit. Information is available at:
+
+    http://developer.gnome.org/platform-overview/
+
+
+Building the Library
+====================
+
+On Linux, libuca uses the CMake build system and pkg-config for dependency
+detection. The normal procedure to build this library is to create an empty
+build directory:
+
+    $ mkdir build/ && cd build
+
+configure the project using CMake:
+
+    $ cmake ../
+
+and compiling the library with make:
+
+    $ make
+    $ make install
+
+Options to the build process can be passed to the system when configuring:
+
+    $ cmake ../ -DCMAKE_INSTALL_PREFIX=/usr
+
+or via configuration tools like `ccmake`.
+\end{verbatim}
 
 
-- 
cgit v1.2.3

