QRhiShadingRateMap Class
Un objeto que envuelve una textura u otro tipo de objeto nativo de la API 3D. Más...
| Encabezado: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Desde: | Qt 6.9 |
| Heredado de: | QRhiResource |
Tipos públicos
(since 6.9) struct | NativeShadingRateMap |
Funciones públicas
| virtual bool | createFrom(QRhiShadingRateMap::NativeShadingRateMap src) |
| virtual bool | createFrom(QRhiTexture *src) |
Funciones públicas reimplementadas
| virtual QRhiResource::Type | resourceType() const override |
Descripción detallada
Nota: Se trata de una API de RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.
Para obtener una introducción al sombreado de tasa variable (VRS), consulta https://learn.microsoft.com/en-us/windows/win32/direct3d12/vrs. Qt admite un subconjunto de las funciones de VRS que ofrecen Direct 3D 12 y Vulkan. Además, se admite el mecanismo de Metal, algo diferente, al permitir configurar un QRhiShadingRateMap con un objeto MTLRasterizationRateMap ya existente.
Documentación de funciones de miembro
[virtual] bool QRhiShadingRateMap::createFrom(QRhiShadingRateMap::NativeShadingRateMap src)
Configura el mapa de tasa de sombreado para que utilice un objeto de tasa de sombreado de la API 3D nativa src.
Devuelve « true » si se realiza correctamente, y « false » si no es compatible.
Nota: Esto solo funciona cuando se indica que la característica QRhi::VariableRateShadingMap es compatible, mientras que la característica QRhi::VariableRateShadingMapWithTexture no lo es. Actualmente, esto es así para Metal, siempre que la GPU admita el sombreado de tasa variable.
Nota: Con Metal, se espera que el campo « object » de « src » contenga un id<MTLRASTERIZATIONRATEMAP>. Ten en cuenta que Qt no realiza nada más que pasar el MTLRasterizationRateMap al MTLRenderPassDescriptor. Si se requiere algún escalado especial, corresponde a la aplicación (o al compositor XR) llevarlo a cabo.
[virtual] bool QRhiShadingRateMap::createFrom(QRhiTexture *src)
Configura el mapa de índices de sombreado para que utilice la textura src como imagen que contiene los índices de sombreado por mosaico.
Devuelve « true » si se realiza correctamente, y « false » si no es compatible.
QRhiShadingRateMap no adquiere la propiedad de src.
Nota: Esto solo funciona cuando se indica que la función « QRhi::VariableRateShadingMapWithTexture » es compatible. En la práctica, puede ser compatible con Vulkan y Direct 3D 12 si se utilizan tarjetas gráficas modernas. Nunca será compatible con OpenGL o Metal, por ejemplo.
Nota: src debe tener el formato QRhiTexture::R8UI.
Nota: « src » debe tener una anchura de ceil(render_target_pixel_width / (float)tile_width) y una altura de ceil(render_target_pixel_height / (float)tile_height). Corresponde a la aplicación garantizar en todo momento que el tamaño de la textura sea el esperado, utilizando la fórmula anterior. El tamaño de los mosaicos se puede consultar mediante QRhi::resourceLimit() y QRhi::ShadingRateImageTileSize.
Cada byte (texel) de la textura se corresponde con el valor de la tasa de sombreado de un mosaico. El valor 0 indica 1x1, mientras que un valor de 10 indica 4x4. Consulta D3D12_SHADING_RATE para conocer otros valores posibles.
[override virtual] QRhiResource::Type QRhiShadingRateMap::resourceType() const
Reimplementa: ` QRhiResource::resourceType()` const.
Devuelve el tipo de recurso.
© 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.