What it does ¶
ALVideoDevice module is in charge of providing, in an efficient way, images from the video source (e.g. robot’s cameras, Simulator) to all modules processing them, such as ALFaceDetection or ALVisionRecognition .
The picture underneath is a RGB conversion of the YUV422 file sent by the camera.
How it works ¶
As the ALVideoDevice module knows at every moment the list of modules needing images and their requirements, it is able to set the minimum configuration for the video device that will fulfil the needs of all the modules while saving processing resources.
Multi camera support ¶
Each SoftBank Robotics robot has specific cameras models, and there are more than one camera on each. For further details, see:
- Video cameras
- 2D Cameras , Stereo Camera
Performances and Limitations ¶
Best performance on the robot is achieved when processing directly the native colorspace provided by the camera: YUV422. For other colorspaces, a conversion is done by the ALVideoDevice module, so processing times are ranked as follow for the main colorspaces:
YUV422 < Yuv < YUV < RGB/BGR < HSY (close to HSV/HSL colorspaces in term of functionality, but faster to process).
YUV colorspace is convenient as it is more powerful than RGB:
luminance is in the Y channel so don’t need to average the three RGB layers to get a grey level image,
chrominance is purely embedded in both U and V channels, so it’s easier to work on colors compared to RGB for which luminance and chrominance are correlated.
Providing uncorrelated luminance and chrominance channels, it brings almost the same advantages than HSV/HSL without spending as much CPU time for processing it.
Currently on ATOM CPU, requesting more than 5fps 1280x960 HD images remotely (getImageRemote) is bringing some frame drops. So we recommend not to go over 5fps HD images if you want to get them through the network. If all modules processing HD images are calling them locally (getImageLocal), there is no such limitation.
Here are the observed framerates when requesting uncompressed YUV422 images on NAO v4 (*).
|local||Gb Ethernet||100Mb Ethernet||WiFi g|
- Remote performance might vary with the client network configuration.
- On Windows, Monitor is usually appearing as blocked at 21fps. Other remote modules don’t suffer such a limitation.
- GB Ethernet performance with 1280x960 was observed on WinXP.
Getting started ¶
Make your vision module subscribe to the
In the main process loop, get an image by calling
Release the image calling
When you stop your module, call
Additional resources ¶
If you want to develop your own vision module in C++, you might be interested in OpenCV.
It is a large and powerful library dedicated to vision processing. We are currently using OpenCV 3.1.
For further details about OpenCV, visit http://opencv.org/ .
See also the tutorial: Using OpenCV .
A free player for YUV422 images and videos.
The robot’s camera provides natively YUV422 color images.
pYUV is a multiplatform (Windows, Mac and Linux) freeware and can be downloaded from its main page: http://dsplab.diei.unipg.it/pyuv_raw_video_sequence_player_original_one or other sites.
This software can display several non common image and video formats.
- Size: Custom with 1280x960, 640x480, 320x240 or 160x120 depending on the resolution used for recording
- Color space: YUV
- Subsampling: 4:2:2
- Ordering: YUY2
- Interleaved: checked
- Anamorphic: unchecked
- Bits per sample: 8
- Header bytes: 32
Vision / Motion conversion ¶
methods can be useful to translate coordinates
to angles and vice versa. For example, if a detection process returns the
position of an object in pixels, this position can be converted to angles and
to make the robot look in the
direction of the detected object.