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

간단한 예를 살펴보겠습니다. 여기서는 스포트라이트(SpotLight)가 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이며, 이는 스포트라이트의 밝기 감소가 정확히 역제곱 법칙을 따름을 의미합니다. 즉, 물체까지의 거리가 두 배가 되면 광도는 1/4로 감소합니다. 여기서 사용된 값은 빛의 감쇠를 계산하기 전에 0.0001 와 곱해집니다.