LayerFilter QML Type
控制在帧图分支中绘制的图层。更多...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QLayerFilter |
| Inherits: | |
| Status: | Deprecated |
此类型已弃用。我们强烈建议不要在新代码中使用它。
属性
- filterMode : enumeration
- layers : list<Layer>
详细说明
LayerFilter 可用于指示渲染器在帧图的该分支中绘制哪些图层。LayerFilter 会根据添加到 LayerFilter 以及作为Entity 组件的Layer 实例,来选择要绘制的实体。
可根据filterMode 的属性,配置LayerFilter以选择或忽略具有特定Layer 的实体。默认情况下,引用了Layer 对象且该对象同时被LayerFilter 引用的实体将被选中(AcceptAnyMatchingLayers)。
在 FrameGraph 树中,从根节点到叶节点的分支内可以嵌套多个LayerFilter 节点。 在这种情况下,过滤操作将首先针对场景中的所有实体,使用第一个声明的 `LayerFilter` 指定的过滤方法进行处理。然后,对经过过滤的实体子集,将根据第二个声明的 `LayerFilter ` 上设置的过滤方法再次进行过滤。此过程将重复进行,直到该分支中的所有 `LayerFilter ` 节点均被处理完毕。
属性文档
filterMode : enumeration
存储用于指定要选中并绘制的实体的过滤模式。
默认值为LayerFilter.AcceptMatchingLayers 。
| 常量 | 描述 |
|---|---|
LayerFilter.AcceptAnyMatchingLayers | 接受引用一个或多个已添加到此“Layer ”中的“ ”对象的实体。LayerFilter 。这是默认设置 |
LayerFilter.AcceptAllMatchingLayers | 接受引用已添加到此 中的所有Layer 对象的实体。这是默认值LayerFilter |
LayerFilter.DiscardAnyMatchingLayers | 丢弃引用添加到此 中的一个或多个Layer 对象的实体。简体中文(大陆)LayerFilter |
LayerFilter.DiscardAllMatchingLayers | 丢弃引用了添加到此处的所有Layer 对象的实体LayerFilter |
layers : list<Layer> [read-only]
保存一个图层列表,用于指定要选中的绘图图层。
© 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.