En esta página

PointLight QML Type

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

Import Statement: import QtQuick3D
Inherits:

Light

Propiedades

Descripción detallada

La luz puntual puede describirse como una esfera que emite luz con la misma intensidad en todas las direcciones desde el centro de la luz. Esto es similar a la forma en que emite luz una bombilla.

Girar o cambiar la escala de una luz puntual no tiene ningún efecto. Mover una luz puntual cambiará la posición desde la que se emite la luz.

Por defecto, la intensidad de una luz puntual disminuye según la ley del inverso del cuadrado. Sin embargo, el desvanecimiento (y el alcance) se pueden controlar con las propiedades « constantFade », « linearFade » y « quadraticFade ». La atenuación de la luz se calcula mediante la fórmula: constantFade + distance * (linearFade * 0,01) + distance^2 * (quadraticFade * 0,0001)

Un ejemplo sencillo: sombrear una esfera de tres formas diferentes

Tomemos una escena que contenga una esfera delante de un rectángulo ampliado en el fondo. El color base por defecto del « PrincipledMaterial » del rectángulo es el blanco.

Sin ninguna luz y desactivando el sombreado relacionado con la luz para las dos mallas, obtenemos lo siguiente:

import QtQuick
import QtQuick3D
View3D {
    anchors.fill: parent

    PerspectiveCamera { z: 600 }

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

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

Círculo verde sobre fondo blanco

Al añadir una luz direccional, que por defecto emite hacia abajo por el eje Z, se obtiene lo siguiente:

import QtQuick
import QtQuick3D
View3D {
    anchors.fill: parent

    PerspectiveCamera { z: 600 }

    DirectionalLight { }

    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
        }
    }
}

Círculo verde con borde negro

¿Qué ocurre si ahora sustituimos « DirectionalLight » por:

PointLight {
    z: 300
}

La luz puntual (PointLight) de color blanco se ha desplazado a lo largo del eje Z de modo que se encuentre a mitad de camino entre la cámara y el centro de la escena. A diferencia de la luz de área ( DirectionalLight), la rotación de la luz puntual no importa, mientras que su posición sí es relevante. Aquí se aprecia la disminución de la intensidad, especialmente en la malla del rectángulo del fondo.

Círculo con degradado verde y borde negro, sobre un fondo con degradado gris oscuro, que muestra la atenuación de una luz puntual

Para ver más ejemplos de uso, consulta «Qt Quick 3D - Ejemplo de luces».

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

Documentación de propiedades

constantFade : real

Esta propiedad es un factor constante del término de atenuación de la luz. El valor por defecto es 1,0.

linearFade : real

Esta propiedad aumenta la velocidad a la que el efecto de iluminación atenúa la luz en proporción a la distancia a la fuente de luz. El valor por defecto es « 0.0 », lo que significa que la luz no presenta un atenuado lineal. El valor utilizado aquí se multiplica por « 0.01 » antes de emplearse para calcular la atenuación de la luz.

quadraticFade : real

Esta propiedad aumenta la velocidad a la que el efecto de iluminación atenúa la luz de forma proporcional a la ley del inverso del cuadrado. El valor por defecto es 1,0, lo que significa que la atenuación de la luz puntual sigue exactamente la ley del inverso del cuadrado; es decir, cuando la distancia a un objeto se duplica, la intensidad de la luz se reduce a una cuarta parte. El valor utilizado aquí se multiplica por 0.0001 antes de emplearse para calcular la atenuación de la luz.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.