Color Basics-WPF-VB 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. Since 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
KinectSensor.KinectSensors PropertyGet the Kinect sensors that are plugged in and ready for use.
ColorImageFormat.RgbResolution640x480FPS30 enumeration valueChoose the color stream format including the data type, resolution and frame rate of the data.
ImageStream.FramePixelDataLength PropertySpecify the length of the pixel data buffer when you allocate memory to store the color stream data from the sensor.
ImageStream.FrameWidth Property and ImageStream.FrameHeight PropertySpecify the width and height of the frame data to use a WriteableBitmap to store/render the color data.
KinectSensor.Start Method and KinectSensor.Stop MethodStart or stop streaming data.
KinectSensor.ColorFrameReady eventAdd an event handler for the color data. The sensor will signal the event handler when each new frame of color data is ready.
ColorImageFrameReadyEventArgs.OpenColorImageFrame MethodGet a frame of color data, in the event handler.
ColorImageFrame.CopyPixelDataTo MethodCopy a frame of color data to a pre-allocated array, so it can then be written to an optional WriteableBitmap.

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