En esta página

Renderizado volumétrico

Renderización de objetos volumétricos.

El renderizado volumétrico muestra cómo utilizar QCustom3DVolume para visualizar datos volumétricos.

Representación volumétrica de un terreno en 3D con capas de agua y tierra

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Inicialización del elemento de volumen

Los elementos 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 hay que asegurarse 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 estableciendo 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 real 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 de origen 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 establecerse 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 en 3D ( QImage ) a partir del corte especificado. Esta imagen se puede mostrar a continuación en otro widget, como un ` QLabel`:

m_sliceLabelX->setPixmap(
            QPixmap::fromImage(m_volumeItem->renderSlice(Qt::XAxis, m_sliceIndexX)));

Ajustar la transparencia del volumen

A veces, ver solo los cortes no permite comprender bien la estructura interna del volumen. QCustom3DVolume proporciona dos propiedades que se pueden utilizar 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 opacos internos. Este multiplicador no afecta a los colores que son totalmente opacos, a menos que la propiedad « QCustom3DVolume::preserveOpacity » esté establecida en « false ».

Una forma alternativa de ajustar la transparencia del volumen consiste en 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 sombreador 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 esfuerzo computacional, por lo que la velocidad de fotogramas se ve afectada. Si la velocidad de renderizado es más importante que la precisión pixel a pixel 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 a costa de la 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 finos del volumen.

m_volumeItem->setUseHighDefShader(enabled);

Contenido del ejemplo

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.