Obsolete Members for Qt3DExtras

Los siguientes miembros de la clase ` Qt3DExtras ` están obsoletos. Se incluyen para que el código fuente antiguo siga funcionando. Recomendamos encarecidamente no utilizarlos en código nuevo.

Clases

(deprecated) class QAbstractCameraController
(deprecated) class QConeGeometry
(deprecated) class QConeGeometryView
(deprecated) class QConeMesh
(deprecated) class QCuboidGeometry
(deprecated) class QCuboidGeometryView
(deprecated) class QCuboidMesh
(deprecated) class QCylinderGeometry
(deprecated) class QCylinderGeometryView
(deprecated) class QCylinderMesh
(deprecated) class QDiffuseMapMaterial
(deprecated) class QDiffuseSpecularMapMaterial
(deprecated) class QDiffuseSpecularMaterial
(deprecated) class QExtrudedTextGeometry
(deprecated) class QExtrudedTextMesh
(deprecated) class QFirstPersonCameraController
(deprecated) class QForwardRenderer
(deprecated) class QGoochMaterial
(deprecated) class QMetalRoughMaterial
(deprecated) class QMorphPhongMaterial
(deprecated) class QNormalDiffuseMapAlphaMaterial
(deprecated) class QNormalDiffuseMapMaterial
(deprecated) class QNormalDiffuseSpecularMapMaterial
(deprecated) class QOrbitCameraController
(deprecated) class QPerVertexColorMaterial
(deprecated) class QPhongAlphaMaterial
(deprecated) class QPhongMaterial
(deprecated) class QPlaneGeometry
(deprecated) class QPlaneGeometryView
(deprecated) class QPlaneMesh
(deprecated) class QSkyboxEntity
(deprecated) class QSphereGeometry
(deprecated) class QSphereGeometryView
(deprecated) class QSphereMesh
(deprecated) class QText2DEntity
(deprecated) class QTextureMaterial
(deprecated) class QTorusGeometry
(deprecated) class QTorusGeometryView
(deprecated) class QTorusMesh

Clases

[deprecated] class Qt3DExtras::QAbstractCameraController

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

QAbstractCameraController configura y gestiona las entradas procedentes del teclado, el ratón y otros dispositivos. QAbstractCameraController es una clase abstracta y no se puede instanciar por sí misma. Proporciona una interfaz estándar para los controladores de cámara.

[deprecated] class Qt3DExtras::QConeGeometry

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase `QConeGeometry` se utiliza principalmente a nivel interno en el ` QConeMesh `, pero también puede emplearse en subclases personalizadas de ` Qt3DRender::QGeometryRenderer `. La clase permite crear tanto un cono como un cono truncado.

[deprecated] class Qt3DExtras::QConeGeometryView

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

* * * * * * *

[deprecated] class Qt3DExtras::QConeMesh

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

[deprecated] class Qt3DExtras::QCuboidGeometry

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase `QCuboidGeometry` se utiliza principalmente a nivel interno en el ` QCuboidMesh `, pero también puede emplearse en subclases personalizadas de ` Qt3DRender::QGeometryRenderer `.

[deprecated] class Qt3DExtras::QCuboidGeometryView

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

* * * * * * *

[deprecated] class Qt3DExtras::QCuboidMesh

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

[deprecated] class Qt3DExtras::QCylinderGeometry

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase `QCylinderGeometry` se utiliza principalmente de forma interna en el ` QCylinderMesh `, pero también puede utilizarse en subclases personalizadas de ` Qt3DRender::QGeometryRenderer `.

[deprecated] class Qt3DExtras::QCylinderGeometryView

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

* * * * * * *

[deprecated] class Qt3DExtras::QCylinderMesh

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Este componente se puede utilizar para renderizar un cilindro cuando se combina con un componente de material.

[deprecated] class Qt3DExtras::QDiffuseMapMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Esta clase está obsoleta; utiliza en su lugar Qt3DExtras::QDiffuseSpecularMaterial.

El efecto de iluminación especular 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:

  • La iluminación ambiental es el color 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 especular es el color emitido por los reflejos de una superficie brillante con la luz.
  • El brillo de una superficie se controla mediante una propiedad de tipo float.

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.

[deprecated] class Qt3DExtras::QDiffuseSpecularMapMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Esta clase está obsoleta; utiliza en su lugar Qt3DExtras::QDiffuseSpecularMaterial.

El efecto de iluminación especular 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:

  • La iluminación ambiental es el color 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.

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.

[deprecated] class Qt3DExtras::QDiffuseSpecularMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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

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.

[deprecated] class Qt3DExtras::QExtrudedTextGeometry

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase `QExtrudedTextGeometry` se utiliza principalmente a nivel interno en `QText3DMesh`, pero también puede emplearse en subclases personalizadas de ` Qt3DRender::QGeometryRenderer `.

