Texture QML Type

3Dシーンで使用するテクスチャを定義します。詳細...

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

プロパティ

• autoOrientation : bool (since 6.2)
• flipU : bool
• flipV : bool
• generateMipmaps : bool
• indexUV : int
• magFilter : enumeration
• mappingMode : enumeration
• minFilter : enumeration
• mipFilter : enumeration
• pivotU : real
• pivotV : real
• positionU : real
• positionV : real
• rotationUV : real
• scaleU : real
• scaleV : real
• source : url
• sourceItem : Item
• textureData : TextureData
• textureProvider : RenderExtension (since 6.7)
• tilingModeDepth : enumeration
• tilingModeHorizontal : enumeration
• tilingModeVertical : enumeration

詳細な説明

テクスチャとは、技術的にはピクセルの配列（1D、2D、または3D）および、縮小・拡大フィルター、スケーリング、UV変換などの関連設定の総称です。

Qt Quick 3DにおけるTexture型は、2次元画像を表します。通常、3次元ジオメトリにマッピングしたり、巻き付けたりして、3Dでは効率的にモデリングできない追加のディテールを再現するために使用されます。また、反射などの他の照明効果を再現するためにも使用できます。

Texture 自体は常に 2D テクスチャを表しますが、Texture のサブクラスを通じて他の種類のテクスチャも利用可能です。たとえば、6 面のキューブマップテクスチャを作成するには、CubeMapTexture 型を使用します。

ジオメトリがレンダリングされる際、メッシュの頂点に設定されたUV座標（テクスチャ座標）を変換および補間することで、表面上の各位置がテクスチャ内の対応する位置に変換されます。 その後、アクティブなマテリアルをレンダリングするために使用されるフラグメントシェーダープログラムは、通常、指定された座標でマテリアルのテクスチャをサンプリングし、そのサンプリングデータを光の計算に使用します。

テクスチャオブジェクトは、以下の場所から画像データを取得できます：

• source プロパティを使用して画像またはテクスチャファイルから、
• sourceItem プロパティを使用して、Qt Quick のItem を指定する、
• または、textureData プロパティをTextureData 項目のサブクラスに設定して、カスタムテクスチャの内容を定義する方法。

次の例では、画像「madewithqt.png」をデフォルトの球体メッシュにマッピングし、球体の表面に画像がタイル状に配置されるよう UV 座標をスケーリングしています。

Model {
    source: "#Sphere"
    materials: [ PrincipledMaterial {
            baseColorMap: Texture {
                source: "madewithqt.png"
                scaleU: 4.0
                scaleV: 4.0
            }
        }
    ]
}

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

「Qt Quick 3D - プロシージャルテクスチャの例」も参照してください 。

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

autoOrientation : bool [since 6.2]

このプロパティは、Vテクスチャ座標の反転など、テクスチャ変換が通常関連するテクスチャに対して、その変換が自動的に適用されるかどうかを決定します。

デフォルトでは、このプロパティは true に設定されています。

source プロパティを介して.ktxまたは.pkmファイルから読み込まれた圧縮テクスチャや、sourceItem プロパティを介してQt Quick シーンをレンダリングして生成されたテクスチャなど、特定の種類のテクスチャデータは、.pngや.jpgなどの画像ファイルから読み込まれたテクスチャと比較して、Y軸の向きが異なることがよくあります。 そのため、このようなテクスチャは、ソースが通常の画像ファイルに設定されているテクスチャと比較して「上下逆さま」に表示されます。これを修正するために、該当するテクスチャには、flipV プロパティがtrueに設定されているかのように、暗黙的なUV変換が適用されます。これを望まない場合は、このプロパティをfalseに設定してください。

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

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

flipU : bool

このプロパティは、水平反転したテクスチャ座標の使用を設定します。

デフォルトは false です。

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

flipV : bool

このプロパティは、垂直方向に反転したテクスチャ座標の使用を設定します。

デフォルト値は false です。

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

generateMipmaps : bool

このプロパティは、ミップマップレベルを自身で提供していないテクスチャに対して、ミップマップを生成するかどうかを決定します。ミップマップとミップフィルタリングを併用すると、それらを使用しない場合と比較して、遠距離からテクスチャを表示する際の画質が向上しますが、パフォーマンスの低下（画像の初期化時およびレンダリング中）を招く可能性があります。

デフォルトでは、このプロパティは false に設定されています。

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

indexUV : int

このプロパティは、このテクスチャで使用されるUV座標インデックスを設定します。QtQuick3D では現時点で2つのUVセット（0または1）のみをサポートしているため、この値は指定された範囲内に収められます。

デフォルト値は 0 です。

magFilter : enumeration

このプロパティは、テクスチャが「拡大」されたとき、つまりテクセルが画面空間上で複数のピクセルをカバーする場合に、テクスチャがどのようにサンプリングされるかを決定します。

デフォルト値はTexture.Linear です。

「 minFilter 」および「mipFilter 」も参照してください 。

mappingMode : enumeration

