ShaderImage QML Type

シェーダープログラムから画像にアクセスできるようにします。詳細...

この型は非推奨です。新しいコードでの使用は強く推奨しません。

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

プロパティ

• access : enumeration
• format : enumeration
• layer : int
• layered : bool
• mipLevel : int

詳細な説明

シェーダー内でテクスチャの内容を読み書きできるようにするには、それらを ShaderImage として公開する必要があります。テクスチャは、複数のミップレベル、レイヤー、およびフェースで構成される場合があります。さらに、ShaderImage を宣言することで、テクスチャの内容のうち、どのレベル、レイヤー、またはフェースにアクセスしたいかを指定することができます。

ShaderImageが正常に機能するためには、パラメータの値として割り当てられ、有効なQt3D.Render.AbstractTexture を参照している必要があります。

参照されるテクスチャが1次元配列、2次元配列、3次元、キューブマップ、キューブマップ配列、または2次元マルチサンプル配列テクスチャである場合、テクスチャレベル全体、あるいはそのテクスチャレベル内の単一のレイヤーやフェイスをバインドすることが可能です。これはlayered プロパティで制御できます。

ShaderImage のサポートは、OpenGL 4 でのみ完全に対応しており、OpenGL ES 3.1 および 3.2 では一部のみ対応しています。

OpenGL 4 では、以下の画像タイプがサポートされています：

OpenGL ES 3.1 は、以下の画像タイプをサポートしています:

OpenGL ES 3.2 は、OpenGL ES 3.1 のすべての画像タイプに加え、以下のタイプもサポートしています:

想定される使用例は以下の通りです:

import Qt3D.Render 2.14

Entity {
...
    Texture2D {
        id: tex2D
        ...
    }

    Material {
        parameters: Parameter {
            name: "imageUniformName"
            value: ShaderImage {
                texture: tex2D
            }
        }
        ...
    }
 ...
}

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

access : enumeration

シェーダーインスタンスから画像に対して許可するアクセスの種類を指定します。シェーダーが、互換性のないアクセス権を持つ画像への書き込みや読み取りを試みた場合、その挙動は未定義となります。

デフォルト値は `ShaderImage.ReadWrite` です。

format : enumeration

画像形式を指定します。これは、シェーダーからShaderImage に値を格納する際に極めて重要です。

このフォーマットは、参照されるテクスチャのフォーマットと同じである必要はありません。ただし、互換性がある必要があります（サイズは一致している必要がありますが、クラス型が一致している必要はありません）。 たとえば、フォーマット R32F（サイズ 32 ビット、クラス 1x32）のテクスチャを、フォーマット RGBA8I（サイズ 32 ビット、クラス 4x8）の画像とともに使用することができます。OpenGL 仕様の表8.27 には、サポートされているすべての画像フォーマットのサイズとクラスが示されています。

デフォルトでは、Qt3Dは参照されるテクスチャのフォーマットと一致するように画像フォーマットを設定しようとします。

デフォルト値はShaderImage.Automaticです。

layer : int

ShaderImage に使用する参照テクスチャのどのレイヤーを指定します。layered が true に設定されている場合、または参照テクスチャのタイプがレイヤーと互換性がない場合、このプロパティは機能しません。

cubeMapLayer = layer / 6
cubeMapFace = layer - (cubeMapLayer * 6)

デフォルト値は 0 です。

layered : bool

*

true に設定した場合、参照されるテクスチャが 1 次元配列、2 次元配列、3 次元、キューブマップ、キューブマップ配列、または 2 次元マルチサンプル配列テクスチャである場合、レベル全体がすべてのレイヤーに対してバインドされます。false に設定した場合、layer プロパティで指定された単一のレイヤーのみがバインドされます。

デフォルト値は `false` です。

mipLevel : int

ShaderImage に対して、参照先のテクスチャのどのmipLevelを使用すべきかを指定します。

デフォルト値は 0 です。