Color Basics-D2D C++ Sample

Kinect for Windows 1.5, 1.6, 1.7, 1.8


When you run this sample, you see the following:

  • The color video stream captured and displayed on the screen. Because every frame is captured, this is a live picture of whatever the Kinect is pointed at.
  • Click Screenshot to capture the screen and save it in a file.

The Sample Uses the Following APIsTo Do This
NuiGetSensorCount FunctionGet the number of sensors that are ready for use.
NuiCreateSensorByIndex Function and INuiSensor InterfaceCreate an interface that represents a connected sensor.
INuiSensor::NuiStatus MethodCheck the sensor status to see if the sensor is connected.
INuiSensor::NuiInitialize Method and NUI_INITIALIZE_FLAG_USES_COLOR constantInitialize the sensor to stream out color data.
CreateEvent FunctionCreate an event that will be signaled when color data is available by returning an event handle.
INuiSensor::NuiImageStreamOpen Method, NUI_IMAGE_TYPE_COLOR constant, NUI_IMAGE_RESOLUTION_640x480 constant, and the event handleOpen a color stream to receive color data.
INuiSensor::NuiImageStreamGetNextFrame MethodOpen a stream (with the event just created) for storing color data from the sensor.
INuiSensor::NuiImageStreamReleaseFrame MethodRelease each frame of color data after saving it.
INuiSensor::Release MethodRelease the sensor when you exit the application.

To run a sample you must have the Kinect for Windows SDK installed. To compile a sample, you must have the developer toolkit installed. The latest SDK and developer toolkit are available on the developer download page. If you need help installing the toolkit, look on this page: To Install the SDK and Toolkit. The toolkit includes a sample browser, which you can use to launch a sample or download it to your machine. To open the sample browser, click Start > All Programs > Kinect for Windows SDK [version number] > Developer Toolkit Browser.

If you need help loading a sample in Visual Studio or using Visual Studio to compile, run, or debug, see Opening, Building, and Running Samples in Visual Studio.

Community Additions