blob: 4197cc3bfdd21dbd7972dd245c0f88aa2957606f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
Tools
=====
Several tools are available to ensure ``libuca`` works as expected. All
of them are located in ``build/test/`` and some of them are installed
with ``make installed``.
uca-camera-control -- simple graphical user interface
-----------------------------------------------------
Records and shows frames. Moreover, you can change the camera properties in a
side pane:
.. image:: uca-gui.png
uca-grab -- grabbing frames
---------------------------
Grab with frames with ::
$ uca-grab --num-frames=10 camera-model
store them on disk as ``frames.tif`` if ``libtiff`` is installed,
otherwise as ``frame-00000.raw``, ``frame-000001.raw``. The raw format
is a memory dump of the frames, so you might want to use
`ImageJ <http://rsbweb.nih.gov/ij/>`__ to view them. You can also
specify the output filename or filename prefix with the ``-o/--output``
option::
$ uca-grab -n 10 --output=foobar.tif camera-model
Instead of reading exactly *n* frames, you can also specify a duration
in fractions of seconds::
$ uca-grab --duration=0.25 camera-model
uca-benchmark -- check bandwidth
--------------------------------
Measure the memory bandwidth by taking subsequent frames and averaging
the grabbing time::
$ ./benchmark mock
# --- General information ---
# Sensor size: 640x480
# ROI size: 640x480
# Exposure time: 0.000010s
# type n_frames n_runs frames/s MiB/s
sync 100 3 29848.98 8744.82
async 100 3 15739.43 4611.16
|