在本页

PlaneGeometry QML Type

为平面提供几何图形。更多

Import Statement: import QtQuick3D.Helpers
Since: Qt 6.9
Inherits:

Geometry

属性

详细说明

PlaneGeometry 是一种表示平面的几何体类型。平面的大小由高度和宽度属性定义。平面的拓扑结构由meshResolution 属性定义。平面的方向由 plane 属性定义。

属性文档

asynchronous : bool

此属性表示几何体生成是否应为异步。

height : real

平面的高度。默认值为 100.0。

meshResolution : size

平面的分辨率。默认值为QSize(2, 2)。

mirrored : bool

平面的 UV 坐标是否垂直翻转时,该属性保持不变。

plane : PlaneGeometry::Plane

平面的方向。默认值为PlaneGeometry.XY。除非反转为 true,否则所有几何体都将沿所选平面创建,正面和法线都将指向剩余的正轴。

常数说明
PlaneGeometry.XY平面沿 XY 平面定向。
PlaneGeometry.XZ平面沿 XZ 平面定向。
PlaneGeometry.ZY平面沿 ZY 平面定向。

reversed : bool

无论平面是否翻转,这一属性都成立。这会改变平面的法线和卷绕顺序。默认值为 false,这意味着以 XY 方向创建平面时,法线将指向正 Z 方向,卷绕顺序为逆时针。当反转为真时,法线将指向负 Z 方向,卷绕顺序为顺时针。

status : bool [read-only]

当异步为 true 时,此属性表示几何体生成的状态。

常量说明
PlaneGeometry.Null几何体生成尚未开始
PlaneGeometry.Ready几何体生成已完成。
PlaneGeometry.Loading几何体生成正在进行。
PlaneGeometry.Error几何体生成失败。

width : real

平面的宽度。默认值为 100.0。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.