Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Kinect for Windows 1.5, 1.6, 1.7, 1.8
Gets the Kinect's elevation or tilt angle in the range [+/-27] degrees, which defines the sensor's interaction space.
Syntax
HRESULT NuiCameraElevationGetAngle(
LONG *plAngleDegrees
)
Parameters
- plAngleDegrees
Type: LONG
[out] The pointer to the location that contains the elevation angle of the Kinect sensor in degrees. The pointer cannot be NULL when you call NuiCameraElevationGetAngle. Valid angles are in the range [NUI_CAMERA_ELEVATION_MINIMUM, NUI_CAMERA_ELEVATION_MAXIMUM].
Return Value
Type: HRESULT
Returns S_OK if successful; otherwise, returns one of the following failure codes.
| Error | Description |
|---|---|
| E_NUI_DEVICE_NOT_READY | Kinect has not been initialized. |
| E_POINTER | The plAngleDegrees parameter is an invalid handle. |
Remarks
You can tilt the field of view using the tilt motor in the sensor. The motor allows an additional [+/-27] degrees, which effectively doubles the volume that the field of view could surround.
The tilt is relative to gravity rather than relative to the sensor base. An elevation angle of zero indicates that the Kinect is pointing perpendicular to gravity.
The angle is subject to the physical limitations of the sensor. If the sensor base is resting on a tilted surface, the middle of the sensor's tilt range will not correspond to an elevation angle of zero, and the sensor may not be physically capable of reaching the outer limits of the range allowed by the API.
If the sensor is moved so that the base is at a different angle relative to gravity, or if the sensor is tilted manually, the angle reported by the API will change, even if the elevation angle has not been changed programmatically.
For more information, see Interaction Space.
Requirements
Header: Declared in NuiImageCamera.h; however, include NuiApi.h in your project.