En esta página

Qt 3D: Ejemplo de formas básicas en C++

Muestra cuatro formas básicas que ofrece Qt 3D y configura una malla para cada una de ellas.

Captura de pantalla en la que se muestran cuatro objetos en 3D: un toro, un cilindro, un paralelepípedo y una esfera

«Formas básicas» muestra cuatro formas básicas que ofrece Qt 3D: un toro, un cilindro, un cubo y una esfera. El ejemplo también muestra cómo incrustar una escena de Qt 3D en un widget y conectarla con otros widgets.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Configuración de una malla toroidal

A modo de ejemplo, veremos cómo configurar una malla toroidal. En primer lugar, instanciamos el componente « QTorusMesh » y, a continuación, configuramos los parámetros específicos de la malla, que en el caso del toro son el radio, el radio menor y el número de anillos y secciones.

m_torus = new Qt3DExtras::QTorusMesh();
m_torus->setRadius(1.0f);
m_torus->setMinorRadius(0.4f);
m_torus->setRings(100);
m_torus->setSlices(20);

El tamaño y la posición del toro se pueden ajustar mediante componentes de transformación. Creamos componentes de escala, traslación y rotación, y los añadimos al componente « QTransform ».

Qt3DCore::QTransform *torusTransform = new Qt3DCore::QTransform();
torusTransform->setScale(2.0f);
torusTransform->setRotation(QQuaternion::fromAxisAndAngle(QVector3D(0.0f, 1.0f, 0.0f), 25.0f));
torusTransform->setTranslation(QVector3D(5.0f, 4.0f, 0.0f));

Para cambiar el color difuso de la malla, creamos un « QPhongMaterial » y configuramos su color difuso.

Qt3DExtras::QPhongMaterial *torusMaterial = new Qt3DExtras::QPhongMaterial();
torusMaterial->setDiffuse(QColor(QRgb(0xbeb32b)));

El último paso consiste en añadir el toro a un árbol de entidades, y lo hacemos creando un « QEntity » con una entidad padre e incorporando en él los componentes de malla, material y transformación creados anteriormente.

m_torusEntity = new Qt3DCore::QEntity(m_rootEntity);
m_torusEntity->addComponent(m_torus);
m_torusEntity->addComponent(torusMaterial);
m_torusEntity->addComponent(torusTransform);

Podemos controlar la visibilidad de la entidad definiendo si tiene una entidad padre o no. Es decir, si forma parte de un árbol de entidades o no.

void SceneModifier::enableTorus(bool enabled)
{
    m_torusEntity->setEnabled(enabled);
}

Proyecto de ejemplo en @ code.qt.io

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