DirectionalLight QML Type

Define una luz direccional en la escena. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• csmBlendRatio : real (since 6.8)
• csmNumSplits : int (since 6.8)
• csmSplit1 : real (since 6.8)
• csmSplit2 : real (since 6.8)
• csmSplit3 : real (since 6.8)
• lockShadowmapTexels : bool (since 6.9)

Descripción detallada

La luz direccional emite luz en una dirección desde una fuente no identificable situada a una distancia infinita. Esto es similar al funcionamiento de la luz solar en la vida real. Una luz direccional tiene un alcance infinito y no disminuye.

Si castsShadow está activado, las sombras serán paralelas a la dirección de la luz.

Una luz direccional efectivamente no tiene posición, por lo que moverla no tiene ningún efecto. La luz siempre se emitirá en la dirección del eje Z de la luz.

Rotar la luz a lo largo de su eje X o Y cambiará la dirección de emisión de la luz.

Escalar una luz direccional sólo tendrá efecto en los siguientes casos:

• Si la escala de Z se establece en un número negativo, la luz se emitirá en la dirección opuesta.
• Si la escala de cualquier eje se establece en 0, la luz se emitirá a lo largo del eje Z del mundo.

  Nota: La rotación de la luz no tendrá ningún efecto.

Veamos un ejemplo sencillo:

import QtQuick
import QtQuick3D
View3D {
    anchors.fill: parent

    PerspectiveCamera { z: 600 }

    DirectionalLight {
    }

    Model {
        source: "#Sphere"
        scale: Qt.vector3d(4, 4, 4)
        materials: PrincipledMaterial {
            baseColor: "#40c060"
            roughness: 0.1 // make specular highlight visible
        }
    }
}

Aquí la DirectionalLight usa el color por defecto white, emitiendo en la dirección del eje Z del nodo DirectionalLight.

Rotando 60 grados alrededor del eje X se produciría lo siguiente. En lugar de emitir directamente en la dirección del eje Z, la luz apunta ahora 60 grados "hacia abajo":

DirectionalLight {
    eulerRotation.x: 60
}

Para más ejemplos de uso, véase Qt Quick 3D - Ejemplo de luces.

Véase también PointLight, SpotLight, y Mapeado de sombras.

Documentación de propiedades

csmBlendRatio : real [since 6.8]

Esta propiedad define la cantidad de sombra de cualquier cascada que debe mezclarse con la anterior.

Rango: [0.0, 1.0]

Valor por defecto: 0.05

Esta propiedad se introdujo en Qt 6.8.

csmNumSplits : int [since 6.8]

Esta propiedad define el número de divisiones que debe tener el frustum al renderizar el mapa de sombras. Sin divisiones significa que el mapa de sombras se renderizará de forma que cubra la caja delimitadora de todos los objetos emisores y receptores de sombras.

Rango: [0, 3]

Valor por defecto: 0

Esta propiedad se introdujo en Qt 6.8.

Véase también csmSplit1, csmSplit2, y csmSplit3.

csmSplit1 : real [since 6.8]

Esta propiedad define dónde se producirá la primera cascada de la división del mapa de sombras cuando CSM esté activo.

Rango: [0.0, 1.0]

Valor por defecto: 0.1

Esta propiedad se introdujo en Qt 6.8.

Véase también csmSplit2 y csmSplit3.

csmSplit2 : real [since 6.8]

Esta propiedad define dónde se producirá la segunda cascada de la división del mapa de sombras cuando CSM esté activo.

Rango: [0.0, 1.0]

Valor por defecto: 0.25

Esta propiedad se introdujo en Qt 6.8.

Véase también csmSplit1 y csmSplit3.

csmSplit3 : real [since 6.8]

Esta propiedad define dónde se producirá la tercera cascada de la división del mapa de sombras cuando CSM esté activo.

Rango: [0.0, 1.0]

Valor por defecto: 0.5

Esta propiedad se introdujo en Qt 6.8.

Véase también csmSplit1 y csmSplit2.

lockShadowmapTexels : bool [since 6.9]

Cuando esta propiedad está activada, los texels del shadowmap se "bloquean" en su posición en el mundo eliminando el resplandor del borde de la sombra a costa de mayores texels del shadowmap. Funciona utilizando shadowmaps de tamaño uniforme y alineados en texel para cada cascada.

Valor por defecto: false

Esta propiedad se introdujo en Qt 6.9.