This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

Acquire Images with Kinect V1

Acquire image and skeletal data from Kinect for Windows V1

The Kinect adaptor lets you acquire images using a Kinect® for Windows® V1 or V2 device. The Kinect V1 sensor runs on Windows 7 and above.

Functions

imaqtoolLaunch Image Acquisition Tool
videoinputCreate video input object
imaq.VideoDeviceAcquire one frame at a time from video device
getdataAcquired image frames to MATLAB workspace
peekdataMost recently acquired image data
getsnapshotImmediately return single image frame
startObtain exclusive use of image acquisition device
isloggingDetermine whether video input object is logging
isrunningDetermine whether video input object is running
isvalidDetermine whether image acquisition object is associated with image acquisition device
waitWait until image acquisition object stops running or logging
stopStop video input object
clearClear image acquisition object from MATLAB workspace
deleteRemove image acquisition object from memory
flushdataRemove data from memory buffer used to store acquired image frames
obj2mfileConvert video input objects to MATLAB code
imaqmontageSequence of image frames as montage
loadLoad image acquisition object into MATLAB workspace
saveSave image acquisition objects to MAT-file
triggerInitiate data logging
triggerconfigConfigure video input object trigger properties
triggerinfoProvide information about available trigger configurations

Examples and How To

Detect the Kinect V1 Devices

Because the Kinect for Windows camera has two separate sensors, the color sensor and the depth sensor, the toolbox lists two DeviceIDs. Use imaqhwinfo on the adaptor to display the two device IDs.

Acquire Image and Skeletal Data Using Kinect V1

This example shows how to create a videoinput object for the color sensor to acquire RGB images and then for the depth sensor to acquire skeletal data. It also outlines the properties of each sensor, and the skeletal metadata.

Acquire Data from Kinect V1 Color and Depth Devices Simultaneously

You can synchronize the data from the Kinect for Windows color stream and the depth stream using software manual triggering.

Use Skeleton Viewer for Kinect V1 Skeletal Data

You can acquire skeletal data and view the skeleton joints in a viewer. This example uses the viewer function to display the RGB image with skeleton joint locations overlaid on the image.

Concepts

Key Features and Differences in the Kinect V1 Support

Doing image acquisition with a Kinect for Windows camera is similar to using other cameras and adaptors, but has some key differences.

Data Streams Returned by the Kinect V1 Adaptor in MATLAB

The Kinect for Windows V1 device returns these data streams in MATLAB. The formats of the image and depth streams are outlined here.