Qt3DRender::QShaderImage Class

class Qt3DRender::QShaderImage

シェーダープログラムから画像にアクセスできるようにします。詳細...

ヘッダー:	`#include <qshaderimage.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS 3drender)` `target_link_libraries(mytarget PRIVATE Qt6::3drender)`
qmake:	`QT += 3drender`
QML内:	ShaderImage
継承元:	Qt3DCore::QNode
ステータス:	非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

継承されたメンバを含むすべてのメンバの一覧

パブリック型

enum	Access { ReadOnly, WriteOnly, ReadWrite }
enum	ImageFormat { NoFormat, Automatic, R8_UNorm, RG8_UNorm, RGBA8_UNorm, …, RGB10A2U }

プロパティ

access : Access
format : ImageFormat
layer : int

layered : bool
mipLevel : int
texture : Qt3DRender::QAbstractTexture*

パブリック関数

Qt3DRender::QShaderImage::Access	access() const
Qt3DRender::QShaderImage::ImageFormat	format() const
int	layer() const
bool	layered() const
int	mipLevel() const
Qt3DRender::QAbstractTexture *	texture() const

パブリックスロット

void	setAccess(Qt3DRender::QShaderImage::Access access)
void	setFormat(Qt3DRender::QShaderImage::ImageFormat format)
void	setLayer(int layer)
void	setLayered(bool layered)
void	setMipLevel(int mipLevel)
void	setTexture(Qt3DRender::QAbstractTexture *texture)

シグナル

void	accessChanged(Qt3DRender::QShaderImage::Access access)
void	formatChanged(Qt3DRender::QShaderImage::ImageFormat format)
void	layerChanged(int layer)
void	layeredChanged(bool layered)
void	mipLevelChanged(int mipLevel)
void	textureChanged(Qt3DRender::QAbstractTexture *texture)

詳細な説明

シェーダー内でテクスチャの内容を読み書きできるようにするには、それらを QShaderImage として公開する必要があります。テクスチャは、複数のミップレベル、レイヤー、およびフェイスで構成される場合があります。さらに、QShaderImage を宣言することで、テクスチャの内容のうち、どのレベル、レイヤー、またはフェイスにアクセスするかを指定することができます。

QShaderImageは、正常に機能するためにQParameter の値として割り当てられ、有効なQt3DRender::QAbstractTexture を参照している必要があります。

参照されるテクスチャが1次元配列、2次元配列、3次元、キューブマップ、キューブマップ配列、または2次元マルチサンプル配列テクスチャである場合、テクスチャレベル全体、あるいはそのテクスチャレベル内の単一のレイヤーやフェイスをバインドすることが可能です。これはlayered プロパティで制御できます。

QShaderImage のサポートは、OpenGL 4 でのみ完全に対応しており、OpenGL ES 3.1 および 3.2 では部分的にのみ対応しています。

OpenGL 4 では、以下の画像タイプがサポートされています：

