Renderizado volumétrico
Renderización de objetos volumétricos.
El renderizado volumétrico muestra cómo utilizar « QCustom3DVolume » para visualizar datos volumétricos.

Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde « Command Palette » y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Inicialización del elemento de volumen
Los elementos de volumen ( QCustom3DVolume ) son elementos personalizados especiales (véase QCustom3DItem), que pueden utilizarse para mostrar datos volumétricos. Los elementos de volumen solo son compatibles con la proyección ortográfica, por lo que primero debes asegurarte de que el gráfico la utilice:
m_graph->setOrthoProjection(true);Crea un elemento volumétrico vinculado a los rangos de datos de los ejes:
m_volumeItem = new QCustom3DVolume;
// Adjust water level to zero with a minor tweak to y-coordinate position and scaling
m_volumeItem->setScaling(
QVector3D(m_graph->axisX()->max() - m_graph->axisX()->min(),
(m_graph->axisY()->max() - m_graph->axisY()->min()) * 0.91f,
m_graph->axisZ()->max() - m_graph->axisZ()->min()));
m_volumeItem->setPosition(
QVector3D((m_graph->axisX()->max() + m_graph->axisX()->min()) / 2.0f,
-0.045f * (m_graph->axisY()->max() - m_graph->axisY()->min()) +
(m_graph->axisY()->max() + m_graph->axisY()->min()) / 2.0f,
(m_graph->axisZ()->max() + m_graph->axisZ()->min()) / 2.0f));
m_volumeItem->setScalingAbsolute(false);Indica que el escalado del volumen debe seguir los cambios en los rangos de datos configurando la propiedad « QCustom3DItem::scalingAbsolute » en « false ». A continuación, define el contenido interno del volumen:
m_volumeItem->setTextureWidth(lowDetailSize);
m_volumeItem->setTextureHeight(lowDetailSize / 2);
m_volumeItem->setTextureDepth(lowDetailSize);
m_volumeItem->setTextureFormat(QImage::Format_Indexed8);
m_volumeItem->setTextureData(new QList<uchar>(*m_lowDetailData));Utilice color indexado de ocho bits para la textura, ya que es compacto y facilita el ajuste de los colores sin necesidad de restablecer toda la textura. Para los datos de la textura, utilice los datos creados anteriormente a partir de mapas de altura. Normalmente, los datos de los elementos volumétricos vienen pregenerados en forma de pila de imágenes, por lo que se pueden omitir los detalles de la generación de datos. Para obtener más información sobre el proceso de generación de datos, consulta el código de ejemplo.
Dado que se utilizan colores indexados de ocho bits, se necesita una tabla de colores para asignar los índices de color de ocho bits a los colores reales. En un caso de uso típico, se obtendría la tabla de colores a partir de las imágenes originales en lugar de utilizar una definida manualmente:
m_volumeItem->setColorTable(m_colorTable1);Para poder mostrar marcos de corte alrededor del volumen, inicializa sus propiedades. Inicialmente, los marcos estarán ocultos:
m_volumeItem->setSliceFrameGaps(QVector3D(0.01f, 0.02f, 0.01f));
m_volumeItem->setSliceFrameThicknesses(QVector3D(0.0025f, 0.005f, 0.0025f));
m_volumeItem->setSliceFrameWidths(QVector3D(0.0025f, 0.005f, 0.0025f));
m_volumeItem->setDrawSliceFrames(false);Por último, añade el volumen como un elemento personalizado al gráfico para mostrarlo:
m_graph->addCustomItem(m_volumeItem);Corte del volumen
A menos que el volumen sea en gran parte transparente, solo se puede ver su superficie, lo que a menudo no resulta muy útil. Una forma de inspeccionar la estructura interna del volumen es visualizar sus cortes. QCustom3DVolume ofrece dos formas de mostrar los cortes. La primera consiste en mostrar los cortes seleccionados en lugar del volumen. Por ejemplo, para especificar un corte perpendicular al eje X, utiliza el siguiente método:
m_volumeItem->setSliceIndexX(m_sliceIndexX);Para mostrar el corte especificado anteriormente, también debe configurarse la propiedad ` QCustom3DVolume::drawSlices `:
m_volumeItem->setDrawSlices(true);La segunda forma de visualizar cortes es utilizar el método ` QCustom3DVolume::renderSlice()`, que genera una imagen ` QImage ` a partir del corte especificado. Esta imagen se puede mostrar a continuación en otro widget, como un ` QLabel`:
Ajustar la transparencia del volumen
A veces, ver solo los cortes no permite comprender bien la estructura interna del volumen. QCustom3DVolume ofrece dos propiedades que pueden utilizarse para ajustar la transparencia del volumen:
m_volumeItem->setAlphaMultiplier(mult);
...
m_volumeItem->setPreserveOpacity(enabled);La propiedad « QCustom3DVolume::alphaMultiplier » es un multiplicador general que se aplica al valor alfa de cada vóxel del volumen. Permite añadir transparencia uniforme a las partes del volumen que ya son algo transparentes para revelar detalles internos opacos. Este multiplicador no afecta a los colores totalmente opacos, a menos que la propiedad « QCustom3DVolume::preserveOpacity » esté establecida en « false ».
Una forma alternativa de ajustar la transparencia del volumen es modificar directamente los valores alfa de los vóxeles. En el caso de las texturas indexadas de ocho bits, esto se consigue simplemente modificando y restableciendo la tabla de colores:
int newAlpha = enabled ? terrainTransparency : 255;
for (int i = aboveWaterGroundColorsMin; i < underWaterGroundColorsMax; i++) {
QRgb oldColor1 = m_colorTable1.at(i);
QRgb oldColor2 = m_colorTable2.at(i);
m_colorTable1[i] = qRgba(qRed(oldColor1), qGreen(oldColor1), qBlue(oldColor1), newAlpha);
m_colorTable2[i] = qRgba(qRed(oldColor2), qGreen(oldColor2), qBlue(oldColor2), newAlpha);
}
if (m_usingPrimaryTable)
m_volumeItem->setColorTable(m_colorTable1);
else
m_volumeItem->setColorTable(m_colorTable2);Shader de alta definición frente a shader de baja definición
Por defecto, el renderizado volumétrico utiliza un shader de alta definición. Este tiene en cuenta cada vóxel del volumen con el peso correcto al realizar el trazado de rayos del contenido del volumen, lo que proporciona una representación precisa incluso de los detalles más sutiles del volumen. Sin embargo, esto supone un gran coste computacional, por lo que la velocidad de fotogramas se ve afectada. Si la velocidad de renderizado es más importante que la precisión al píxel del contenido del volumen, utiliza el sombreador de baja definición, mucho más rápido, configurando la propiedad « QCustom3DVolume::useHighDefShader » ( false). El sombreador de baja definición alcanza esa velocidad sacrificando precisión, por lo que no garantiza que se muestree cada vóxel del volumen. Esto puede provocar parpadeos u otros artefactos de renderizado en los detalles más sutiles del volumen.
m_volumeItem->setUseHighDefShader(enabled);Contenido del ejemplo
© 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.