このプロパティは、このテクスチャをサンプリングする際に使用するマッピング方法を定義します。

minFilter : enumeration

このプロパティは、テクスチャが「最小化」された場合、つまりテクセルが画面空間で 1 ピクセル未満の領域をカバーする場合に、テクスチャがどのようにサンプリングされるかを決定します。

デフォルト値はTexture.Linear です。

「 magFilter 」および「mipFilter 」も参照してください 。

mipFilter : enumeration

このプロパティは、テクセルが1ピクセル未満の領域をカバーする場合に、テクスチャのミップマップがどのようにサンプリングされるかを決定します。

デフォルト値はTexture.None です。

関連項目: minFilter およびmagFilter 。

pivotU : real

このプロパティは、rotationUV を適用する際に使用されるピボットのU座標を設定します。

デフォルト値は 0.0 です。

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

pivotV : real

このプロパティは、rotationUV を適用する際に使用されるピボットのV位置を設定します。

デフォルト値は 0.0 です。

「 pivotU 」および「rotationUV 」も参照してください 。

positionU : real

このプロパティは、U座標のマッピングを左から右へオフセットします。

デフォルト値は 0.0 です。

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

positionV : real

このプロパティは、V座標のマッピングを「下」から「上」へとオフセットします。

デフォルト値は 0.0 です。

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

rotationUV : real

このプロパティは、ピボット点を軸としてテクスチャを回転させます。これはオイラー角を用いて定義され、正の値の場合、回転は時計回りになります。

デフォルト値は 0.0 です。

「 pivotU 」および「pivotV 」も参照してください 。

scaleU : real

このプロパティは、メッシュのUV座標にマッピングする際に、Uテクスチャ座標をどのようにスケーリングするかを定義します。

水平タイリングを使用する際に U 値をスケーリングすることで、テクスチャが左から右へ何回繰り返されるかが決まります。

デフォルト値は 1.0 です。

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

scaleV : real

このプロパティは、メッシュのUV座標にマッピングする際に、Vテクスチャ座標をどのようにスケーリングするかを定義します。

垂直タイリングを使用する際にV値をスケーリングすることで、テクスチャが下から上へ何回繰り返されるかが決まります。

デフォルト値は 1.0 です。

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

source : url

このプロパティには、テクスチャで使用されるデータを含む画像ファイルまたはテクスチャファイルの場所が格納されます。

このプロパティはURLであり、Image.source など、他のソースプロパティと同じ規則に従います。Textureでは、qrc およびfile のスキームのみがサポートされています。スキームが指定されておらず、値が相対パスである場合は、コンポーネント（つまり.qml ファイル）の場所を基準とする相対パスであるとみなされます。

ソースファイルは、supported by Qt に記載されているような、一般的な画像ファイル形式であればどれでも使用できます。さらに、Texture は QtQuick::Image と同じcompressed texture file types をサポートしています。

関連項目： sourceItem 、textureData 、autoOrientation 、およびflipV 。

sourceItem : Item

このプロパティは、テクスチャのソースとして使用するアイテムを定義します。このプロパティを使用すると、任意の 2DQt Quick コンテンツをオフスクリーンレイヤーとしてレンダリングすることで、テクスチャソースとして利用できるようになります。

アイテムがtexture provider である場合、追加のテクスチャは使用されません。

このプロパティが設定されている場合、source の値は無視されます。テクスチャは、画像データを提供するために 1 つのメソッドを使用し、source、sourceItem、textureData のうち 1 つだけを設定する必要があります。

関連項目 ：source 、textureData 、およびautoOrientationも参照してください 。

textureData : TextureData

このプロパティは、生のテクスチャデータのコンテンツとプロパティを定義するTextureData コンポーネントへの参照を保持します。

このプロパティが使用された場合、source の値は無視されます。Textureは、画像データを提供するために1つのメソッドを使用し、source、sourceItem 、またはtextureDataのうち1つだけを設定する必要があります。

「 source 」、「sourceItem 」、および「Qt Quick 3D - プロシージャルテクスチャの例」も参照してください 。

textureProvider : RenderExtension [since 6.7]

このプロパティには、このアイテムで使用されるQRhiTexture を提供するRenderExtension が格納されます。

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

関連項目： TextureProviderExtension 、RenderExtension 、およびQSSGRenderExtensionHelpers 。

tilingModeDepth : enumeration

このプロパティは、Zスケーリングの値が1より大きい場合に、テクスチャがどのようにマッピングされるかを制御します。

デフォルトでは、このプロパティはTexture.Repeat に設定されています。

tilingModeHorizontal : enumeration

Uスケーリング値が1より大きい場合に、テクスチャがどのようにマッピングされるかを制御します。

デフォルトでは、このプロパティはTexture.Repeat に設定されています。

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

tilingModeVertical : enumeration

このプロパティは、Vスケーリングの値が1より大きい場合に、テクスチャがどのようにマッピングされるかを制御します。

デフォルトでは、このプロパティはTexture.Repeat に設定されています。

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