SceneEnvironment QML Type

このプロパティは、シーンのレンダリング時に適用されるアンチエイリアス モードを制御します。

設定可能な値は次のとおりです：

デフォルト値はSceneEnvironment.NoAA です。

スーパーサンプリング

シーンは高い解像度でレンダリングされ、実際の解像度にスケールダウンされます。

長所：高品質。ジオメトリのシルエットだけでなく、すべてのシーンコンテンツをアンチエイリアスする。

短所：通常、MSAAより高価。ビデオメモリ使用量が増える。Inline を除くすべての renderMode でView3D アイテムでサポートされていますが、この技法は最初にテクスチャにレンダリングすることを意味するため、Underlay または Overlay の renderMode で SSAA を有効にすると、通常は必要ない中間テクスチャとレンダー パスが使用されることになり、パフォーマンス コストが顕著になる可能性があります。レンダーモードがデフォルトの Offscreen の場合のみ、SSAA を使用することをお勧めします。

マルチサンプリング

ジオメトリのエッジがスーパーサンプリングされ、より滑らかなシルエットになります。ただし、このテクニックはジオメトリ内部のマテリアルには影響しません。

長所レンダリングモードに関係なく、View3D アイテムで動作します。エイリアシングが最も目立つジオメトリシルエッ トで良い結果が得られます。パフォーマンスは、純粋にシステム（GPU）の能力に依存します。

短所：テクスチャや反射の問題には役立たない。ビデオメモリ使用量が増える。性能の低いグラフィックハードウェアで使用するには高価になる可能性がある。renderModeに応じて、ウィンドウごと、または個々のView3D アイテムごとに制御できます。エフェクトが適用されたUnderlay/OverlayまたはOffscreenを使用する場合、MSAAはView3D アイテムごとに制御できます。一方、エフェクトなしのUnderlay/OverlayまたはInlineを使用すると、MSAAはウィンドウごとに制御されます。

プログレッシブ・アンチエイリアス

このプロパティは、シーンに適用されるプログレッシブ・アンチエイリアスのレベルを有効化し、設定します。

シーンのすべてのコンテンツが動きを止めたとき、カメラはフレーム間でごくわずかに揺れ、それぞれの新しいフレームの結果が前のフレームとブレンドされます。フレームを積み重ねるほど、結果は見栄えが良くなる。

長所シーン内のすべてのコンテンツが静止している場合に素晴らしい結果をもたらす。

短所：視覚的な変化が起きている場合は効果がない。蓄積とブレンドが必要なため、コストがかかる。ビデオメモリ使用量が増える。

アンチエイリアシングの方法については、アンチエイリアシングのベストプラクティスを参照してください。

このプロパティは、シーンに適用されるアンチエイリアスのレベルを設定します。動作は使用するantialiasingMode に依存します。antialiasingMode プロパティがNoAA に設定されている場合、このプロパティは影響しません。

可能な値は次のとおりです：

デフォルト値はSceneEnvironment.High

このプロパティは、オブジェクトが近距離でアンビエントオクルージョンを示すのを防ぐカットオフ距離を定義します。値が高いほど、アンビエントオクルージョンが見られるまでに必要なオブジェクト間の距離が長くなります。

デフォルト値は0.0です。

このプロパティは、アンビエントオクルージョンの影がオブジェクトからどの程度遠くまで広がるかを定義します。距離が離れるほど、パフォーマンスへの影響が大きくなります。

デフォルト値は5.0です。

写真はデフォルトのaoSoftness と最大のaoStrength ：

aoStrength およびaoSoftnessも参照して ください。

このプロパティを有効にすると、アンビエントオクルージョンのシャドウバンドのエッジを散乱させ、滑らかさを向上させます（時々、明らかなパターン化されたアーティファクトが発生する危険性があります）。

デフォルト値はfalse です。

PerspectiveCamera.clipFar およびOrthographicCamera.clipFarも参照してください 。

アンビエントオクルージョンを有効または無効にします。

デフォルト値はfalse で、これはアンビエント・オクルージョンが無効であることを意味します。

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

aoStrength とaoDistanceも参照して ください。

このプロパティは、パフォーマンスを犠牲にして、アンビエントオクルージョンの品質（より多くのグレーのシェード）を定義します。

値は2、3、または4でなければなりません。デフォルト値は 2 です。

このプロパティは、アンビエントオクルージョンのシェーディングのエッジの滑らかさを定義します。

値は0.0から50.0の間でなければなりません。デフォルト値は50.0です。

写真はデフォルトのaoDistance と最大のaoStrength ：

aoStrength およびaoDistanceも参照して ください。

