目录

HwArCamera

Module Info

提供相机相关信息,包括相机的位姿信息、图像的内参数据,渲染AR内容的投影矩阵,视图矩阵。

Public Method Summary

Qualifier and Type

Method Name and Description

void

HwArCamera_getDisplayOrientedPose(const HwArSession *session, const HwArCamera *camera, HwArPose *outPose)

设置outPose为虚拟相机在世界空间中的位姿,用以将AR内容渲染到最新帧中。

void

HwArCamera_getImageIntrinsics(const HwArSession *session, const HwArCamera *camera, HwArCameraIntrinsics *outIntrinsics)

获取物理相机离线内参对象。

void

HwArCamera_getPose(const HwArSession *session, const HwArCamera *camera, HwArPose *outPose)

设置outPose为最新帧中物理相机在世界空间中的位姿。

void

HwArCamera_getProjectionMatrix(const HwArSession *session, const HwArCamera *camera, float near, float far, float *destColMajor4x4)

获取用于在相机图像上层渲染虚拟内容的投影矩阵。

void

HwArCamera_getTrackingState(const HwArSession *session, const HwArCamera *camera, HwArTrackingState *outTrackingState)

获取相机的当前追踪状态。

void

HwArCamera_getViewMatrix(const HwArSession *session, const HwArCamera *camera, float *outColMajor4x4)

获取最新帧中相机的视图矩阵。

void

HwArCamera_release(HwArCamera *camera)

释放对相机的引用。

Public Methods

[h2]HwArCamera_getDisplayOrientedPose

Function

HwArCamera_getDisplayOrientedPose(const HwArSession *session, const HwArCamera *camera, HwArPose *outPose)

设置outPose为虚拟相机(面向显示)在世界空间中的位姿,用以将AR内容渲染到最新帧中。该位姿是OpenGL相机的位姿,其中x轴正方向为右,y轴正方向为上,z轴负方向为相机的观察方向。相机位置即物理相机位置,而相机x轴与y轴指向受屏幕方向(考虑显示旋转)的影响。

注意:

该位姿信息应该在HwArCamera_getTrackingState返回Tracking状态的时候才能使用。

Parameters

Name

Description

session

与AR Engine服务交互的Session对象。

camera

Session对应的相机。

outPose

虚拟相机在世界空间中的位姿。

[h2]HwArCamera_getImageIntrinsics

Function

HwArCamera_getImageIntrinsics(const HwArSession *session, const HwArCamera *camera, HwArCameraIntrinsics *outIntrinsics)

获取物理相机离线内参的对象,可通过该对象获取相机的焦距、图像尺寸、主轴点和畸变参数。

Parameters

Name

Description

session

与AR Engine服务交互的Session对象。

camera

Session对应的相机。

outIntrinsics

相机物理内参对象。

[h2]HwArCamera_getPose

Function

HwArCamera_getPose(const HwArSession *session, const HwArCamera *camera, HwArPose *outPose)

设置outPose为最新帧中物理相机在世界空间中的位姿。该位姿是OpenGL相机的位姿,其中x轴正方向为右,y轴正方向为上,z轴负方向为相机的观察方向。相机位置即物理相机位置,而相机x轴与y轴指向不受屏幕方向(考虑显示旋转)的影响。

注意:

该位姿信息应该在HwArCamera_getTrackingState返回Tracking状态的时候才能使用。

Parameters

Name

Description

session

与AR Engine服务交互的Session对象。

camera

Session对应的相机。

outPose

物理相机在世界空间中的位姿。

[h2]HwArCamera_getProjectionMatrix

Function

HwArCamera_getProjectionMatrix(const HwArSession *session, const HwArCamera *camera, float near, float far, float *destColMajor4x4)

获取用于在相机图像上层渲染虚拟内容的投影矩阵,可用于相机坐标系到裁剪坐标系转换。

Parameters

Name

Description

session

与AR Engine服务交互的Session对象。

camera

Session对应的相机。

near

OpenGL近裁剪平面距离,以米为单位。

far

OpenGL远裁剪平面距离,以米为单位。

destColMajor4x4

由16个浮点数组成的数组,其中的数据表示OpenGL中以列为主的均匀变换矩阵。

[h2]HwArCamera_getTrackingState

Function

HwArCamera_getTrackingState(const HwArSession *session, const HwArCamera *camera, HwArTrackingState *outTrackingState)

获取相机的当前追踪状态。只有当该状态为Tracking时,相机的位姿才可用。

Parameters

Name

Description

session

与AR Engine服务交互的Session对象。

camera

Session对应的相机。

outTrackingState

当前相机的追踪状态。

[h2]HwArCamera_getViewMatrix

Function

HwArCamera_getViewMatrix(const HwArSession *session, const HwArCamera *camera, float *outColMajor4x4)

获取最新帧中相机的视图矩阵。此矩阵执行了HwArCamera_getDisplayOrientedPose提供的Pose的逆变换,即从世界坐标系转为相机坐标系。

Parameters

Name

Description

session

与AR Engine服务交互的Session对象。

camera

Session对应的相机。

outColMajor4x4

由16个浮点数组成的数组,其中的数据表示OpenGL中以列为主的均匀变换矩阵。

[h2]HwArCamera_release

Function

HwArCamera_release(HwArCamera *camera)

释放对相机的引用。当调用了HwArFrame_acquireCamera时,需要相应的调用HwArCamera_release。

注意:

当没有HwArFrame_acquireCamera时,调用该方法无效。

Parameters

Name

Description

camera

待释放的相机引用。