video3d_frame_get_meters :: Quanser C Functions

navigation bar

video3d_frame_get_meters

Get the frame motion data in meters.

Description

The video3d_frame_get_meters function gets the frame motion data in meters. This function is only valid for depth streams. The data parameter must point to memory large enough to hold the image (HxW array of singles).

Prototype

t_error
video3d_frame_get_meters(t_video3d_frame frame, t_single * data);

Parameters

t_video3d_frame frame

The handle to the frame returned by video3d_stream_get_frame.

t_single * data

The depth data in meters retrieved as a single-precision grayscale image.

Return value

The return value is 0 if the frame data was retrieved successfully. Otherwise a negative error code is returned. Error codes are defined in quanser_errors.h. A suitable error message may be retrieved using msg_get_error_message.

Error codes

QERR_INVALID_ARGUMENT

One of the arguments is invalid.

Requirements

Include Files	Libraries
quanser_video3d.h	quanser_media.lib;quanser_communications.lib;quanser_runtime.lib;quanser_common.lib

Examples

t_single depth[640*480];
t_error result;

result = video3d_frame_get_meters(frame, depth);