このプロパティは、アンビエントオクルージョンの適用量を定義します。アンビエントオクルージョンとは、近似グローバルイルミネーションの一種で、オブジェクトが近くにある場合に、無指向性のセルフシャドウを引き起こします。値を100にすると完全な暗闇の影になり、値を下げると影が薄く見えます。値を0にするとアンビエントオクルージョンを完全に無効にし、シーンにレンダリングされる3Dオブジェクトの視覚的リアリズムを犠牲にする代わりにパフォーマンスを向上させます。

0以外の値は、パフォーマンスに同じ影響を与えます。

デフォルト値は0.0です。最大値は 100.0 です。

値 0 は、aoEnabled を false に設定するのと同じです。

写真はデフォルトのaoSoftness とaoDistance ：

aoEnabled,aoDistance,aoSoftnessも参照して ください。

このプロパティは、シーンの背景をクリアするかどうか、またどのようにクリアするかを制御します。

デフォルト値はSceneEnvironment.Transparent

次の例を見てください。Suzanneモデルはbalsam ツールでプリプロセスされ、glTF Sample Modelsリポジトリから取得されます。

import QtQuick
import QtQuick3D
import QtQuick3D.Helpers

Item {
    width: 1280
    height: 720

    View3D {
        id: v3d
        anchors.fill: parent

        environment: ExtendedSceneEnvironment {
            backgroundMode: SceneEnvironment.SkyBox
            lightProbe: Texture { source: "00455_OpenfootageNET_field_low.hdr" }

            glowEnabled: true
            glowStrength: 1.25
            glowBloom: 0.25
            glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
        }

        DirectionalLight {
        }

        Suzanne {
            scale: Qt.vector3d(50, 50, 50)
            z: -500
        }

        PerspectiveCamera {
            id: camera
        }

        WasdController {
            controlledObject: camera
        }
    }
}

DirectionalLight に加えてイメージベースのライティングを使用し、ライトプローブテクスチャをスカイボックスとして使用すると、次のようになります：

ライトプローブがない場合はどうなりますか？

backgroundMode: SceneEnvironment.Transparent

ここでは、背景はView3D ではなく、2D および 3D シーンをホストするQQuickWindow またはQQuickView によって提供されます。照明はDirectionalLight のみに基づいています。

固定のクリアカラーを使用：

backgroundMode: SceneEnvironment.Color
clearColor: "green"

lightProbe,QQuickWindow::setColor(),Window::color,View3Dも参照してください 。

このプロパティは、backgroundMode プロパティにSceneEnvironment.Color を使用する場合に、ビューポートをクリアするために使用される色を定義します。

デフォルト値はQt::black

backgroundModeも参照。

このプロパティは、レンダラーのデバッグ ツールを設定するために使用されるDebugSettings オブジェクトを指定します。構築中、SceneEnvironment はそれ自体に関連付けられたDebugSettings オブジェクトを自動的に作成するため、カスタムDebugSettings を設定する必要は通常ありません。

ワイヤフレームモードを有効にしてシーンをレンダリングした例：

メッシュの法線ベクトルの可視化：

鏡面照明の寄与を視覚化する：

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

DebugSettingsも参照してください 。

つまり、メインのレンダリングパスの描画コールを発行する前に、深度バッファを事前に満たすために、単純なシェーダと色の書き込みを無効にしてレンダリングします。

これにより、シーンの内容によってはパフォーマンスが向上します。一般的に、多くのオブジェクトが重なり、高価なフラグメントシェーディングがあるシーンで、このメリットがあります。同時に、レンダラーが不透明オブジェクトの前面から背面へのソート を実行し、それ自体が不要なフラグメントシェーディングを減らすのに役立 つので、Z-prepass が常に大きな改善をもたらすわけではないことは注 目しておく価値があります。

モバイルや組み込みシステムで一般的なタイル型レンダリングアーキ テクチャを使用する GPU では、これをfalse に設定すること を推奨します。

デフォルト値はfalse です。

デフォルト値はtrue です。デフォルトでは、レンダラーはシーン内のオブジェクトをopaque またはsemi-transparent として分類します。opaque リストのオブジェクト（関連するマテリアルを持つサブメッシュ）は、深度テストと深度書き込みを有効にして最初にレンダリングされ、半透明領域を持たない典型的な 3D オブジェクトに最適な Z カリングを提供します。semi-transparent リストのオブジェクトは、奥行き書き込みを無効にしてレンダリングされますが、奥行きテストは有効のまま（不透明なオブジェクトに対してテストするため）、奥から手前の順番で（カメラからの中心点の距離に基づいてソートされます）レンダリングされます。これにより、node opacity 、またはマテリアルのカラーマップやテクスチャマップによって、表面に半透明の領域がある3Dオブジェクトを正しくブレンド（「シースルー」）することができます。

このプロパティをfalse に設定すると、Z バッファの書き込みとテストは行われず、深度テストはスキップされ、完全に不透明なオブジェクトを含むすべてのオブジェクトが一度にレンダリングされ、背面から前面にソートされます。

このプロパティをfalse に設定することは、ほとんど必要ないはずです。このプロパティは、不透明なオブジェクトが非常に少ないか、前から後ろへソートされたパスが1回で済むように変形されているため、2ラウンドのアプローチではほとんどメリットがないことがわかっているシーンで役立ちます。

このプロパティには、ビューポート全体に適用されるポスト処理エフェクトのリストが含まれます。各エフェクトの結果は次のエフェクトに送られるので、順序は重要です。

このプロパティが有効なFog オブジェクトに設定されている場合、レンダラー内蔵のフォグ サポートを設定するために使用されます。

デフォルト値は null で、これはフォグがないことを意味します。これは、enabled が false に設定された Fog オブジェクトを設定することと同じです。

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

Fogも参照してください 。

このプロパティは、標準的なライトの代わりに、または標準的なライトに加えて、シーンを照らすために使用されるイメージを定義します。

この画像は、ハイダイナミックレンジ画像か、事前に生成されたキューブマップであることが望ましいです。プリベイクすることで、フィルタリングやミップマップ生成に時間がかからないため、実行時のパフォーマンスが大幅に向上します。ソースが.hdrやその他の画像の場合、GPUベースの前処理は画像ファイルを読み込んだ後の実行時に行われるため、特に組み込み機器やモバイルハードウェアでは時間がかかる可能性があります。そのため、.hdr 画像の前処理は、遅くともビルド時に行うことを強く推奨します。

イメージベースのライティングの詳細については、「イメージベースのライティングを使用する」を参照してください。

以下の例は、以下のシーンの環境でbackgroundMode を変えて生成したものです。このシーンには、DirectionLight、PointLight 、SpotLight がありません。すべてのライティングは、パノラマ HDRI イメージに基づいています。

import QtQuick
import QtQuick3D
import QtQuick3D.Helpers

Item {
    width: 1280
    height: 720

    View3D {
        id: v3d
        anchors.fill: parent

        environment: ExtendedSceneEnvironment {
            backgroundMode: SceneEnvironment.SkyBox
            lightProbe: Texture { source: "00455_OpenfootageNET_field_low.hdr" }

            tonemapMode: SceneEnvironment.TonemapModeFilmic
            sharpnessAmount: 0.4

            glowEnabled: true
            glowStrength: 1.25
            glowBloom: 0.25
            glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
        }

        Node {
            scale: Qt.vector3d(100, 100, 100)

            Sponza {
            }

            Suzanne {
                y: 1
                scale: Qt.vector3d(0.5, 0.5, 0.5)
                eulerRotation.y: -90
            }
        }

        PerspectiveCamera {
            id: camera
            y: 100
        }

        WasdController {
            controlledObject: camera
        }
    }
}

上記の環境での結果：

backgroundMode をSceneEnvironment.Transparent に切り替えると、次のようになります：

ここでは、3Dシーンのライティングは前と同じです。つまり、マテリアルは前と同じようにライティング計算でライトプローブを使用しますが、スカイボックスはレンダリングされません。背景は白です。これは、2Dと3DシーンをホストするQQuickWindow のデフォルトのクリアカラーだからです。

lightProbeプロパティの値をデフォルトのnullに戻すことは有効です。これにより、以前関連付けられていたテクスチャの割り当てが解除されます。例えば、Deleteキーを使って、スカイボックスを使ったイメージベースのライティングと、背景のクリアカラーを固定したイメージベースのライティングなしを動的に切り替えてみましょう：

environment: ExtendedSceneEnvironment {
    id: env

    backgroundMode: SceneEnvironment.SkyBox
    lightProbe: iblTex

    tonemapMode: SceneEnvironment.TonemapModeFilmic
    sharpnessAmount: 0.4

    glowEnabled: true
    glowStrength: 1.25
    glowBloom: 0.25
    glowBlendMode: ExtendedSceneEnvironment.GlowBlendMode.Additive
}

Texture {
    id: iblTex
    source: "00455_OpenfootageNET_field_low.hdr"
}

focus: true
Keys.onDeletePressed: {
    if (env.backgroundMode == SceneEnvironment.SkyBox) {
        env.backgroundMode = SceneEnvironment.Color;
        env.clearColor = "green";
        env.lightProbe = null;
    } else {
        env.backgroundMode = SceneEnvironment.SkyBox;
        env.lightProbe = iblTex;
    }
}

