PySide6.Qt3DRender.Qt3DRender.QPickingSettings

class QPickingSettings

QPickingSettings 类指定了如何处理实体拾取。更多

PySide6.Qt3DRender.Qt3DRender.QPickingSettings 的继承图

概要

属性

方法

插槽

信号

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

拾取设置决定了如何处理实体拾取。有关实体拾取的更多详细信息,请参阅 QObjectPickerQRayCaster 组件文档。

当使用QObjectPicker组件时,拾取是由鼠标事件触发的。

当使用QRayCasterQScreenRayCaster组件时,应用程序可以显式触发拾取。

在这两种情况下,都会通过场景投射一条射线,以找到与射线相交的几何体。

另请参阅

QObjectPicker QPickEvent QPickTriangleEvent QRayCaster QScreenRayCaster

class PickMethod

指定拣选方法。

常量

描述

Qt3DRender.QPickingSettings.BoundingVolumePicking

如果拾取射线与实体的边界体积相交,则认为实体被拾取(默认)。

Qt3DRender.QPickingSettings.TrianglePicking

如果拾取射线与实体网格组件的任何三角形相交,则认为实体被拾取。

Qt3DRender.QPickingSettings.LinePicking

如果拾取射线与实体网格组件的任何边相交,则认为实体被拾取。

Qt3DRender.QPickingSettings.PointPicking

如果拾取射线与实体网格组件的任何点相交,则认为实体被拾取。

Qt3DRender.QPickingSettings.PrimitivePicking

如果拾取射线与实体网格组件的任何点、边或三角形相交,则认为实体被拾取。

class PickResultMode

指定拣选结果中包含的内容。

常量

描述

Qt3DRender.QPickingSettings.NearestPick

只有与拾取射线相交且距离拾取射线原点最近的实体被拾取(默认)。

Qt3DRender.QPickingSettings.AllPicks

所有与拾取射线相交的实体都会被拾取。

Qt3DRender.QPickingSettings.NearestPriorityPick

选择具有最高值的实体对象拾取器。如果多个对象拾取器具有相同的优先级,则选择射线上的最近一个。

另请参阅

QPickEvent

class FaceOrientationPickingMode

指定面部方向如何影响三角形拾取

常量

描述

Qt3DRender.QPickingSettings.FrontFace

仅选择前向三角形(默认)。

Qt3DRender.QPickingSettings.BackFace

仅背面三角形将被拾取。

Qt3DRender.QPickingSettings.FrontAndBackFace

正面和背面的三角形都将被选中。

注意

当使用from __feature__ import true_property时,属性可以直接使用,否则通过访问器函数使用。

property faceOrientationPickingModeᅟ: Qt3DRender.QPickingSettings.FaceOrientationPickingMode

指定面部方向如何影响三角形拾取

Access functions:
property pickMethodᅟ: Qt3DRender.QPickingSettings.PickMethod

保存当前的选取方法。

默认情况下,出于性能考虑,射线投射将使用边界体积拾取。然而,如果一个小物体被其后面的大物体的边界球体包围,这可能会导致意外的结果。

三角形选取将产生精确的结果,但计算成本更高。

Access functions:
property pickResultModeᅟ: Qt3DRender.QPickingSettings.PickResultMode

保存当前的拾取结果模式。

默认情况下,只会为最靠近摄像头的实体生成拾取结果。

当将拾取方法设置为AllPicks时,将触发沿射线的所有具有QObjectPicker的实体的事件。

当将选择方法设置为NearestPriorityPick时,将为最近最高优先级的选取器触发事件。当某个给定元素应始终被选中,即使其他元素在其前面时,可以使用此方法。

如果将一个QObjectPicker分配给具有多个子实体的实体,将为每个与射线相交的子实体触发一个事件。

Access functions:
property worldSpaceToleranceᅟ: float

保存用于评估线和点拾取的阈值,以模型空间坐标表示。

Access functions:
__init__([parent=None])
Parameters:

parentQNode

faceOrientationPickingMode()
Return type:

FaceOrientationPickingMode

另请参阅

setFaceOrientationPickingMode()

属性 faceOrientationPickingModeᅟ 的获取器。

faceOrientationPickingModeChanged(faceOrientationPickingMode)
Parameters:

faceOrientationPickingModeFaceOrientationPickingMode

属性 faceOrientationPickingModeᅟ 的通知信号。

pickMethod()
Return type:

PickMethod

另请参阅

setPickMethod()

属性 pickMethodᅟ 的获取器。

pickMethodChanged(pickMethod)
Parameters:

pickMethodPickMethod

属性 pickMethodᅟ 的通知信号。

pickResultMode()
Return type:

PickResultMode

另请参阅

setPickResultMode()

属性 pickResultModeᅟ 的获取器。

pickResultModeChanged(pickResult)
Parameters:

pickResultPickResultMode

属性 pickResultModeᅟ 的通知信号。

setFaceOrientationPickingMode(faceOrientationPickingMode)
Parameters:

faceOrientationPickingModeFaceOrientationPickingMode

另请参阅

faceOrientationPickingMode()

属性 faceOrientationPickingModeᅟ 的设置器。

setPickMethod(pickMethod)
Parameters:

pickMethodPickMethod

另请参阅

pickMethod()

属性 pickMethodᅟ 的设置器。

setPickResultMode(pickResultMode)
Parameters:

pickResultModePickResultMode

另请参阅

pickResultMode()

属性 pickResultModeᅟ 的设置器。

setWorldSpaceTolerance(worldSpaceTolerance)
Parameters:

worldSpaceTolerance – 浮点数

将用于线和点选择的阈值设置为worldSpaceTolerance

另请参阅

worldSpaceTolerance()

属性 worldSpaceToleranceᅟ 的设置器。

worldSpaceTolerance()
Return type:

浮点数

返回线和点的精度 worldSpaceTolerance

另请参阅

setWorldSpaceTolerance()

属性 worldSpaceToleranceᅟ 的获取器。

worldSpaceToleranceChanged(worldSpaceTolerance)
Parameters:

worldSpaceTolerance – float

属性 worldSpaceToleranceᅟ 的通知信号。