SpotLight QML Type

シーン内のスポットライトを定義します。詳細...

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

プロパティ

• coneAngle : real
• constantFade : real
• innerConeAngle : real
• linearFade : real
• quadraticFade : real

詳細説明

スポットライトは、coneAngle プロパティで定義される円錐形状の範囲内で、一方向に向かって光を放射します。coneAngle に近づくにつれて、光の輝度は低下します。光の輝度が低下し始める角度は、innerConeAngle で定義されます。両方の角度は度単位で指定されます。

innerConeAngle の範囲内では、スポットライトの挙動はポイントライトと同様になります。 その範囲内では、光強度は二乗反比例の法則に従って減衰します。ただし、減衰（および範囲）は、constantFade 、linearFade 、およびquadraticFade プロパティで制御できます。光の減衰は、次の式を使用して計算されます。constantFade +distance * (linearFade * 0.01) +distance * (quadraticFade * 0.0001)^2

簡単な例を見てみましょう。ここでは、スポットライトがZ軸の300の位置、つまりカメラとシーンの中心の中間点に配置されています。デフォルトでは、光はZ軸の方向に放射されています。brightness を10に増やすことで、より典型的なスポットライトのように見えるようにします。

import QtQuick
import QtQuick3D
View3D {
    anchors.fill: parent

    PerspectiveCamera { z: 600 }

    SpotLight {
        z: 300
        brightness: 10
        ambientColor: Qt.rgba(0.1, 0.1, 0.1, 1.0)
    }

    Model {
        source: "#Rectangle"
        scale: Qt.vector3d(10, 10, 10)
        z: -100
        materials: PrincipledMaterial { }
    }

    Model {
        source: "#Sphere"
        scale: Qt.vector3d(2, 2, 2)
        materials: PrincipledMaterial {
            baseColor: "#40c060"
            roughness: 0.1
        }
    }
}

回転の設定はDirectionalLight と同様です。ここでは、光をより右側に向けて照射したいので、Y軸を中心に-20度回転させます。また、coneAngle をデフォルトの40から30に設定することで、光の円錐範囲を狭めます。さらに、innerConeAngle を10に変更することで、光の強度がより早く減衰し始めるようにします。

SpotLight {
    z: 300
    brightness: 10
    ambientColor: Qt.rgba(0.1, 0.1, 0.1, 1.0)
    eulerRotation.y: -20
    coneAngle: 30
    innerConeAngle: 10
}

その他の使用例については、「Qt Quick 3D - Lights Example」を参照してください。

DirectionalLight 、PointLight 、およびShadow Mappingも参照してください 。

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

coneAngle : real

このプロパティは、光がシーンに影響を与えなくなるカットオフ角（端から端まで）を定義します。0 から180 までの範囲で度単位で指定します。デフォルト値は40 です。

constantFade : real

このプロパティは、光の減衰項の定数倍です。デフォルト値は 1.0 です。

innerConeAngle : real

このプロパティは、光がconeAngle に近づくにつれて光強度が徐々に減衰し始める角度（端から端まで）を定義します。0から180度の範囲で指定します。値がconeAngle より大きく設定された場合、coneAngle と同じ値が設定された場合と同様に動作します。デフォルト値は30です。

linearFade : real

このプロパティは、光源までの距離に比例して照明効果が光を暗くする速度を高めます。デフォルト値は0.0 であり、これは光に線形なフェード効果がないことを意味します。ここで指定された値は、光の減衰を計算する前に0.01 で乗算されます。

quadraticFade : real

このプロパティは、照明効果が「逆二乗の法則」に従って光量を減衰させる速度を高めます。 デフォルト値は 1.0 です。これは、スポットライトの減光が正確に二乗反比例の法則に従うことを意味します。つまり、オブジェクトまでの距離が 2 倍になると、光の強度は 1/4 に減少します。ここで使用される値は、光の減衰を計算する前に、0.0001 で乗算されます。