NUI_SKELETON_DATA Structure

Kinect for Windows 1.5, 1.6, 1.7, 1.8

Contains the data for one skeleton, including overall position, skeleton joint positions, and whether each skeleton joint is tracked successfully.

typedef struct _NUI_SKELETON_DATA {
    NUI_SKELETON_TRACKING_STATE eTrackingState;
    DWORD dwTrackingID;
    DWORD dwEnrollmentIndex;
    DWORD dwUserIndex;
    Vector4 Position;
    Vector4 SkeletonPositions[NUI_SKELETON_POSITION_COUNT];
    NUI_SKELETON_POSITION_TRACKING_STATE eSkeletonPositionTrackingState[NUI_SKELETON_POSITION_COUNT];
    DWORD dwQualityFlags;
} NUI_SKELETON_DATA;

Members

eTrackingState
A NUI_SKELETON_TRACKING_STATE value that indicates which members of this structure contain valid data.
dwTrackingID
The skeleton's current tracking ID. A value of zero indicates that the skeleton is not currently tracked.
dwEnrollmentIndex
The player's enrollment index. A value of zero indicates that the player is not currently enrolled.
dwUserIndex
Not used; set to XUSER_INDEX_NONE.
Position
The skeleton position.
SkeletonPositions
An array of Vector4 structures, each of which represents a single joint position for the skeleton. The joint positions are indexed by the values in the NUI_SKELETON_POSITION_INDEX enumeration. The (x, y, z) members contain the coordinates relative to the sensor array, in meters. The w member is always unity.
eSkeletonPositionTrackingState
An array of NUI_SKELETON_POSITION_TRACKING_STATE values that indicate whether the corresponding joint positions are tracked or inferred.
dwQualityFlags
A bitwise-OR combination of the NUI_SKELETON_QUALITY flags that indicates the quality of the skeleton data.

The skeleton position data ranges are:

  • Values of x range from approximately -2.2 to +2.2.
  • Values of y range from approximately -1.6 to +1.6.
  • Values of z range from 0.0 to 4.0.

Where NUI_SKELETON_POSITION_COUNT is a maximum value of 20.

Header: Declared in NuiSkeleton.h; however, include NuiApi.h in your project.

Community Additions

ADD
Show: