目录

ARCamera

Class Info

public class ARCamera

提供当前帧对应的相机信息,ARSession启动以后,引擎内部维护一个伴随ARSession生命周期的ARCamera对象,每次调用ARSession.update()时,该对象的值均会被更新。

Public Method Summary

Qualifier and Type

Method Name and Description

boolean

equals(Object obj)

使用该方法可以比较是否对应同一个ARCamera对象。

ARCameraIntrinsics

getCameraImageIntrinsics()

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

ARPose

getDisplayOrientedPose()

返回用户设备在世界坐标系中的位置和姿态,返回值的位置位于设备的相机处,而方向大致与显示器的方向一致(屏幕旋转时方向会发生改变)。

ARPose

getPose()

返回用户设备在世界坐标系中的位置和姿态,返回值的位置和方向跟随设备的物理相机变化(不受屏幕旋转影响)。

void

getProjectionMatrix(float[] dest, int offset, float near, float far)

返回一个坐标运算相关的投影矩阵,可用于相机坐标系到裁剪坐标系转换。

ARTrackable.TrackingState

getTrackingState()

获取相机位姿的当前跟踪状态。

void

getViewMatrix(float[] viewMatrix, int offset)

返回当前帧对应相机的视图矩阵,可用于世界坐标系到相机坐标系的转换。

int

hashCode()

返回对象的哈希值。

Public Methods

[h2]equals

Method

public boolean equals(Object obj)

使用该方法可以比较是否对应同一个ARCamera对象。

Parameters

Name

Description

obj

需要比较对象。

Returns

Type

Description

boolean

对象是否相等。

[h2]getCameraImageIntrinsics

Method

public ARCameraIntrinsics getCameraImageIntrinsics()

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

Returns

Type

Description

ARCameraIntrinsics

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

[h2]getDisplayOrientedPose

Method

public ARPose getDisplayOrientedPose()

返回用户设备在世界坐标系中的位置和姿态,返回值的位置位于设备的相机处,而方向大致与显示器的方向一致(屏幕旋转时方向会发生改变)。

Returns

Type

Description

ARPose

用户设备在世界坐标系中的位姿。

[h2]getPose

Method

public ARPose getPose()

返回用户设备在世界坐标系中的位置和姿态,返回值的位姿跟随设备的物理相机变化(不受屏幕旋转影响)。

Returns

Type

Description

ARPose

用户设备在世界坐标系中的位姿。

[h2]getProjectionMatrix

Method

public void getProjectionMatrix(float[] dest, int offset, float near, float far)

返回一个坐标运算相关的投影矩阵,可用于相机坐标系到裁剪坐标系转换。

Parameters

Name

Description

dest

存储至少16个浮点数,以列为顺序表示4x4矩阵。

offset

开始写入dest的开始偏移地址。

near

以米为单位指定近平面。

far

以米为单位指定远平面。

[h2]getTrackingState

Method

public ARTrackable.TrackingState getTrackingState()

获取相机位姿的当前跟踪状态。

Returns

Type

Description

ARTrackable.TrackingState

位姿跟踪状态。

[h2]getViewMatrix

Method

public void getViewMatrix(float[] viewMatrix, int offset)

返回当前帧对应相机的视图矩阵,可用于世界坐标系到相机坐标系的转换。

Parameters

Name

Description

viewMatrix

存储至少16个浮点数,以列为顺序表示4x4矩阵。

offset

开始写入viewMatrix的开始偏移地址。

[h2]hashCode

Method

public int hashCode()

返回对象的哈希值。

Returns

Type

Description

int

对象哈希编码。