QLayerFilter¶
- PyQt5.Qt3DRender.QLayerFilter
Inherits from QFrameGraphNode.
Description¶
Controls layers drawn in a frame graph branch.
A QLayerFilter can be used to instruct the renderer as to which layer(s) to draw in that branch of the frame graph. QLayerFilter selects which entities to draw based on the QLayer instance(s) added to the QLayerFilter and as components to QEntity.
QLayerFilter can be configured to select or discard entities with a specific QLayer depending on the filterMode property. By default, entities referencing one of the QLayer objects that are also being referenced by the QLayerFilter are selected (AcceptAnyMatchingLayers).
Within the FrameGraph tree, multiple QLayerFilter nodes can be nested within a branch going from root to a leaf. In that case the filtering will first operate on all entities of the scene using the filtering method specified by the first declared QLayerFilter. Then the filtered subset of entities will be filtered again based on the filtering method set on the second QLayerFilter declared. This is then repeated until all QLayerFilter nodes of the branch have been consumed.
Enums¶
- FilterMode
Specifies the rules for selecting entities to draw.
Member
Value
Description
AcceptAllMatchingLayers 1
Accept entities that reference all the QLayer objects added to this __init__()
AcceptAnyMatchingLayers 0
Accept entities that reference one or more QLayer objects added to this __init__(). This is the default
DiscardAllMatchingLayers 3
Discard entities that reference all QLayer objects added to this __init__()
DiscardAnyMatchingLayers 2
Discard entities that reference one or more QLayer objects added to this __init__()
Methods¶
- __init__(parent: QNode = None)
The constructor creates an instance with the specified parent.
- addLayer(QLayer)
Add layer to the current list of layers
- filterMode() → FilterMode
See also
- layers() → List[QLayer]
Returns the current list of layers
- removeLayer(QLayer)
Remove layer from the current list of layers
- setFilterMode(FilterMode)
See also
Signals¶
- filterModeChanged(FilterMode)
TODO
