Class Info |
|---|
public class ARPlane extends ARTrackableBase 保存AR Engine识别的真实世界中的平面信息,派生自ARTrackableBase。两个或者多个平面法向量朝向一致,位置靠近时会自动合并到一个父平面中,合并之后每个子平面的getSubsumedBy()将返回父平面。被合并的子平面将继续被跟踪和返回。 |
Qualifier and Type | Method Name and Description |
|---|---|
| 获取从平面的局部坐标系到世界坐标系转换的pose。
| |
float | 获取平面的矩形边界沿平面局部坐标系X轴的长度,如矩形的宽度。 |
float | 获取平面的矩形边界沿平面局部坐标系Z轴的长度,如矩形的高度。 |
getLabel() 获取当前平面被识别为的语义类型,如桌面、地板,使用时需要使用setSemanticMode()启用语义识别模式。 | |
FloatBuffer | 获取检测平面的二维顶点数据,格式为[x1, z1, x2, z2, ...],这些值均在平面局部坐标系的x-z平面中定义,须经getCenterPose()转换到世界坐标系中。注意:在垂直平面中返回的值也是局部坐标系中的坐标[x1,z1,x2,z2,….],需要使用getCenterPose()转换到世界坐标系。 |
| 获取平面的父平面(一个平面被另一个平面合并时,会产生父平面),如果无父平面返回为null。 | |
getType() 获取平面的类型。 | |
boolean | isPoseInExtents(ARPose pose) 如果传入的位姿(通过ARHitResult.getHitPose()获取)位于平面的矩形范围内,则返回true。 |
boolean | isPoseInPolygon(ARPose pose) 如果传入的位姿(通过ARHitResult.getHitPose()获取)位于平面的多边形中,则返回true。 |
Methods Inherited from com.huawei.hiar.ARTrackableBase |
|---|
Method |
|---|
public ARPose getCenterPose() 获取平面的局部坐标系到世界坐标系转换的pose。
|
Returns
Type | Description |
|---|---|
平面的局部坐标系到世界坐标系转换的pose。 |
Method |
|---|
public float getExtentX() 获取平面的矩形边界沿平面局部坐标系X轴的长度,如矩形的宽度。 |
Returns
Type | Description |
|---|---|
float | 平面的矩形边界沿平面局部坐标系X轴的长度。 |
Method |
|---|
public float getExtentZ() 获取平面的矩形边界沿平面局部坐标系Z轴的长度,如矩形的高度。 |
Returns
Type | Description |
|---|---|
float | 平面的矩形边界沿平面局部坐标系Z轴的长度。 |
Method |
|---|
public SemanticPlaneLabel getLabel() 获取当前平面被识别为的语义类型,如桌面、地板,使用时需要使用setSemanticMode()启用语义识别模式。 |
Returns
Type | Description |
|---|---|
当前平面被识别为的语义类型。 |
Method |
|---|
public FloatBuffer getPlanePolygon() 获取检测平面的二维顶点数据,格式为[x1, z1, x2, z2, ...],这些值均在平面局部坐标系的x-z平面中定义,须经getCenterPose()转换到世界坐标系中。注意:在垂直平面中返回的值也是局部坐标系中的坐标[x1,z1,x2,z2,….],需要使用getCenterPose()转换到世界坐标系。 |
Returns
Type | Description |
|---|---|
FloatBuffer | 检测平面的二维顶点数组。 |
Method |
|---|
public ARPlane getSubsumedBy() 获取平面的父平面(一个平面被另一个平面合并时,会产生父平面),如果无父平面返回为null。 |
Returns
Type | Description |
|---|---|
平面的父平面。 |
Method |
|---|
public boolean isPoseInExtents(ARPose pose) 如果传入的位姿(通过ARHitResult.getHitPose()获取)位于平面的矩形范围内,则返回true。 |
Parameters
Name | Description |
|---|---|
pose | 需要判断的位姿信息。 |
Returns
Type | Description |
|---|---|
boolean | 给定位姿是否位于平面的矩形范围内。 |
Method |
|---|
public boolean isPoseInPolygon(ARPose pose) 如果传入的位姿(通过ARHitResult.getHitPose()获取)位于平面的多边形中,则返回true。 |
Parameters
Name | Description |
|---|---|
pose | 需要判断的位姿信息。 |
Returns
Type | Description |
|---|---|
boolean | 给定位姿是否位于平面的多边形中。 |