Auf dieser Seite

RenderablesFilter QML Type

Definiert einen Filter zur Auswahl der Renderables, auf die sich eine „ pass “ auswirkt. Mehr...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Command

Eigenschaften

Ausführliche Beschreibung

Der Typ „RenderablesFilter“ wird verwendet, um festzulegen, welche renderbaren Objekte in der Szene von einem „ RenderPass “ betroffen sein sollen. Durch Setzen der Eigenschaft „ renderableTypes “ können Sie steuern, ob der Durchlauf undurchsichtige Objekte, transparente Objekte oder gar keine Objekte betrifft.

Die Einstellung von „ renderableTypes “ auf „ None “ ist sinnvoll, wenn ein „ RenderPass “ als Container für „ SubRenderPass “-Befehle dient und selbst keine Szenenobjekte rendern soll.

Zusätzlich zum Filtern nach Renderable-Typen können Sie mithilfe des „ layerMask “ anhand der zugewiesenen „ layers “ weiter verfeinern, welche Renderables betroffen sind.

// A pass that renders only opaque scene objects
RenderPass {
    id: opaquePass
    commands: [
        ColorAttachment { name: "color0"; target: opaqueColorTexture },
        DepthTextureAttachment { target: depthTexture },
        RenderablesFilter {
            renderableTypes: RenderablesFilter.Opaque
        }
    ]
}

// A pass that renders only transparent objects on top
RenderPass {
    id: transparentPass
    commands: [
        ColorAttachment { name: "color0"; target: transparentColorTexture },
        RenderablesFilter {
            renderableTypes: RenderablesFilter.Transparent
        }
    ]
}

Dokumentation zu den Eigenschaften

layerMask : int

Legt die Ebenenmaske für den Filter fest. Nur die auf den angegebenen Ebenen befindlichen Renderelemente werden vom Filter beeinflusst.

Siehe auch Node::layers.

renderableTypes : enumeration [default: RenderablesFilter.Opaque | RenderablesFilter.Transparent]

Legt fest, auf welche Arten von Renderables sich der Filter auswirkt.

KonstanteBeschreibung
RenderablesFilter.NoneEs werden keine renderbaren Elemente gerendert. Nützlich für Container-Pässe, die ausschließlich SubRenderPasses enthalten.
RenderablesFilter.OpaqueEs werden nur undurchsichtige Renderables gerendert.
RenderablesFilter.TransparentEs werden nur transparente Renderables gerendert.

Hinweis: Mehrere Werte können mithilfe des Operators | kombiniert werden.

© 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.