blob: aa7e2c182f00ee9e13dbf570257494f4afd7bba0 (
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
Tools
=====
Several tools are available to ensure ``libuca`` works as expected. All
of them are installed with ``make install``.
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
You can see all available options of ``uca-camera-control`` with::
$ uca-camera-control --help-all
uca-grab -- grabbing frames
---------------------------
Grab 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
You can see all available options of ``uca-grab`` with::
$ uca-grab --help-all
uca-benchmark -- check bandwidth
--------------------------------
Measure the memory bandwidth by taking subsequent frames and averaging
the grabbing time::
$ uca-benchmark option camera-model
You can specify the number of frames per run with the ``-n/--num-frames`` option, the number of runs with the ``-r/--num-runs`` option and test asynchronous mode with the ``async`` option::
$ uca-benchmark -n 100 -r 3 --async mock
# Type Trigger Source FPS Bandwidth Frames acquired/total
sync auto 17.57 Hz 4.39 MB/s 300/300 acquired (0.00% dropped)
async auto 19.98 Hz 4.99 MB/s 300/300 acquired (0.00% dropped)
# --- General information ---
# Camera: mock
# Sensor size: 4096x4096
# ROI size: 512x512
# Exposure time: 0.050000s
You can see all available options of ``uca-benchmark`` with::
$ uca-benchmark --help-all
uca-info -- get properties information
--------------------------------------
Get information about camera properties with::
$ uca-info camera-model
For example::
$ uca-info mock
# RO | name | "mock camera"
# RO | sensor-width | 4096
# RO | sensor-height | 4096
# RO | sensor-pixel-width | 0.000010
# RO | sensor-pixel-height | 0.000010
# RO | sensor-bitdepth | 8
...
uca-gen-doc -- generate properties documentation
------------------------------------------------
Generate HTML source code of property documentation of a camera with::
$ uca-gen-doc camera-model
|