Deleteキーを押すと、次のようになります。Deleteキーを押すと、次のような結果になります。ここで使用したシーンにはライトがないため、すべての3Dモデルが真っ黒に見えることを覚えておいてください。

lightProbeは、イメージファイル（一般的に.hdrや.ktx）からデータを取得するTextureインスタンスと組み合わせて使用するのが一般的ですが、インメモリ（procedurally generated image data ）を使用するTextureと関連付けるのも理にかなっています。この典型的な例は、画像データがQtQuick3D.Helpers モジュールからProceduralSkyTextureData によって生成される Texture です：

backgroundMode: SceneEnvironment.SkyBox
lightProbe: Texture {
    textureData: ProceduralSkyTextureData {
    }
}

これにより、プロシージャル生成されたHDRスカイボックステクスチャが得られ、スカイボックスとしても、画像ベースのライティングにも使用できるようになりました：

backgroundMode 、Using Image-Based Lighting、Pre-generating IBL cubemap、probeExposure 、probeHorizon 、probeOrientation 、ProceduralSkyTextureDataも参照してください 。

このプロパティが有効な Lightmapper オブジェクトに設定されている場合、ライトマップをベイクする際に、そのオブジェクトで指定された設定が考慮されます。

デフォルト値はNULLで、これはすべてのベイク関連設定にデフォルト値を使用することを意味します。

ライトマップをベイクする方法の詳細については、Lightmapper ドキュメントを参照してください。

ライトマップがアプリケーションに関係なく、ベイクされたライティングが生成されない場合、このプロパティと関連オブジェクトは実際には何の役にも立ちません。

Model::usedInBakedLighting,Model::bakedLightmap,Light::bakeMode,Lightmapperも参照して ください。

このプロパティは、ライトプローブが発する光の量を変更します。トーンマッピングの一部は露出マッピングであり、このプロパティは、ライトプローブの光の値がどのようにトーンマッピングされるかを調整します。

デフォルトでは、露出は1.0に設定されています。

lightProbe,probeHorizon,probeOrientationも参照してください 。

このプロパティは、値を大きくして定義すると、環境の下半分に暗さ（黒）を追加し、照明が主に画像の上部から来るようにします（そして、下半分からの特定の反射を取り除きます）。このプロパティは、地面からのライトプローブの反射を不明瞭にする効果を持つグランドプレーンを考慮するのに便利です。これは、ライトプローブの寄与が、シーンの内容を考慮することなく画像から直接来るために必要である。

probeHorizonプロパティの期待値範囲は0.0～1.0です。この範囲外の値は、期待される範囲にクランプされます。

デフォルトでは、probeHorizonは0.0に設定されており、これはライトプローブ全体が調整なしで使用されることを意味します。

lightProbe,probeExposure,probeOrientationも参照してください 。

このプロパティは、ライトプローブの向きを定義します。向きは、x、y、z 軸のオイラー角（度）で定義されます。

lightProbe 、probeHorizon 、probeExposureも参照してください 。

このプロパティは、左上隅を [0, 0] とするシザー矩形をビュー座標で定義します。

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

このプロパティは、背景モードがSkyBoxCubeMap の時にスカイボックスとして使用されるキューブマップを定義します。

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

このプロパティは、backgroundMode プロパティにSceneEnvironment.SkyBox を使用する場合に、スカイボックスをどの程度ぼかすかを決定します。デフォルト値は0.0 で、これはぼかしがないことを意味します。

使用可能な値の範囲は 0.0 から 1.0 で、その他の値はすべてこの範囲にクランプされます。

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

このプロパティを有効にすると、スペキュラエイリアシングが緩和されます。スペキュラエイリアシングは、明るいドットの形で見えることが多く、カメラを動かしたときにちらつくことがあります。

デフォルト値はfalseです。

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

このプロパティを有効にすると、一時的なアンチエイリアシングが使用されます。

カメラはフレーム間でわずかに揺れ、それぞれの新しいフレームの結果は前のフレームとブレンドされます。

長所：長所：カメラが揺れ動くため、他の方法では失われる本当のディテールが見つかる。

短所：動きの速いオブジェクトはワンフレームのゴーストを引き起こす。

このプロパティは、時間的な動き（アンチエイリアス）の量を変更します。これは、temporalAAEnabled プロパティがtrueの場合にのみ効果があります。

temporalAAEnabledも参照してください 。

このプロパティは、レンダリング前の色のトーンマップ方法を定義します。Qt Quick 3D のレンダリングはすべて線形色空間で行われるため、多くの場合、表示不可能な色値が生成されます。tonemapMode は、表示可能な範囲に色を再マッピングするために使用される手法を決定します。

デフォルト値はSceneEnvironment.TonemapModeLinear

これらの異なるモードの例については、ExtendedSceneEnvironment を参照してください。

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