ShaderImage QML Type
셰이더 프로그램에 대한 이미지 액세스를 제공합니다. 더 보기...
| Import Statement: | import Qt3D.Render 2.8 |
| In C++: | QShaderImage |
| Status: | Deprecated |
속성
상세 설명
텍스처의 콘텐츠를 셰이더에서 읽기 및 쓰기 작업에 사용할 수 있게 하려면 텍스처를 ShaderImage로 노출해야 합니다. 텍스처는 여러 밉 레벨, 레이어 및 면으로 구성될 수 있습니다. 또한 ShaderImage를 선언하면 액세스하려는 텍스처 콘텐츠의 레벨, 레이어 또는 면을 지정할 수 있습니다.
ShaderImage를 파라미터의 값으로 할당하고 유효한 Qt3D.Render.AbstractTexture 를 참조해야 제대로 작동합니다.
참조된 텍스처가 1차원 배열, 2차원 배열, 3차원, 큐브 맵, 큐브 맵 배열 또는 2차원 다중 샘플 배열 텍스처인 경우 전체 텍스처 레벨 또는 텍스처 레벨의 단일 레이어 또는 면을 바인딩할 수 있습니다. 이는 layered 프로퍼티로 제어할 수 있습니다.
셰이더이미지에 대한 지원은 OpenGL 4에서만 지원되며 OpenGL ES 3.1 및 3.2에서는 부분적으로만 지원됩니다.
OpenGL 4에서 지원하는 이미지 유형은 다음과 같습니다:
| GLSL 유형 | OpenGL 유형 열거형 | 텍스처 유형 |
|---|---|---|
| image1D | GL_IMAGE_1D | Texture1D |
| image2D | GL_IMAGE_2D | Texture2D |
| image3D | GL_IMAGE_3D | Texture3D |
| image2DRect | GL_IMAGE_2D_RECT | TextureRectangle |
| imageCube | GL_IMAGE_CUBE | TextureCubeMap |
| imageBuffer | GL_IMAGE_BUFFER | TextureBuffer |
| image1DArray | GL_IMAGE_1D_ARRAY | Texture1DArray |
| image2DArray | GL_IMAGE_2D_ARRAY | Texture2DArray |
| imageCubeArray | gl_image_cube_map_array | TextureCubeMapArray |
| image2DMS | gl_image_2d_multisample | Texture2DMultisample |
| image2DMSArray | gl_image_2D_멀티샘플_어레이 | Texture2DMultisampleArray |
| iimage1D | GL_INT_IMAGE_1D | Texture1D |
| iimage2D | GL_INT_IMAGE_2D | Texture2D |
| iimage3D | GL_INT_IMAGE_3D | Texture3D |
| iimage2DRect | GL_INT_IMAGE_2D_RECT | TextureRectangle |
| iimageCube | GL_INT_IMAGE_CUBE | TextureCubeMap |
| iimageBuffer | GL_INT_IMAGE_BUFFER | TextureBuffer |
| iimage1DArray | GL_INT_IMAGE_1D_ARRAY | Texture1DArray |
| iimage2DArray | GL_INT_IMAGE_2D_ARRAY | Texture2DArray |
| iimageCubeArray | GL_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| iimage2DMS | GL_INT_IMAGE_2D_멀티샘플 | Texture2DMultisample |
| iimage2DMSArray | GL_INT_IMAGE_2D_멀티샘플_어레이 | Texture2DMultisampleArray |
| uimage1D | GL_UNSIGNED_INT_IMAGE_1D | Texture1D |
| uimage2D | GL_UNSIGNED_INT_IMAGE_2D | Texture2D |
| uimage3D | GL_UNSIGNED_INT_IMAGE_3D | Texture3D |
| uimage2DRect | GL_UNSIGNED_INT_IMAGE_2D_RECT | TextureRectangle |
| uimageCube | GL_UNSIGNED_INT_IMAGE_CUBE | TextureCubeMap |
| uimageBuffer | GL_UNSIGNED_INT_IMAGE_BUFFER | TextureBuffer |
| uimage1DArray | GL_UNSIGNED_INT_IMAGE_1D_ARRAY | Texture1DArray |
| uimage2DArray | GL_UNSIGNED_INT_IMAGE_2D_ARRAY | Texture2DArray |
| uimageCubeArray | GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| uimage2DMS | GL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE | Texture2DMultisample |
| uimage2DMSArray | GL_UNSIGNED_INT_IMAGE_2D_멀티샘플_어레이 | Texture2DMultisampleArray |
OpenGL ES 3.1에서 지원하는 이미지 유형은 다음과 같습니다:
| GLSL 유형 | OpenGL 유형 열거형 | 텍스처 유형 |
|---|---|---|
| image2D | GL_IMAGE_2D | Texture2D |
| image3D | GL_IMAGE_3D | Texture3D |
| imageCube | GL_IMAGE_CUBE | TextureCubeMap |
| image2DArray | GL_IMAGE_2D_ARRAY | Texture2DArray |
| iimage2D | GL_INT_IMAGE_2D | Texture2D |
| iimage3D | GL_INT_IMAGE_3D | Texture3D |
| iimageCube | gl_int_image_cube | TextureCubeMap |
| iimage2DArray | gl_int_image_2d_array | Texture2DArray |
| uimage2D | GL_UNSIGNED_INT_IMAGE_2D | Texture2D |
| uimage3D | GL_UNSIGNED_INT_IMAGE_3D | Texture3D |
| uimageCube | GL_UNSIGNED_INT_IMAGE_CUBE | TextureCubeMap |
| uimage2DArray | GL_UNSIGNED_INT_IMAGE_2D_ARRAY | Texture2DArray |
OpenGL ES 3.2는 다음과 같은 OpenGL ES 3.1 이미지 유형뿐만 아니라 모든 이미지 유형을 지원합니다:
| GLSL 유형 | OpenGL 유형 열거형 | 텍스처 유형 |
|---|---|---|
| 이미지 버퍼 | gl_image_buffer | TextureBuffer |
| imageCubeArray | gl_image_cube_map_array | TextureCubeMapArray |
| iimageBuffer | gl_image_buffer | TextureBuffer |
| iimageCubeArray | GL_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
| uimageBuffer | GL_UNSIGNED_INT_IMAGE_BUFFER | TextureBuffer |
| uimageCubeArray | GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY | TextureCubeMapArray |
예상되는 사용법은 다음과 같습니다:
import Qt3D.Render 2.14
Entity {
...
Texture2D {
id: tex2D
...
}
Material {
parameters: Parameter {
name: "imageUniformName"
value: ShaderImage {
texture: tex2D
}
}
...
}
...
}프로퍼티 문서
access : enumeration |
셰이더 인스턴스에서 이미지로 허용할 액세스 유형을 지정합니다. 셰이더가 호환되지 않는 액세스 권한이 있는 이미지에서 쓰거나 읽으려는 경우 동작이 정의되지 않습니다.
| Constant | 설명 |
|---|---|
ShaderImage.ReadOnly | 읽기 전용 액세스. |
ShaderImage.WriteOnly | 쓰기 전용 액세스. |
ShaderImage.ReadWrite | 읽기-쓰기 액세스. |
기본값은 ShaderImage.ReadWrite입니다.
format : enumeration |
셰이더에서 ShaderImage 에 값을 저장할 때 기본적으로 중요한 이미지 형식을 지정합니다.
이 형식은 참조된 텍스처의 형식과 동일할 필요는 없습니다. 그러나 호환 가능해야 합니다(크기는 일치해야 하지만 반드시 클래스 유형별로 일치할 필요는 없음). 예를 들어 R32F(크기 32비트, 클래스 1x32) 포맷의 텍스처를 RGBA8I(크기 32비트, 클래스 4x8) 포맷의 이미지와 함께 사용할 수 있습니다. OpenGL 사양의 표 8.27에는 지원되는 모든 이미지 포맷의 크기와 클래스가 나와 있습니다.
기본적으로 Qt3D는 참조된 텍스처의 이미지 형식과 일치하도록 이미지 형식을 설정하려고 시도합니다.
기본값은 ShaderImage.Automatic입니다.
layer : int |
참조 텍스처 중 ShaderImage 에 사용할 레이어를 보유합니다. layered 이 true로 설정되어 있거나 참조 텍스처의 유형이 레이어와 호환되지 않는 경우 이 프로퍼티는 아무 작업도 수행하지 않습니다.
참고: 참조 텍스처가 큐브 맵 또는 큐브 맵 배열 유형이고 ĺayered 이 false로 설정된 경우 다음과 같은 방식으로 얼굴과 레이어가 검색됩니다:
cubeMapLayer = layer / 6 cubeMapFace = layer - (cubeMapLayer * 6)
기본값은 0입니다.
layered : bool |
*
참으로 설정하면 참조된 텍스처가 1차원 배열, 2차원 배열, 3차원, 큐브 맵, 큐브 맵 배열 또는 2차원 다중 샘플 배열 텍스처인 경우 모든 레이어에 대해 전체 레벨이 바인딩됩니다. false로 설정하면 layer 속성으로 지정된 단일 레이어만 바인딩됩니다.
기본값은 false 입니다.
mipLevel : int |
참조된 텍스처 중 어느 mipLevel을 ShaderImage 에 사용할지 보유합니다.
기본값은 0입니다.
© 2025 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.