GLSL タイプ	OpenGL 型列挙型	テクスチャタイプ
image1D	GL_IMAGE_1D	QTexture1D
image2D	GL_IMAGE_2D	QTexture2D
image3D	GL_IMAGE_3D	QTexture3D
image2DRect	GL_IMAGE_2D_RECT	QTextureRectangle
imageCube	GL_IMAGE_CUBE	QTextureCubeMap
imageBuffer	GL_IMAGE_BUFFER	QTextureBuffer
image1DArray	GL_IMAGE_1D_ARRAY	QTexture1DArray
image2DArray	GL_IMAGE_2D_ARRAYimageCubeArray	QTexture2DArray
imageCubeArray	GL_IMAGE_CUBE_MAP_ARRAY	QTextureCubeMapArray
image2DMS	GL_IMAGE_2D_MULTISAMPLE	QTexture2DMultisample
image2DMSArray	GL_IMAGE_2D_MULTISAMPLE_ARRAYimage1DMS	QTexture2DMultisampleArray
iimage1D	GL_INT_IMAGE_1D	QTexture1D
iimage2D	GL_INT_IMAGE_2D	QTexture2D
iimage3D	GL_INT_IMAGE_3D	QTexture3D
iimage2DRect	GL_INT_IMAGE_2D_RECT	QTextureRectangle
iimageCube	GL_INT_IMAGE_CUBE	QTextureCubeMap
iimageBuffer	GL_INT_IMAGE_BUFFER	QTextureBuffer
iimage1DArray	GL_INT_IMAGE_1D_ARRAY	QTexture1DArray
iimage2DArray	GL_INT_IMAGE_2D_ARRAY	QTexture2DArray
iimageCubeArray	GL_INT_IMAGE_CUBE_MAP_ARRAY	QTextureCubeMapArray
iimage2DMS	GL_INT_IMAGE_2D_MULTISAMPLE	QTexture2DMultisample
iimage2DMSArray	GL_INT_IMAGE_2D_MULTISAMPLE_ARRAYuimage1DMS	QTexture2DMultisampleArray
uimage1D	GL_UNSIGNED_INT_IMAGE_1D	QTexture1D
uimage2D	GL_UNSIGNED_INT_IMAGE_2D	QTexture2D
uimage3D	GL_UNSIGNED_INT_IMAGE_3D	QTexture3D
uimage2DRect	GL_UNSIGNED_INT_IMAGE_2D_RECT	QTextureRectangle
uimageCube	GL_UNSIGNED_INT_IMAGE_CUBE	QTextureCubeMap
uimageBuffer	GL_UNSIGNED_INT_IMAGE_BUFFER	QTextureBuffer
uimage1DArray	GL_UNSIGNED_INT_IMAGE_1D_ARRAY	QTexture1DArray
uimage2DArray	GL_UNSIGNED_INT_IMAGE_2D_ARRAY	QTexture2DArray
uimageCubeArray	GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY	QTextureCubeMapArray
uimage2DMS	GL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE	QTexture2DMultisample
uimage2DMSArray	GL_UNSIGNED_INT_IMAGE_2D_MULTISAMPLE_ARRAY	QTexture2DMultisampleArray

OpenGL ES 3.1 は、以下の画像タイプをサポートしています:

GLSL 型	OpenGL 型の列挙型	テクスチャ・タイプ
image2D	GL_IMAGE_2D	QTexture2D
image3D	GL_IMAGE_3D	QTexture3D
imageCube	GL_IMAGE_CUBE	QTextureCubeMap
image2DArray	GL_IMAGE_2D_ARRAY	QTexture2DArray
iimage2D	GL_INT_IMAGE_2D	QTexture2D
iimage3D	GL_INT_IMAGE_3D	QTexture3D
iimageCube	GL_INT_IMAGE_CUBE	QTextureCubeMap
iimage2DArray	GL_INT_IMAGE_2D_ARRAY	QTexture2DArray
uimage2D	GL_UNSIGNED_INT_IMAGE_2D	QTexture2D
uimage3D	GL_UNSIGNED_INT_IMAGE_3D	QTexture3D
uimageCube	GL_UNSIGNED_INT_IMAGE_CUBE	QTextureCubeMap
uimage2DArray	GL_UNSIGNED_INT_IMAGE_2D_ARRAY	QTexture2DArray

OpenGL ES 3.2 は、OpenGL ES 3.1 のすべての画像タイプに加え、以下のタイプもサポートしています。

GLSL 型	OpenGL 型列挙型	テクスチャ型
imageBuffer	GL_IMAGE_BUFFER	QTextureBuffer
imageCubeArray	GL_IMAGE_CUBE_MAP_ARRAY	QTextureCubeMapArray
iimageBuffer	GL_IMAGE_BUFFER	QTextureBuffer
iimageCubeArray	GL_INT_IMAGE_CUBE_MAP_ARRAYiimageBufferGL_IMAGE_BUFFERiimageCubeArray	QTextureCubeMapArray
uimageBuffer	GL_UNSIGNED_INT_IMAGE_BUFFER	QTextureBuffer
uimageCubeArray	GL_UNSIGNED_INT_IMAGE_CUBE_MAP_ARRAY	QTextureCubeMapArray

想定される使用例は次のようになります：

Qt3DRender::QTexture2D *tex2D = new Qt3DRender::QTexture2D();
...
Qt3DRender::QMaterial *material = new Qt3DRender::QMaterial();
...
Qt3DRender::QParameter *imageParameter = new Qt3DRender::QParameter();
Qt3DRender::QShaderImage *shaderImage = new Qt3DRender::QShaderImage();

shaderImage->setTexture(tex2D);

