PrincipledMaterial QML Type

alphaCutoff プロパティは、Mask alphaMode を使用する際のカットオフ値を指定するために使用できます。 アルファ値がしきい値を下回るフラグメントは、完全に透明にレンダリングされます ( すべてのカラーチャンネルに対して0.0 )。アルファ値がカットオフ値と等しいか大きい場合、色は何ら影響を受けません。

デフォルト値は 0.5 です。

alphaModeも参照 。

このプロパティは、baseColor からのアルファカラー値とbase color map のアルファチャンネルがどのように使われるかを指定します。

alphaCutoff およびblendModeも参照してください 。

このプロパティは、白色光が減衰距離に達したときに吸収されて変色する色を定義します。デフォルト値はQt.White

このプロパティは、光が粒子と相互作用する前に媒質中を進む平均距離として与えられる媒質の密度を定義します。値はワールド空間で指定します。デフォルト値は+infinity です。

このプロパティはマテリアルのベースカラーを設定します。指定されたマテリアルのタイプ（金属または誘電体）に応じて、ディフューズチャンネルとスペキュラチャンネルが適切に設定されます。例えば、誘電体材料の場合、拡散色はベース色と同じになり、スペキュラ色はスペキュラ量に応じて明るいスペキュラ色になります。金属の場合、ディフューズ・チャンネルとスペキュラー・チャンネルはベース・カラーから混合され、ベース・カラーに近い暗いディフューズ・チャンネルとスペキュラー・チャンネルになります。

baseColorMap およびalphaModeも参照してください 。

このプロパティは、baseColorMap からbaseColor の値を読み取るために使用されるテクスチャチャンネルを定義します。単一のテクスチャチャンネルを色として使用するには、baseColorSingleChannelEnabled を有効にする必要があります。デフォルト値はMaterial.R です。

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

このプロパティは、マテリアルのベースカラーを設定するために使用されるテクスチャを定義します。

baseColor およびalphaModeも参照してください 。

このプロパティを有効にすると、マテリアルはbaseColorMap からbaseColorChannel の単一の値を RGB 値として使用し、1.0 をアルファ値として使用します。デフォルト値は false です。

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

このプロパティは、レンダリングされたモデルの色が、背後のモデルとどのようにブレンドするかを決定します。

alphaMode およびQt Quick 3D Architectureも参照してください 。

このプロパティは、クリアコートレイヤーの強度を定義します。

デフォルト値は0.0

このプロパティは、clearcoatMap からクリアコート量の値を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.R です。

このプロパティは、かすめた角度で見られる反射を維持しながら、正面からの反射（表面を直接見ている）を前方に押し出します。マテリアルの変更に影響を与えるには、clearcoatFresnelScaleBiasEnabled を有効にする必要があります。デフォルト値は0.0 です。

このプロパティは、かすみ角で見られる反射を維持しながら、正面からの反射（表面を直接見る）を減少させます。デフォルト値は5.0 です。

このプロパティは、かすめた角度で見られる反射を維持しながら、（表面を直接見て）正面からの反射をスケールします。マテリアルの変更に影響を与えるには、clearcoatFresnelScaleBiasEnabled を有効にする必要があります。デフォルト値は1.0 です。

この値をtrueに設定すると、マテリアルはクリアコートフレネルスケールとクリアコートフレネルバイアスを考慮します。デフォルト値はfalse です。

このプロパティは、クリアコート層の強度を決定するために使用されるテクスチャを定義します。clearcoatAmount の値は、このテクスチャから読み取った値で乗算されます。

このプロパティは、クリアコートレイヤーに適用される法線マッピングを決定するために使用されるテクスチャを定義します。

このプロパティは、clearcoatNormalMap のシミュレートされた変位量を制御します。

このプロパティは、クリアコート層の粗さを定義します。デフォルト値は0.0

このプロパティは、clearcoatRoughnessMap からクリアコートの粗さ量を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.G です。

このプロパティは、クリアコート層の粗さを決定するために使用されるテクスチャを定義します。clearcoatRoughnessAmount の値には、このテクスチャから読み取った値が乗算される。

このプロパティは、emissiveMap から放射値を読み取るために使用されるテクスチャチャンネルを定義します。単一のテクスチャチャンネルを色として使用するには、emissiveSingleChannelEnabled を有効にする必要があります。デフォルト値はMaterial.R です。

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

このプロパティは、このマテリアルの自己発光の色を決定します。エミッシブマップが設定されている場合、x、y、z成分はそれぞれテクスチャのR、G、Bチャンネルの係数（乗数）として使用されます。デフォルト値は (0, 0, 0) で、エミッシブの寄与がまったくないことを意味します。

このプロパティは、放射色の強度を指定するために使用する RGB Texture を設定します。

