En esta página

Qt3DExtras::QPhongAlphaMaterial Class

class Qt3DExtras::QPhongAlphaMaterial

La clase QPhongAlphaMaterial ofrece una implementación predeterminada del efecto de iluminación Phong con alfa. Más información...

Encabezado: #include <qphongalphamaterial.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake: QT += 3dextras
Heredado de: Qt3DRender::QMaterial
Estado: Obsoleta

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QPhongAlphaMaterial(Qt3DCore::QNode *parent = nullptr)
virtual ~QPhongAlphaMaterial()
float alpha() const
QColor ambient() const
Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg() const
Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg() const
Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg() const
QColor diffuse() const
float shininess() const
Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg() const
Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg() const
QColor specular() const

Ranuras públicas

void setAlpha(float alpha)
void setAmbient(const QColor &ambient)
void setBlendFunctionArg(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)
void setDestinationAlphaArg(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)
void setDestinationRgbArg(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)
void setDiffuse(const QColor &diffuse)
void setShininess(float shininess)
void setSourceAlphaArg(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)
void setSourceRgbArg(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)
void setSpecular(const QColor &specular)

Señales

void alphaChanged(float alpha)
void ambientChanged(const QColor &ambient)
void blendFunctionArgChanged(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)
void destinationAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)
void destinationRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)
void diffuseChanged(const QColor &diffuse)
void shininessChanged(float shininess)
void sourceAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)
void sourceRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)
void specularChanged(const QColor &specular)

Descripción detallada

Esta clase está obsoleta; utilice en su lugar QDiffuseSpecularMaterial.

El efecto de iluminación Phong se basa en la combinación de tres componentes de iluminación: ambiental, difuso y especular. La intensidad relativa de estos componentes se controla mediante sus coeficientes de reflectividad, que se modelan como tríos RGB:

  • El color ambiental es el que emite un objeto sin ninguna otra fuente de luz.
  • El color difuso es el que se emite en los reflejos de superficies rugosas con la luz.
  • El color especular es el que se emite en los reflejos de superficies brillantes con la luz.
  • El brillo de una superficie se controla mediante una propiedad de tipo float.
  • El alfa es la transparencia de la superficie, que varía entre 0 (totalmente transparente) y 1 (opaco).

Este material utiliza un efecto con un enfoque de una sola pasada de renderizado y realiza la iluminación por fragmento. Se proporcionan técnicas para OpenGL 2, OpenGL 3 o superior, así como para OpenGL ES 2.

Documentación de propiedades

alpha : float

Almacena el componente alfa del objeto, que varía entre 0 y 1.

El valor por defecto es 0,5f.

Funciones de acceso:

float alpha() const
void setAlpha(float alpha)

Señal de notificador:

void alphaChanged(float alpha)

ambient : QColor

Almacena el color ambiental.

Funciones de acceso:

QColor ambient() const
void setAmbient(const QColor &ambient)

Señal de notificador:

void ambientChanged(const QColor &ambient)

blendFunctionArg : Qt3DRender::QBlendEquation::BlendFunction

Almacena el argumento de la función de la ecuación de mezcla.

Funciones de acceso:

Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg() const
void setBlendFunctionArg(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)

Señal de notificación:

void blendFunctionArgChanged(Qt3DRender::QBlendEquation::BlendFunction blendFunctionArg)

Véase también Qt3DRender::QBlendEquation::BlendFunction.

destinationAlphaArg : Qt3DRender::QBlendEquationArguments::Blending

Almacena el argumento de mezcla alfa de destino de la ecuación de mezcla.

Funciones de acceso:

Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg() const
void setDestinationAlphaArg(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)

Señal de notificación:

void destinationAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationAlphaArg)

Véase también Qt3DRender::QBlendEquationArguments::Blending.

destinationRgbArg : Qt3DRender::QBlendEquationArguments::Blending

Almacena el argumento de mezcla RGB de destino de la ecuación de mezcla.

Funciones de acceso:

Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg() const
void setDestinationRgbArg(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)

Señal de notificación:

void destinationRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending destinationRgbArg)

Véase también Qt3DRender::QBlendEquationArguments::Blending.

diffuse : QColor

Contiene el color difuso.

Funciones de acceso:

QColor diffuse() const
void setDiffuse(const QColor &diffuse)

Señal de notificación:

void diffuseChanged(const QColor &diffuse)

shininess : float

Almacena el exponente de brillo.

Funciones de acceso:

float shininess() const
void setShininess(float shininess)

Señal del notificador:

void shininessChanged(float shininess)

sourceAlphaArg : Qt3DRender::QBlendEquationArguments::Blending

Almacena el argumento de mezcla alfa de la fuente de la ecuación de mezcla.

Funciones de acceso:

Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg() const
void setSourceAlphaArg(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)

Señal de notificación:

void sourceAlphaArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceAlphaArg)

Véase también Qt3DRender::QBlendEquationArguments::Blending.

sourceRgbArg : Qt3DRender::QBlendEquationArguments::Blending

Almacena el argumento de mezcla RGB de la fuente de la ecuación de mezcla.

Funciones de acceso:

Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg() const
void setSourceRgbArg(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)

Señal de notificación:

void sourceRgbArgChanged(Qt3DRender::QBlendEquationArguments::Blending sourceRgbArg)

Véase también Qt3DRender::QBlendEquationArguments::Blending.

specular : QColor

Contiene el color especular.

Funciones de acceso:

QColor specular() const
void setSpecular(const QColor &specular)

Señal del notificador:

void specularChanged(const QColor &specular)

Documentación de funciones de miembro

[explicit] QPhongAlphaMaterial::QPhongAlphaMaterial(Qt3DCore::QNode *parent = nullptr)

Crea una nueva instancia de QPhongAlphaMaterial con el objeto padre parent.

[virtual noexcept] QPhongAlphaMaterial::~QPhongAlphaMaterial()

Destruye la « QPhongAlphaMaterial ».

© 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.