Module Info |
|---|
提供相机相关信息,包括相机的位姿信息、图像的内参数据,渲染AR内容的投影矩阵,视图矩阵。 |
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) 释放对相机的引用。 |
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 | 虚拟相机在世界空间中的位姿。 |
Function |
|---|
HwArCamera_getImageIntrinsics(const HwArSession *session, const HwArCamera *camera, HwArCameraIntrinsics *outIntrinsics) 获取物理相机离线内参的对象,可通过该对象获取相机的焦距、图像尺寸、主轴点和畸变参数。 |
Parameters
Name | Description |
|---|---|
session | 与AR Engine服务交互的Session对象。 |
camera | Session对应的相机。 |
outIntrinsics | 相机物理内参对象。 |
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 | 物理相机在世界空间中的位姿。 |
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中以列为主的均匀变换矩阵。 |
Function |
|---|
HwArCamera_getTrackingState(const HwArSession *session, const HwArCamera *camera, HwArTrackingState *outTrackingState) 获取相机的当前追踪状态。只有当该状态为Tracking时,相机的位姿才可用。 |
Parameters
Name | Description |
|---|---|
session | 与AR Engine服务交互的Session对象。 |
camera | Session对应的相机。 |
outTrackingState | 当前相机的追踪状态。 |
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中以列为主的均匀变换矩阵。 |
Function |
|---|
HwArCamera_release(HwArCamera *camera) 释放对相机的引用。当调用了HwArFrame_acquireCamera时,需要相应的调用HwArCamera_release。 注意: 当没有HwArFrame_acquireCamera时,调用该方法无效。 |
Parameters
Name | Description |
|---|---|
camera | 待释放的相机引用。 |