El origen de la geometría es el extremo trasero izquierdo de la línea de base del texto.

[deprecated] class Qt3DExtras::QExtrudedTextMesh

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

El origen de la malla es el extremo trasero izquierdo de la línea de base del texto.

[deprecated] class Qt3DExtras::QFirstPersonCameraController

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Los controles son:

InputAcción
Botón izquierdo del ratónMientras se mantiene pulsado el botón izquierdo del ratón, el movimiento del ratón a lo largo del eje x desplaza la cámara y el movimiento a lo largo del eje y la inclina.
Rueda de desplazamiento del ratónAcerca y aleja la cámara sin cambiar el centro de la vista.
Tecla MayúsActiva el control de movimiento preciso mientras se mantiene pulsada. Reduce la sensibilidad del desplazamiento y la inclinación del ratón.
Teclas de flechaMueven la cámara horizontalmente con respecto a la ventana de visualización de la cámara.
Teclas Re Pág y Av PágMueven la cámara verticalmente con respecto a la ventana de visualización de la cámara.
EscMueve la cámara de manera que toda la escena quede visible en la ventana de visualización de la cámara.

[deprecated] class Qt3DExtras::QForwardRenderer

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

El renderizado directo es el que utiliza tradicionalmente OpenGL. Realiza el renderizado directamente en el búfer de fondo, objeto a objeto, aplicando el sombreado a cada uno de ellos a medida que avanza.

QForwardRenderer es un árbol FrameGraph de una sola hoja que contiene un Qt3DRender::QViewport, un Qt3DRender::QCameraSelector y un Qt3DRender::QClearBuffers. El QForwardRenderer tiene una clave de filtro predeterminada cuyo nombre es «renderingStyle» y cuyo valor es «forward». Si necesitas filtrar tus técnicas, debes hacerlo basándote en esa clave de filtro.

Por defecto, la ventana de visualización ocupa toda la pantalla y el color de fondo es el blanco. El culling de frustum también está activado.

[deprecated] class Qt3DExtras::QGoochMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

El modelo de iluminación de Gooch utiliza tanto el color como el brillo para ayudar a mostrar la curvatura de las superficies 3D. A menudo, esto ofrece mejores resultados que modelos como el de Phong, que se basan exclusivamente en los cambios de brillo. En situaciones como las aplicaciones CAD y CAM, en las que el fotorrealismo no es un objetivo, el modelo de sombreado de Gooch, junto con algún tipo de delineado de los bordes de la silueta, es una solución muy utilizada.

El modelo de iluminación de Gooch se explica detalladamente en el artículo original de Gooch. El modelo de Gooch mezcla el color difuso del objeto con un color frío y un color cálido proporcionados por el usuario para generar los extremos de una rampa de color que se utiliza para sombrear el objeto en función del coseno del ángulo entre el vector que va del fragmento a la fuente de luz y el vector normal del fragmento. Opcionalmente, se puede añadir un reflejo especular encima. Las contribuciones relativas del color difuso a los colores fríos y cálidos se controlan mediante las propiedades alfa y beta, respectivamente.

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.

[deprecated] class Qt3DExtras::QMetalRoughMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Este material utiliza un efecto con un enfoque de una sola pasada de renderizado y aplica la iluminación por fragmento. Se proporcionan técnicas para OpenGL 3 y OpenGL ES 3.

[deprecated] class Qt3DExtras::QMorphPhongMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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.

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.

[deprecated] class Qt3DExtras::QNormalDiffuseMapAlphaMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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

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

  • La iluminación ambiental es el color 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 las luces.
  • El especular es el color emitido por los reflejos de una superficie brillante con la luz.
  • El brillo de una superficie se controla mediante una propiedad de tipo float.

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.

[deprecated] class Qt3DExtras::QNormalDiffuseMapMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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

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

  • La iluminación ambiental es el color 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 especular es el color emitido por los reflejos de una superficie brillante con la luz.
  • El brillo de una superficie se controla mediante una propiedad de tipo float.

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.

[deprecated] class Qt3DExtras::QNormalDiffuseSpecularMapMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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

El efecto de iluminación especular 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:

  • La iluminación ambiental es el color 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 especular es el color emitido por los reflejos de una superficie brillante con la luz.
  • El brillo de una superficie se controla mediante una propiedad de tipo float.

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.

[deprecated] class Qt3DExtras::QOrbitCameraController

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Los controles son:

