Glossary Item Box
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.
|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.
|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.
Robotics Common: Depth Camera
DSS Interop Samples: Kinect Sensor
© 2012 Microsoft Corporation. All Rights Reserved.