このプロパティを有効にすると、マテリアルはemissiveMap からemissiveChannel の単一の値を RGB 値として使用します。デフォルト値は false です。

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

このプロパティは、かすめるような角度で見た反射を維持しながら、正面からの反射（表面を直接見ている）を前方に押し出します。マテリアルの変更に影響を与えるには、fresnelScaleBiasEnabled を有効にする必要があります。デフォルト値は0.0 です。

このプロパティは、かすみ角で見られる反射を維持しながら、正面からの反射（表面を直接見る）を減少させます。デフォルト値は5.0 です。

このプロパティは、かすめた角度で見られる反射を維持しながら、（表面を直接見て）正面からの反射をスケールします。マテリアルの変更に影響を与えるには、fresnelScaleBiasEnabled を有効にする必要があります。デフォルト値は1.0 です。

この値をtrueに設定すると、マテリアルはフレネルスケールとフレネルバイアスを考慮します。デフォルト値はfalse です。

このプロパティには、heightMap テクスチャから値を修正するために使用される係数が含まれます。値は0.0から1.0の間でなければなりません。デフォルト値は0.0で、ハイトマップが設定されていても、高さ変位が無効になることを意味します。

このプロパティは、heightMap から高さ値を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.R です。

このプロパティは、視差マッピングを使用してレンダリングするときにテクスチャが変位する高さを決定するために使用されるテクスチャを定義します。値は0.0から1.0までの線形であることが期待され、0.0は変位なしを意味し、1.0は最大変位を意味する。

このプロパティはマテリアルの屈折率を定義します。デフォルト値の1.5 は、プラスチックやガラスのようなマテリアルには理想的な値ですが、水、アスファルト、サファイア、ダイヤモンドのような他のマテリアルでは、よりリアルに見えるように値を調整する必要があります。現実的な材料の場合、屈折率は通常1.0 と の間であるべきです。3.0

一般的な材料の屈折率の例をいくつか挙げます：

このプロパティは、opacityMap の不透明度の値を反転します。 デフォルト値はfalse です。

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

このプロパティは、このマテリアルを生成する際に使用するライティング方法を定義します。

デフォルト値はPrincipledMaterial.FragmentLighting

PrincipledMaterial.FragmentLighting を使用する場合、拡散照明と鏡面照明が各レンダリングピクセルに対して計算されます。特定のエフェクト（フレネルマップや法線マップなど）を動作させるにはPrincipledMaterial.FragmentLighting が必要です。

PrincipledMaterial.NoLighting を使用する場合、ライティングは計算されません。このモードは（予想通り）非常に高速で、ライティングでシェーディングする必要のないイメージマップを使用する場合に非常に効果的です。baseColor 値、アルファ値、頂点カラー以外のシェーディングプロパティはすべて無視されます。

このプロパティは、ジオメトリがプリミティブタイプのラインまたはラインストリップを使用している場合に、レンダリングされるラインの幅を決定します。デフォルト値は 1.0 です。このプロパティは、三角形メッシュなど、他のタイプのジオメトリをレンダリングするときには関係ありません。

このプロパティは、heightMap を使用して Parallex Occlusion Mapping を実行するために使用されるサンプルの最大数を定義します。 maxHeightMapSamples 値は、サーフェスに平行に見るときに使用されるheightMap のサンプル数です。デフォルト値は 32 です。

各フラグメントに使用される実際のサンプル数は、レンダリングされるサーフェスに対するカメラの角度に応じて、minHeightMapSamples と maxHeightMapSamples の間になります。

メタルネス プロパティは、マテリアルのメタルネスを定義します。この値は正規化され、0.0はマテリアルが誘電体（非金属）であることを意味し、1.0はマテリアルが金属であることを意味します。

範囲は[0.0, 1.0]です。デフォルト値は 0 です。

このプロパティは、metalnessMap からメタルネス値を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.B です。

このプロパティは、マテリアルの異なる部分のメタルネス量を設定するために使用するテクスチャを設定します。

このプロパティは、heightMap を使用して Parallex Occlusion Mapping を実行するために使用されるサンプルの最小数を定義します。 minHeightMapSamples 値は、サーフェスを直接見るとき（カメラビューがフラグメントに垂直なとき）に使用されるheightMap のサンプル数です。デフォルト値は8です。

各フラグメントに使用される実際のサンプル数は、レンダリングされるサーフェスに対するカメラの角度に応じて minHeightMapSamples とmaxHeightMapSamples の間になります。

このプロパティは、マテリアルのサーフェスを横切る微細なジオメトリ変位をシミュレートするために使用される RGB イメージを定義します。RGBチャンネルはXYZ法線のずれを示します。

このプロパティは、normalMap のシミュレーションされた変位量を制御します。

このプロパティには、occlusionMap テクスチャの値を変更するために使用される係数が含まれます。値は 0.0 から 1.0 の間でなければなりません。デフォルトは 1.0 です。