InputAcción
Botón izquierdo del ratónMientras se mantiene pulsado el botón izquierdo del ratón, el movimiento del ratón a lo largo del eje x desplaza la cámara hacia la izquierda y hacia la derecha, y el movimiento a lo largo del eje y la desplaza hacia arriba y hacia abajo.
Botón derecho del ratónMientras se mantiene pulsado el botón derecho del ratón, el movimiento del ratón a lo largo del eje x desplaza la cámara alrededor del centro de la vista, y el movimiento a lo largo del eje y la inclina alrededor del centro de la vista.
Botones izquierdo y derecho del ratónMientras se mantienen pulsados tanto el botón izquierdo como el derecho del ratón, el movimiento del ratón a lo largo del eje Y permite acercar y alejar la cámara sin cambiar el centro de la vista.
Rueda de desplazamiento del ratónAumenta y reduce el zoom de la cámara sin cambiar el centro de la vista.
Teclas de flechaMueven la cámara vertical y horizontalmente con respecto a la ventana de visualización de la cámara.
Teclas «Re Pág» y «Av Pág»Mueven la cámara hacia delante y hacia atrás.
Tecla MayúsCambia el comportamiento de las teclas de flecha arriba y abajo para acercar y alejar la cámara sin cambiar el centro de la vista. Las demás teclas de movimiento quedan desactivadas.
Tecla AltCambia el comportamiento de las teclas de flecha para desplazar y girar la cámara alrededor del centro de la vista. Desactiva las teclas «Página arriba» y «Página abajo».
EscMueve la cámara de forma que toda la escena quede visible en la ventana de visualización de la cámara.

[deprecated] class Qt3DExtras::QPerVertexColorMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Este efecto de iluminación se basa en la combinación de dos componentes de iluminación: el ambiental y el difuso. El ambiental viene determinado por el color del vértice. El difuso tiene en cuenta la distribución normal de cada vértice.

  • La iluminación ambiental es el color que emite un objeto sin ninguna otra fuente de luz.
  • La luz difusa es el color que se emite en los reflejos de superficies rugosas con la luz

Este material utiliza un efecto basado en un único paso de renderizado y genera iluminación de fragmentos. Se proporcionan técnicas para OpenGL 2, OpenGL 3 o superior, así como para OpenGL ES 2.

[deprecated] class Qt3DExtras::QPhongAlphaMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Esta clase está obsoleta; utiliza 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.

[deprecated] class Qt3DExtras::QPhongMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Esta clase está obsoleta; utiliza 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.

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.

[deprecated] class Qt3DExtras::QPlaneGeometry

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase `QPlaneGeometry` se utiliza principalmente de forma interna en el ` QPlaneMesh `, pero también puede emplearse en subclases personalizadas de ` Qt3DRender::QGeometryRenderer `.

[deprecated] class Qt3DExtras::QPlaneGeometryView

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

* * * * * * *

[deprecated] class Qt3DExtras::QPlaneMesh

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

[deprecated] class Qt3DExtras::QSkyboxEntity

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Al especificar un nombre base y una extensión, Qt3DExtras::QSkyboxEntity se encargará de generar un archivo TextureCubeMap que se renderizará en tiempo de ejecución. Las imágenes del directorio de origen deben seguir el siguiente patrón: nombre base + * «_posx|_posy|_posz|_negx|_negy|_negz» + extensión

Por defecto, la extensión predeterminada es .png.

Asegúrate de desactivar el «frustum culling» en el FrameGraph a través del cual se realiza el renderizado del skybox.

Nota: Ten en cuenta que no debes intentar renderizar un skybox con una proyección ortográfica.

[deprecated] class Qt3DExtras::QSphereGeometry

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase `QSphereGeometry` se utiliza principalmente a nivel interno en el ` QSphereMesh `, pero también puede emplearse en subclases personalizadas de ` Qt3DRender::QGeometryRenderer `.

[deprecated] class Qt3DExtras::QSphereGeometryView

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

* * * * * * *

[deprecated] class Qt3DExtras::QSphereMesh

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

[deprecated] class Qt3DExtras::QText2DEntity

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase QText2DEntity representa el texto como triángulos en el plano XY. La geometría se ajustará al rectángulo de anchura y altura especificadas. Si la geometría resultante es más ancha que la anchura especificada, el resto se representará en una nueva línea.

La entidad se puede colocar en la escena añadiendo un componente de transformación.

QText2DEntity creará la geometría basándose en la forma de los glifos y un material sólido utilizando el color especificado.

[deprecated] class Qt3DExtras::QTextureMaterial

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Este material utiliza un efecto basado en un único paso de renderizado. Se proporcionan técnicas para OpenGL 2, OpenGL 3 o superior, así como para OpenGL ES 2.

[deprecated] class Qt3DExtras::QTorusGeometry

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

La clase `QTorusGeometry` se utiliza principalmente a nivel interno en ` QTorusMesh `, pero también puede emplearse en subclases personalizadas de ` Qt3DRender::QGeometryRenderer `.

[deprecated] class Qt3DExtras::QTorusGeometryView

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

* * * * * * *

[deprecated] class Qt3DExtras::QTorusMesh

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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