DepthMediaFrame.TryCreateCoordinateMapper 方法

定义

命名空间:

Windows.Media.Capture.Frames

尝试为 DepthMediaFrame 创建 DepthCorrelatedCoordinateMapper。 此对象提供用于将像素坐标从 MediaFrameSource 相机映射到不同 MediaFrameSource 的坐标系或映射到 3D 空间的方法。

public:
 virtual DepthCorrelatedCoordinateMapper ^ TryCreateCoordinateMapper(CameraIntrinsics ^ cameraIntrinsics, SpatialCoordinateSystem ^ coordinateSystem) = TryCreateCoordinateMapper;

DepthCorrelatedCoordinateMapper TryCreateCoordinateMapper(CameraIntrinsics const& cameraIntrinsics, SpatialCoordinateSystem const& coordinateSystem);

public DepthCorrelatedCoordinateMapper TryCreateCoordinateMapper(CameraIntrinsics cameraIntrinsics, SpatialCoordinateSystem coordinateSystem);

function tryCreateCoordinateMapper(cameraIntrinsics, coordinateSystem)

Public Function TryCreateCoordinateMapper (cameraIntrinsics As CameraIntrinsics, coordinateSystem As SpatialCoordinateSystem) As DepthCorrelatedCoordinateMapper

参数

cameraIntrinsics

CameraIntrinsics

一个 对象，该对象描述 将使用 DepthMediaFrame 数据映射坐标的 MediaFrameSource 相机的失真模型。

coordinateSystem

SpatialCoordinateSystem

一个 对象，表示将使用 DepthMediaFrame 数据映射坐标的相机的空间坐标系。

返回

DepthCorrelatedCoordinateMapper

如果操作成功，则为 DepthCorrelatedCoordinateMapper ;否则为 null。

注解

此方法返回的 DepthCorrelatedCoordinateMapper 将使用 DepthMediaFrame 中的深度数据将一个媒体帧或 MediaFrameSource 中的坐标映射到另一个媒体帧或 MediaFrameSource 的坐标系。 此方法的参数指定要映射的原始坐标的相机内部函数和坐标系。

通过调用 TryGetCameraIntrinsics 获取 MediaFrameSource 的静态相机内部函数。 通过访问与 帧源关联的 MediaFrameSourceInfo 的 坐标系统 属性，获取 MediaFrameSource 的静态坐标系。 通过访问 VideoMediaFrame 的 CameraIntrinsics 属性获取动态相机内在。 使用坐标系统属性从 MediaFrameReference 获取动态 坐标系 。

调用 DepthCorrelatedCoordinateMapper 的映射方法时，可以指定目标帧或帧源的相机内部函数和坐标系统，源点将映射到该目标帧或帧源。