CubeMapTexture QML Type
Define una textura de mapa cúbico para su uso en escenas 3D. Más información...
| Import Statement: | import QtQuick3D |
| Inherits: |
Descripción detallada
CubeMapTexture es una textura que representa una textura de mapa cúbico. Una textura de mapa cúbico tiene 6 caras (X+, X-, Y+, Y-, Z+, Z-), donde cada cara es una imagen 2D independiente. CubeMapTexture permite que custom materials y post-processing effects trabajen con texturas de mapa cúbico en sus shaders. Un mapa cúbico también se puede utilizar para definir el entorno de la escena skybox.
CustomMaterial {
property TextureInput customTexture: TextureInput {
texture: CubeMapTexture {
source: "cubemap.ktx"
}
}
fragmentShader: "shader.frag"
}Aquí, shader.frag se puede implementar suponiendo que customTexture es un uniforme de muestreador con el tipo GLSL a samplerCube. Esto significa que la función GLSL texture() toma un vec3 como coordenada de textura para ese muestreador. Si hubiéramos utilizado Texture, el tipo habría sido sampler2D.
void MAIN()
{
vec4 c = texture(customTexture, NORMAL);
BASE_COLOR = vec4(c.rgb, 1.0);
}Al obtener una textura de un contenedor con un cubemap, solo se carga la cara 0 (X+) y el resultado es una textura 2D. En cambio, al obtener una `CubeMapTexture` del mismo recurso, se cargan las seis caras y el resultado es una textura de cubemap.
`CubeMapTexture` hereda todas sus propiedades de `Texture`. La diferencia importante es que ` source ` debe hacer referencia a un archivo de imagen que contenga un cubemap, o a una lista de archivos de imagen. En la práctica, un único archivo significa un contenedor KTX que contiene las imágenes de las seis caras.
La obtención de una `CubeMapTexture` a partir de seis imágenes individuales puede realizarse de dos formas diferentes. O bien como una lista de nombres de archivos separados por punto y coma en el orden X+, X-, Y+, Y-, Z+, Z-:
CubeMapTexture {
source: "maps/right.jpg;maps/left.jpg;maps/top.jpg;maps/bottom.jpg;maps/front.jpg;maps/back.jpg"
}o como una cadena que contenga un marcador de posición «%p», donde «%p» se sustituirá por las cadenas «posx», «negx», «posy», «negy», «posz» y «negz» para generar los seis nombres de archivo:
CubeMapTexture {
source: "maps/sky_%p.png"
// equivalent to:
// source: "maps/sky_posx.png;maps/sky_negx.png;maps/sky_posy.png;maps/sky_negy.png;maps/sky_posz.png;maps/sky_negz.png"
}Nota: Por el momento, CubeMapTexture no admitela obtención de datos de imágenes a través de otros medios, como sourceItem o textureData.
Véase también Texture, CustomMaterial y Effect.
© 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.