QuadTextureProvider QML Type

カスタムフラグメントシェーダーを使用してクワッドテクスチャをレンダリングするために使用されます。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• format : enumeration (since 6.12)
• fragmentShader : url (since 6.12)
• fragmentShaderCode : string (since 6.12)
• height : int (since 6.12)
• width : int (since 6.12)

詳細な説明

このタイプは、カスタムシェーダーコードを使用してクワッドテクスチャをレンダリングするために使用され、プログラム可能なテクスチャを簡単に取得できる方法を提供します。フラグメントシェーダーと必要なプロパティを指定することで、パスが作成され、指定されたデータに基づいてシェーダーパイプラインが構築されます。この際、プロパティはユニフォーム値としてフラグメントシェーダーに渡されます。

提供される組み込み関数：

カスタムプロパティはユニフォームにマッピングされます。値が変更されるたびに、更新された値がシェーダーに反映されます。この概念は、ShaderEffect ですでに馴染みのあるものかもしれません。

QMLプロパティ名とGLSL変数名は一致している必要があります。個々のユニフォームについて、シェーダーコード内で別途宣言を行う必要はありません。代わりに、QMLプロパティ名をそのまま使用できます。

以下の表に、型のマッピング関係を示します：

単純な赤色のテクスチャを出力する例としては、次のように行うことができます:

Texture {
    textureProvider: QuadTextureProvider {
        width: 128
        height: 128
        fragmentShaderCode: `
            void MAIN() {
                FRAGCOLOR = vec4(1.0, 0.0, 0.0, 1.0);
            }
        `
    }
}

Texture プロパティからサンプリングし、UVカラーと混合する別の例：

Texture {
    textureProvider: QuadTextureProvider {
        fragmentShaderCode: `
        void MAIN() {
            vec2 uv = INPUT_UV;
            vec4 c = texture(checkers, uv);
            FRAGCOLOR = mix(c, vec4(uv, 1, 1), 0.5);
        }`

        property Texture checkers : Texture {
            source: "../shared/maps/checkers2.png"
        }
    }
}

結果は次のようになります:

「ShaderEffect」も参照してください 。

プロパティのドキュメント

format : enumeration [default: TexureData.RGBA16F, since 6.12]

このプロパティは、出力テクスチャのフォーマットを指定します。

このプロパティは Qt 6.12 で導入されました。

fragmentShader : url [since 6.12]

カスタムフラグメントシェーダーコードのスニペットを含むファイルを指定します。

値は URL であり、ローカルファイルであるか、qrc スキームを使用して Qt リソースシステム経由で埋め込まれたファイルにアクセスする必要があります。相対ファイルパス（スキームなし）も使用可能で、その場合はファイルがコンポーネント（.qml ファイル）を基準とした相対パスとして扱われます。

このプロパティは Qt 6.12 で導入されました。

fragmentShaderCodeも参照してください 。

fragmentShaderCode : string [since 6.12]

カスタムフラグメントシェーダーコードの断片を指定します。

ファイルとして提供せずに、シェーダーコードを文字列としてインラインで記述する方法として使用されます。

このプロパティは Qt 6.12 で導入されました。

「fragmentShader」も参照してください 。

height : int [default: 128, since 6.12]

出力テクスチャの高さをピクセル単位で指定します。

このプロパティは Qt 6.12 で導入されました。

「width」も参照してください 。

width : int [default: 128, since 6.12]

出力テクスチャの幅をピクセル単位で指定します。

このプロパティは Qt 6.12 で導入されました。

「height」も参照してください 。