Auf dieser Seite

Technique QML Type

Kapseln einer Technik. Mehr...

Import Statement: import Qt3D.Render 2.12
In C++: QTechnique
Inherits:

Node

Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Ausführliche Beschreibung

Eine Technik spezifiziert eine Menge von „ RenderPass “-Objekten, „ FilterKey “-Objekten, „Parameter“-Objekten und ein „ GraphicsApiFilter “, die zusammen eine Rendering-Technik definieren, die die jeweilige Grafik-API darstellen kann. Die Filter-Schlüssel werden von „ TechniqueFilter “ verwendet, um bestimmte Techniken an bestimmten Stellen des FrameGraphs auszuwählen. Ein in einer „Technique“ definierter Parameter überschreibt einen (gleichnamigen) Parameter, der in „ RenderPass “ definiert ist, wird jedoch von Parametern in „ RenderPassFilter “, „ TechniqueFilter “, „Material“ und „Effect“ überschrieben.

Beim Erstellen eines „Effect“, der auf mehrere Versionen einer Grafik-API abzielt, ist es sinnvoll, mehrere „Technique“-Knoten zu erstellen, bei denen jeweils der „ graphicsApiFilter “ so eingestellt ist, dass er einer der Zielversionen entspricht. Zur Laufzeit wählt der Qt3D-Renderer die am besten geeignete „Technique“ aus, basierend darauf, welche Grafik-API-Versionen unterstützt werden, und (falls angegeben) anhand der „ FilterKey “-Knoten, die eine bestimmte „ TechniqueFilter “ im FrameGraph erfüllen.

Hinweis: Bei Verwendung von OpenGL als Grafik-API für das Rendering stützt sich Qt3D auf den von ` QSurfaceFormat::defaultFormat()` zur Laufzeit zurückgegebenen ` QSurfaceFormat `, um zu entscheiden, welche der verfügbaren GL-Versionen am besten geeignet ist. Wenn Sie den ` QSurfaceFormat` anpassen müssen, vergessen Sie nicht, ihn mit ` QSurfaceFormat::setDefaultFormat()` anzuwenden. Das Setzen des ` QSurfaceFormat ` in der Ansicht hat wahrscheinlich keine Auswirkungen auf das Qt3D-bezogene Rendering.

Hinweis: Der „Technique “-Knoten kann nicht deaktiviert werden.

Technique {
    id: gl3Technique
    parameters: [
        Parameter { name: "color"; value: "orange" }
    ]
    filterKeys: [
        FilterKey { name: "renderingStyle"; value: "forward" }
    ]
    graphicsApiFilter: {
        api: GraphicsApiFilter.OpenGL
        profile: GraphicsApiFilter.CoreProfile
        majorVersion: 3
        minorVersion: 1
    }
    renderPasses: [
        RenderPass {
            id: firstPass
            shaderProgram: ShaderProgram {
                // ...
            }
        },
        RenderPass {
            id: secondPass
            shaderProgram: ShaderProgram {
                // ...
            }
        }
    ]
}

Siehe auch „ Effect “, „ RenderPass “ und „ TechniqueFilter “.

Dokumentation zu den Eigenschaften

filterKeys : list<FilterKey>

Gibt die Liste der Filterschlüssel an, die diese Technik ermöglichen

graphicsApiFilter : GraphicsApiFilter [read-only]

Gibt den verwendeten Grafik-API-Filter an

parameters : list<Parameter>

Legt die von der Technik verwendeten Parameter fest

renderPasses : list<RenderPass>

Gibt die von der Technik verwendeten Render-Durchläufe an

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