Revision control
+ // Copyright (C) 2026 The Qt Company Ltd.
+ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
+
+ // An AugmentMaterial pass over a CustomMaterial.
+ //
+ // The augmentation is folded into the custom material's shader path key, and
+ // that key is also emitted as the "//Shader name -" comment of the generated
+ // shader. An augment shader is always more than one line long -- the license
+ // header alone sees to that -- so appending it to the key verbatim used to
+ // push everything after its first line out of the comment and into the shader
+ // as stray code, which then failed to compile.
+ //
+ // The material paints itself red and the augment shader overrides that with
+ // green, so a sphere that is not green means the augmentation never ran.
+
+ import QtQuick
+ import QtQuick3D
+ import QtQuick3D.Helpers
+
+ Item {
+ id: root
+ width: 400
+ height: 400
+
+ View3D {
+ anchors.fill: parent
+ renderOverrides: View3D.DisableInternalPasses
+
+ environment: SceneEnvironment {
+ backgroundMode: SceneEnvironment.Color
+ clearColor: "black"
+ tonemapMode: SceneEnvironment.TonemapModeNone
+ }
+
+ PerspectiveCamera {
+ position: Qt.vector3d(0, 0, 300)
+ }
+
+ RenderPassTexture {
+ id: outputTex
+ format: RenderPassTexture.RGBA8
+ }
+
+ RenderPass {
+ id: mainPass
+ materialMode: RenderPass.AugmentMaterial
+ augmentShader: "augment_custom_material_augment.glsl"
+ clearColor: "black"
+
+ commands: [
+ ColorAttachment { target: outputTex },
+ DepthStencilAttachment {}
+ ]
+ }
+
+ SimpleQuadRenderer {
+ texture: Texture {
+ textureProvider: RenderOutputProvider {
+ textureSource: RenderOutputProvider.UserPassTexture
+ renderPass: mainPass
+ attachmentSelector: RenderOutputProvider.Attachment0
+ }
+ }
+ }
+
+ Model {
+ source: "#Sphere"
+ scale: Qt.vector3d(3, 3, 3)
+ materials: CustomMaterial {
+ fragmentShader: "augment_custom_material_material.frag"
+ }
+ }
+ }
+ }