1,847
edits
Image acquisition package: Difference between revisions
Jump to navigation
Jump to search
m
Remove redundant Category:Packages.
(update of "make check" output) |
m (Remove redundant Category:Packages.) |
||
| (10 intermediate revisions by 3 users not shown) | |||
| Line 7: | Line 7: | ||
If you want to report a bug: [[Image_acquisition_package#Reporting_bugs]] | If you want to report a bug: [[Image_acquisition_package#Reporting_bugs]] | ||
'''image-acquisition will not work on Windows as far as there is not port of v4l2 (standing for ''Video for Linux 2'')''' | |||
== Example session == | == Example session == | ||
Lines starting with octave> are executed on the octave prompt. | Lines starting with "octave:>" are executed on the octave prompt. | ||
=== Load the package and list available hardware === | === Load the package and list available hardware === | ||
octave> pkg load image-acquisition | octave:> pkg load image-acquisition | ||
octave> imaqhwinfo | octave:> imaqhwinfo | ||
ans = | ans = | ||
scalar structure containing the fields: | scalar structure containing the fields: | ||
driver = uvcvideo | driver = uvcvideo | ||
card = UVC Camera (046d:0825) | card = UVC Camera (046d:0825) | ||
| Line 29: | Line 29: | ||
=== Open the v4l2 device and output the result === | === Open the v4l2 device and output the result === | ||
octave> obj = videoinput("v4l2", "/dev/video0") | octave:> obj = videoinput("v4l2", "/dev/video0") | ||
obj = videoinput for v4l2 | obj = videoinput for v4l2 | ||
device | device = /dev/video0 | ||
driver | driver = uvcvideo | ||
card | card = UVC Camera (046d:0825) | ||
VideoInput | VideoInput = 0 | ||
VideoResolution | VideoResolution = 320 x 240 px | ||
VideoFormat = YUYV | |||
=== Query which properties are available for the used device === | === Query which properties are available for the used device === | ||
The first | |||
octave> get(obj) | The first 8 ones, starting with an upper letter are fixed, the other specific to the used v4l2 device. | ||
octave:> get(obj) | |||
ans = | ans = | ||
{ | { | ||
[1,1] = SelectedSourceName | [1,1] = SelectedSourceName | ||
[2,1] = DeviceCapabilities | [2,1] = ReturnedColorSpace | ||
[ | [3,1] = BayerSensorAlignment | ||
[ | [4,1] = DeviceCapabilities | ||
[ | [5,1] = VideoInput | ||
[ | [6,1] = VideoResolution | ||
[ | [7,1] = VideoFrameInterval | ||
[ | [8,1] = VideoFormat | ||
[ | [9,1] = brightness | ||
[ | [10,1] = contrast | ||
[ | [11,1] = saturation | ||
[ | [12,1] = white_balance_temperature_auto | ||
[ | [13,1] = gain | ||
[ | [14,1] = power_line_frequency | ||
[ | [15,1] = white_balance_temperature | ||
[ | [16,1] = sharpness | ||
[ | [17,1] = backlight_compensation | ||
[ | [18,1] = exposure_auto | ||
[19,1] = exposure_absolute | |||
[20,1] = exposure_auto_priority | |||
} | } | ||
=== | === Set VideoFormat to RGB3 aka RGB24 === | ||
octave> | |||
octave:> set(obj, "VideoFormat", "RGB3"); | |||
=== List available video resolutions === | === List available video resolutions === | ||
octave> set(obj, "VideoResolution") | |||
octave:> set(obj, "VideoResolution") | |||
ans = | ans = | ||
| Line 101: | Line 97: | ||
=== Set the video resolution to 320x240px === | === Set the video resolution to 320x240px === | ||
octave> set(obj, "VideoResolution", [320 240]) | octave:> set(obj, "VideoResolution", [320 240]) | ||
=== Get the current brightness value === | === Get the current brightness value === | ||
octave> get(obj, "brightness") | |||
octave:> get(obj, "brightness") | |||
ans = 100 | ans = 100 | ||
=== Query possible range for brightness === | === Query possible range for brightness === | ||
octave> set(obj, "brightness") | |||
octave:> set(obj, "brightness") | |||
ans = | ans = | ||
| Line 119: | Line 117: | ||
=== Set a new value for brightness === | === Set a new value for brightness === | ||
octave> set(obj, "brightness", 100) | |||
octave:> set(obj, "brightness", 100) | |||
=== Start preview === | === Start preview === | ||
octave> preview(obj) | |||
octave:> preview(obj) | |||
Close it with CTRL+C or with [X] on the preview window | Close it with CTRL+C or with [X] on the preview window | ||
=== Use higher resolution and start streaming with 2 buffers === | === Use higher resolution and start streaming with 2 buffers === | ||
octave> set(obj, "VideoResolution", [640 480]); | |||
octave> start(obj, 2) | octave:> set(obj, "VideoResolution", [640 480]); | ||
octave:> start(obj, 2) | |||
=== Get an image from the buffers, view and save it === | === Get an image from the buffers, view and save it === | ||
octave> img = getsnapshot(obj); | |||
octave> image(img) | octave:> img = getsnapshot(obj); | ||
octave> imwrite(img, "ex1_a.png") | octave:> image(img) | ||
octave> [img, seq, t] = getsnapshot(obj); | octave:> imwrite(img, "ex1_a.png") | ||
octave> seq | |||
octave:> [img, seq, t] = getsnapshot(obj); | |||
octave> t | octave:> seq | ||
seq = 1 | |||
octave:> t | |||
t = | |||
scalar structure containing the fields: | scalar structure containing the fields: | ||
tv_sec = | tv_sec = 10281 | ||
tv_usec = | tv_usec = 779303 | ||
=== Stop streaming === | === Stop streaming === | ||
octave> stop(obj) | |||
octave:> stop(obj) | |||
== Using v4l2loopback for tests == | == Using v4l2loopback for tests == | ||
| Line 171: | Line 176: | ||
There might be some warnings like "warning: function xyz shadows a built-in function" at start. | There might be some warnings like "warning: function xyz shadows a built-in function" at start. | ||
Exit octave and add libv4l2_debug.log to your bug report | Exit octave and add libv4l2_debug.log to your bug report. The logfile libv4l2_debug.log is overwritten between open/close so you have to rename it if you run different scripts. | ||
Consider running the included tests: | Consider running the included tests: | ||
| Line 179: | Line 184: | ||
octave> test @videoinput/set | octave> test @videoinput/set | ||
octave> test @videoinput/getsnapshot | octave> test @videoinput/getsnapshot | ||
Run the compliance check (perhaps also with -s) | |||
v4l2-compliance -d /dev/video0 | |||
== Build source from mercurial repository == | == Build source from mercurial repository == | ||
| Line 184: | Line 193: | ||
'''Warning: You really should use the <pkg install -forge> method described above if you are not sure what you are doing here.''' | '''Warning: You really should use the <pkg install -forge> method described above if you are not sure what you are doing here.''' | ||
Get the source | Get the source and build it yourself. The build dependencies for Debian GNU/Linux jessie are '''libv4l-dev''' and '''libfltk1.3-dev''' or '''libfltk1.1-dev'''. You also need the GNU autotools to generate the configure script. | ||
$ hg clone http://hg.code.sf.net/p/octave/image-acquisition octave-image-acquisition | $ hg clone http://hg.code.sf.net/p/octave/image-acquisition octave-image-acquisition | ||
$ cd octave-image-acquisition/ | $ cd octave-image-acquisition/ | ||
$ | $ make install | ||
== make check == | == make check == | ||
| Line 198: | Line 205: | ||
$ cd octave-image-acquisition/devel | $ cd octave-image-acquisition/devel | ||
$ make check | $ make check | ||
octave -q run_tests.m | octave -q run_tests.m | ||
../src/__v4l2_handler__.cc........................ PASS 3/3 | ../src/__v4l2_handler__.cc........................ PASS 3/3 | ||
| Line 206: | Line 213: | ||
@videoinput/getsnapshot........................... PASS 4/4 | @videoinput/getsnapshot........................... PASS 4/4 | ||
imaqhwinfo........................................ PASS 1/1 | imaqhwinfo........................................ PASS 1/1 | ||
Summary: | Summary: | ||
PASS 20 | PASS 20 | ||
FAIL 0 | FAIL 0 | ||
If there are tests which FAIL, then please have a look at the generated fntest.log and add it to your bug report. | If there are tests which FAIL, then please have a look at the generated fntest.log and add it to your bug report. | ||
[[Category:Octave Forge]] | |||