imageParameter->setName("imageUniformName");
imageParameter->setValue(QVariant::fromValue(shaderImage));

material->addParameter(imageParamenter);

メンバ型のドキュメント

enum QShaderImage::Access

定数	値	説明
`Qt3DRender::QShaderImage::ReadOnly`	`0`	画像はシェーダー内でのみ読み込まれます
`Qt3DRender::QShaderImage::WriteOnly`	`1`	シェーダーからのみ画像への書き込みが行われる
`Qt3DRender::QShaderImage::ReadWrite`	`2`	シェーダーからのみ読み書きが行われる

enum QShaderImage::ImageFormat

このリストには、利用可能なすべての画像形式が記載されています

定数	値	説明
`Qt3DRender::QShaderImage::NoFormat`	`0`	GL_NONE
`Qt3DRender::QShaderImage::Automatic`	`1`	Qt 3D 参照されるテクスチャに基づいて、フォーマットを自動的に判別しようとします。
`Qt3DRender::QShaderImage::R8_UNorm`	`0x8229`	GL_R8 (GLSL 型 r8、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG8_UNorm`	`0x822B`	GL_RG8 (GLSL 型 rg8、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA8_UNorm`	`0x8058`	GL_RGBA8 (GLSL タイプ rgba8、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R16_UNorm`	`0x822A`	GL_R16 (GLSL 型 r16、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG16_UNorm`	`0x822C`	GL_RG16 (GLSL 型 rg16、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA16_UNorm`	`0x805B`	GL_RGBA16 (GLSL 型 rgba16、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::R8_SNorm`	`0x8F94`	GL_R8_SNORM (GLSL 型 r8_snorm、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG8_SNorm`	`0x8F95`	GL_RG8_SNORM (GLSL 型 rg8_snorm、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA8_SNorm`	`0x8F97`	GL_RGBA8_SNORM (GLSL 型 rgba8_snorm、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R16_SNorm`	`0x8F98`	GL_R16_SNORM (GLSL 型 r16_snorm、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG16_SNorm`	`0x8F99`	GL_RG16_SNORM (GLSL 型 rg16_snorm、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA16_SNorm`	`0x8F9B`	GL_RGBA16_SNORM (GLSL 型 rgba16_snorm、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::R8U`	`0x8232`	GL_R8UI (GLSL 型 r8ui、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG8U`	`0x8238`	GL_RG8UI (GLSL 型 rg8ui、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA8U`	`0x8D7C`	GL_RGBA8UI (GLSL 型 rgba8ui、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R16U`	`0x8234`	GL_R16UI (GLSL 型 r16ui、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG16U`	`0x823A`	GL_RG16UI (GLSL 型 rg16ui、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA16U`	`0x8D76`	GL_RGBA16UI (GLSL 型 rgba16ui、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R32U`	`0x8236`	GL_R32UI (GLSL 型 r32ui、OpenGL 4.2 以降、OpenGL ES 3.1 でサポート)
`Qt3DRender::QShaderImage::RG32U`	`0x823C`	GL_RG32UI (GLSL 型 rg32ui、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA32U`	`0x8D70`	GL_RGBA32UI (GLSL 型 rgba32ui、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R8I`	`0x8231`	GL_R8I (GLSL 型 r8i、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG8I`	`0x8237`	GL_RG8I (GLSL 型 rg8i、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA8I`	`0x8D8E`	GL_RGBA8I (GLSL 型 rgba8i、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R16I`	`0x8233`	GL_R16I (GLSL 型 r16i、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG16I`	`0x8239`	GL_RG16I (GLSL 型 rg16i、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA16I`	`0x8D88`	GL_RGBA16I (GLSL 型 rgba16i、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R32I`	`0x8235`	GL_R32I (GLSL 型 r32i、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::RG32I`	`0x823B`	GL_RG32I (GLSL 型 rg32i、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA32I`	`0x8D82`	GL_RGBA32I (GLSL 型 rgba32i、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R16F`	`0x822D`	GL_R16F (GLSL 型 r16f、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RG16F`	`0x822F`	GL_RG16F (GLSL 型 rg16f、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA16F`	`0x881A`	GL_RGBA16F (GLSL 型 rgba16f、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::R32F`	`0x822E`	GL_R32F (GLSL 型 r32f、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::RG32F`	`0x8230`	GL_RG32F (GLSL 型 rg32f、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGBA32F`	`0x8814`	GL_RGBA32F (GLSL 型 rgba32f、OpenGL 4.2 以降、OpenGL ES 3.1 以降でサポート)
`Qt3DRender::QShaderImage::RG11B10F`	`0x8C3A`	GL_R11F_G11F_B10F (GLSL タイプ r11f_g11f_b10f、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGB10A2`	`0x8059`	GL_RGB10_A2 (GLSL 型 rgb10_a2、OpenGL 4.2 以降でサポート)
`Qt3DRender::QShaderImage::RGB10A2U`	`0x906F`	GL_RGB10_A2UI (GLSL 型 rgb10_a2ui、OpenGL 4.2 以降でサポート)

プロパティのドキュメント

access : Access

シェーダーインスタンスから画像に対して許可したいアクセスの種類を指定します。シェーダーが、互換性のないアクセス権を持つ画像への書き込みや読み取りを試みた場合、その挙動は未定義となります。

デフォルト値はQShaderImage::ReadWrite です。

アクセス関数：

Qt3DRender::QShaderImage::Access	access() const
void	setAccess(Qt3DRender::QShaderImage::Access access)

通知シグナル：

void	accessChanged(Qt3DRender::QShaderImage::Access access)

format : ImageFormat

画像形式を指定します。これは、シェーダーから「Image」に値を格納する際に極めて重要です。

このフォーマットは、参照されるテクスチャのフォーマットと同じである必要はありません。ただし、互換性がある必要があります（サイズは一致している必要がありますが、クラス型が一致している必要はありません）。たとえば、フォーマット R32F（サイズ 32 ビット、クラス 1x32）のテクスチャを、フォーマット RGBA8I（サイズ 32 ビット、クラス 4x8）の画像とともに使用することができます。OpenGL 仕様の表8.27 には、サポートされているすべての Image フォーマットのサイズとクラスが示されています。

デフォルトでは、Qt3Dは参照されるテクスチャのフォーマットに合わせて画像フォーマットを設定しようとします。

デフォルト値はQShaderImage::Automatic です。

アクセス関数：

Qt3DRender::QShaderImage::ImageFormat	format() const
void	setFormat(Qt3DRender::QShaderImage::ImageFormat format)

通知シグナル:

void	formatChanged(Qt3DRender::QShaderImage::ImageFormat format)

layer : int

QShaderImage に使用する参照テクスチャのレイヤーを指定します。layered がtrueに設定されている場合、または参照テクスチャのタイプがレイヤーと互換性がない場合、このプロパティは機能しません。

注：参照されるテクスチャのタイプが「キューブマップ」または「キューブマップ配列」であり、ĺayered がfalseに設定されている場合、面（face）とレイヤーは以下の方法で取得されます：

cubeMapLayer = layer / 6
cubeMapFace = layer - (cubeMapLayer * 6)

デフォルト値は 0 です。

アクセス関数：

int	layer() const
void	setLayer(int layer)

通知シグナル：

void	layerChanged(int layer)

layered : bool

true に設定した場合、参照されるテクスチャが 1 次元配列、2 次元配列、3 次元、キューブマップ、キューブマップ配列、または 2 次元マルチサンプル配列テクスチャである場合、レベル全体がすべてのレイヤーに対してバインドされます。false に設定した場合、layer プロパティで指定された単一のレイヤーのみがバインドされます。

デフォルト値は `false` です。

アクセス関数：

bool	layered() const
void	setLayered(bool layered)

通知シグナル：

void	layeredChanged(bool layered)

mipLevel : int

QShaderImage に対して、参照先のテクスチャのうちどのmipLevelを使用すべきかを指定します。

デフォルト値は 0 です。

アクセス関数：

int	mipLevel() const
void	setMipLevel(int mipLevel)

Notifierシグナル：

void	mipLevelChanged(int mipLevel)

texture : Qt3DRender::QAbstractTexture*

シェーダー画像で使用するテクスチャを保持します。

アクセス関数：

Qt3DRender::QAbstractTexture *	texture() const
void	setTexture(Qt3DRender::QAbstractTexture *texture)

通知シグナル:

void	textureChanged(Qt3DRender::QAbstractTexture *texture)

© 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.