Webcam Sensor

Glossary Item Box

Robotics Common: Depth Camera

DSS Interop Samples: Kinect Sensor

See Also Microsoft Robotics Developer Studio Send feedback on this topic

Webcam Sensor

The generic WebCam Sensor Service provides access to the RGB (Video) camera on a Kinect. It is different from the generic WebCam service.

You do not need to partner with the WebCam Sensor service if you also use the DepthCam service because the DepthCam state includes both the depth data and the RGB data. In fact, if you want the two images to be as close together as possible in time then you should use the DepthCam service. The WebCam Sensor service is primarily intended for applications that do not use depth data.

The Generic WebCam Sensor service provides the following operations. Replace is available for notifications.

Operation Description
Get Gets the State of the WebCamSensor service.
HttpGet Gets the State via a HTTP request, usually from a web browser.
HttpQuery Used to request images from a web browser.
Replace Reserved. Do not send this operation request.
Subscribe Subscribe to notifications. Only Replace messages are sent as notifications.

Unlike the WebCam, you can Subscribe to the WebCam Sensor and it will send frames as notifications (Replace messages). Alternatively, you can poll the service using Get.

The state of a WebCam Sensor is represented the following properties.

Name Type Description
Data byte[] The raw image data in BGR24 format. Note that the order is not RGB.
DeviceName string Name of the device.
Height int Height of the image in pixels.
HorizontalFieldOfView double Horizontal Field of View of the camera in Radians.
InverseProjectionMatrix Matrix Inverse of the Projection Matrix, i.e. it converts in the opposite direction.
ProjectionMatrix Matrix A matrix that defines the conversion between real world view space (3D) and camera space (pixel coordinates plus depth).
Stride int The number of bytes in each scanline.
Timestamp DateTime Time when this image was captured.
Width int Width of the image in pixels.

For more information, see the Kinect Services for RDS document in the Documentation folder of your RDS installation.

See Also 

Robotics Common: Depth Camera

DSS Interop Samples: Kinect Sensor

 

 

© 2012 Microsoft Corporation. All Rights Reserved.