このプロパティは、occlusionMap からオクルージョン値を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.R です。

このプロパティは、マテリアルのさまざまな領域が受光する光量を決定するために使用されるテクスチャを定義します。値は0.0から1.0までの線形になることが期待され、0.0はライティングなしを意味し、1.0はライティングの効果が変更されないままであることを意味します。

occlusionAmountも参照してください 。

このプロパティは、モデルとは別に、このマテリアルだけの不透明度を落とします。

このプロパティは、opacityMap から不透明度の値を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.A です。

このプロパティは、マテリアルの異なる部分に対して異なる不透明度を制御するために使用されるテクスチャを定義します。

このプロパティは、ジオメトリがプリミティブタイプのポイントを使用している場合に、レンダリングされるポイントのサイズを決定します。デフォルト値は 1.0 です。このプロパティは、三角形メッシュなど、他のタイプのジオメトリをレンダリングするときには関係ありません。

このプロパティは、ライトから生成されるスペキュラハイライトのサイズと、一般的な反射の透明度を制御します。値を大きくすると粗さが増し、スペキュラハイライトが柔らかくなり、反射がぼやけます。範囲は [0.0, 1.0] です。デフォルト値は 0 です。

このプロパティは、roughnessMap から粗さの値を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.G です。

このプロパティは、マテリアルの鏡面粗さを制御するためのテクスチャを定義します。

このプロパティは、スペキュラリティ（ハイライトと反射）の強さを制御します。

範囲は [0.0, 1.0] です。デフォルト値は1.0 です。

このプロパティは、specularMap からスペキュラカラー値を読み取るために使用されるテクスチャチャンネルを定義します。単一のテクスチャチャンネルをカラーとして使用するには、specularSingleChannelEnabled を有効にする必要があります。デフォルト値はMaterial.R です。

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

このプロパティは、RGB のテクスチャを定義し、マテリアルの表面全体のスペキュラの量と色を調整します。これらの値は、specularAmount で乗算されます。

このプロパティは、マテリアルのスペキュラハイライトに使用する Texture を設定します。

これは通常、環境マッピングを行うために使用されます。モデルが回転すると、マップは環境から反射しているように見えます。これが期待通りに動作するには、TextureのmappingMode 、Texture.Environmentに設定する必要があります。スペキュラ反射マップは、比較的低コストで高品質の外観を追加する簡単な方法です。

Texture::mappingModeも参照して ください。

このプロパティを有効にすると、マテリアルはspecularMap からspecularChannel の単一の値を RGB 値として使用します。デフォルト値は false です。

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

このプロパティは、ベースカラーが鏡面反射にどれだけ寄与するかを定義します。

このプロパティは、transmissionMap から厚み量を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.G です。

このプロパティは、サーフェスの下のボリュームの厚さを定義します。PrincipledMaterial の他の多くのプロパティとは異なり、 thicknessFactor で定義される値は、モデル座標空間での厚さを表す 0.0 から +infinity までの値です。値 0.0 は、 その材料が薄肉であることを意味します。デフォルト値は0.0

このプロパティは、マテリアルボリュームの厚さを定義するために使用されるテクスチャを定義します。thicknessFactor の値には、このテクスチャから読み取った値が乗算されます。

このプロパティは、transmissionMap から透過率を読み取るために使用されるテクスチャチャンネルを定義します。 デフォルト値はMaterial.R です。

このプロパティは、マテリアルの表面を透過する光の割合を定義します。デフォルト値は0.0

このプロパティは、表面を透過する光の割合を決定するために使用されるテクスチャを定義します。transmissionFactor の値には、このテクスチャから読み取った値が乗算されます。

このプロパティは、指定マスクとして使用される頂点カラーアルファチャンネルを定義します。値はフラグのビット単位の組み合わせです。デフォルト値はPrincipledMaterial.NoMask です。

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

このプロパティは、指定マスクとして使用される頂点色の青チャンネルを定義します。値はフラグのビット単位の組み合わせです。デフォルト値はPrincipledMaterial.NoMask です。

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

このプロパティは、指定マスクとして使用される頂点カラー緑チャンネルを定義します。値はフラグのビット単位の組み合わせです。デフォルト値はPrincipledMaterial.NoMask です。

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

このプロパティは、指定マスクとして使用される頂点カラー赤チャンネルを定義します。値はフラグのビット単位の組み合わせです。デフォルト値はPrincipledMaterial.NoMask です。

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

このプロパティを有効にすると、マテリアルはメッシュの頂点カラーを使用します。これらはマテリアルに指定された他の色と乗算されます。デフォルト値はtrueです。

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

このプロパティが有効な場合、マテリアルはメッシュの頂点カラーをRoughnessAmount、SpecularAmountなどの様々なプロパティのマスクとして使用します。デフォルト値は false です。

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