QOpenGLTexture Class

// Prepare texture
QOpenGLTexture *texture = new QOpenGLTexture(QImage(fileName).mirrored());
texture->setMinificationFilter(QOpenGLTexture::LinearMipMapLinear);
texture->setMagnificationFilter(QOpenGLTexture::Linear);
...
// Render with texture
texture->bind();
glDrawArrays(...);

メンバー関数ドキュメント

[explicit] QOpenGLTexture::QOpenGLTexture(QOpenGLTexture::Target target)

後にtarget にバインドできる QOpenGLTexture オブジェクトを作成します。

これは、基礎となるOpenGLテクスチャオブジェクトを作成しません。したがって、このコンストラクタを使用した構築では、有効な現在のOpenGLコンテキストは必要ありません。

[explicit] QOpenGLTexture::QOpenGLTexture(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

後に 2D テクスチャターゲットにバインドできる QOpenGLTexture オブジェクトを作成し、image に含まれるピクセルデータを含みます。ミップマップのチェーンを生成させたい場合は、genMipMaps をtrue に設定してください（これがデフォルトです）。

これは、基礎となるOpenGLテクスチャオブジェクトを作成します。したがって、このコンストラクタを使用した構築には、有効な現在のOpenGLコンテキストが必要です。

void QOpenGLTexture::allocateStorage()

フォーマット、寸法、ミップマップレベル、配列レイヤー、およびキューブマップ面を考慮して、このテクスチャオブジェクトのためのサーバー側ストレージを割り当てます。

ストレージが割り当てられると、これらのプロパティを変更することはできなくなります。

サポートされている場合、QOpenGLTexture は不変テクスチャストレージを使用します。

ストレージがテクスチャに割り当てられると、setData() オーバーロードのいずれかを使用してピクセルデータをアップロードできます。

isStorageAllocated() およびsetData()も参照 。

void QOpenGLTexture::allocateStorage(QOpenGLTexture::PixelFormat pixelFormat, QOpenGLTexture::PixelType pixelType)

フォーマット、寸法、ミップマップレベル、配列レイヤー、およびキューブマップ面を考慮して、このテクスチャオブジェクトのためのサーバー側ストレージを割り当てます。

ストレージが割り当てられると、これらのプロパティを変更することはできなくなります。

サポートされている場合、QOpenGLTexture は不変テクスチャストレージを使用します。しかし、不変のテクスチャストレージが利用できない場合、指定されたpixelFormat とpixelType は、変更可能なストレージを割り当てるために使用されます。特定の OpenGL 実装（特に、OpenGL ES 2）では、これらは、後続のsetData() 呼び出しに渡される形式と型に完全に一致しなければならないことに注意してください。

一旦ストレージがテクスチャのために割り当てられると、ピクセルデータはsetData() のオーバーロードのいずれかを介してアップロードすることができます。

isStorageAllocated() およびsetData()も参照してください 。

void QOpenGLTexture::bind()

このテクスチャを現在アクティブなテクスチャユニットにバインドし、レンダリングの準備をします。この実装では、EXT_direct_state_access 拡張が利用可能な場合はそれを利用し、そうでない場合はそれをシミュレートするので、QOpenGLTexture オブジェクトを変更するためにバインドする必要はないことに注意してください。

release()も参照 。

void QOpenGLTexture::bind(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

このテクスチャをレンダリング準備の整ったテクスチャユニットunit にバインドします。実装では、EXT_direct_state_access 拡張が利用可能な場所ではそれを利用し、利用できない場所ではそれをシミュレートするので、QOpenGLTexture オブジェクトを変更するためにバインドする必要はないことに注意してください。

パラメータreset がtrue の場合、この関数はアクティブなユニットを、入力時にアクティブだったテクスチャユニットに戻す。

release()も参照 。

QColor QOpenGLTexture::borderColor() const

このテクスチャの borderColor を返します。

setBorderColor()も参照してください 。

void QOpenGLTexture::borderColor(float *border) const

border が指す配列の最初の4つの要素にテクスチャのボーダーカラーを書き込みます。

setBorderColor()も参照 。

void QOpenGLTexture::borderColor(int *border) const

テクスチャのボーダーカラーを、border が指す配列の最初の4つの要素に書き込みます。

これはオーバーロードされた関数です。

void QOpenGLTexture::borderColor(unsigned int *border) const

テクスチャのボーダーカラーを、border が指す配列の最初の4つの要素に書き込みます。

これはオーバーロードされた関数です。

[static] GLuint QOpenGLTexture::boundTextureId(QOpenGLTexture::BindingTarget target)

現在アクティブなテクスチャユニットのtarget にバインドされているテクスチャのtextureId を返します。

[static] GLuint QOpenGLTexture::boundTextureId(uint unit, QOpenGLTexture::BindingTarget target)

テクスチャユニットunit のtarget にバインドされているテクスチャのtextureId を返します。

QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

このテクスチャに設定されているテクスチャ比較演算子を返します。デフォルトでは、テクスチャはCompareLessEqual 比較関数を持ちます。

setComparisonFunction()も参照してください 。

QOpenGLTexture::ComparisonMode QOpenGLTexture::comparisonMode() const

このテクスチャに設定されているテクスチャ比較モードを返します。デフォルトでは、テクスチャはCompareNone 比較モードを持ちます（つまり、比較は無効です）。

setComparisonMode()も参照してください 。

bool QOpenGLTexture::create()

基礎となるOpenGLテクスチャオブジェクトを作成します。これには現在有効なOpenGLコンテキストが必要です。テクスチャオブジェクトがすでに存在する場合、この関数は何もしません。

テクスチャオブジェクトが作成されると、textureId （）関数からオブジェクト名を得ることができます。これは、このテクスチャに関連する未加工のOpenGLコールを行いたい場合に便利です。

通常、テクスチャオブジェクトのプロパティを設定するすべての関数は、暗黙的にあなたの代わりにcreate()を呼び出すので、この関数を直接呼び出す必要はありません。

作成に成功した場合はtrue を返し、そうでない場合はfalse を返します。

destroy()、isCreated()、textureId()も参照してください 。

QOpenGLTexture *QOpenGLTexture::createTextureView(QOpenGLTexture::Target target, QOpenGLTexture::TextureFormat viewFormat, int minimumMipmapLevel, int maximumMipmapLevel, int minimumLayer, int maximumLayer) const

このテクスチャにテクスチャ・ビューを作成しようとします。テクスチャ・ビューは、元のデータの制限された、または再解釈されたビューを提示するという点で、SQLのビューに多少似ています。テクスチャビューはサーバー側のストレージを割り当てず、ソーステクスチャのストレージバッファに依存します。

テクスチャ ビューは、イミュータブル ストレージを使用している場合にのみ使用できます。テクスチャビューの詳細については、http://www.opengl.org/wiki/Texture_Storage#Texture_views を参照してください。

target 引数は、ビューに使用するターゲットを指定します。元のターゲットのターゲットに応じて、いくつかのターゲットだけが使用できます。例えば、Target1DArray テクスチャへのビューは、Target1DArray またはTarget1D のいずれかを指定できますが、後者の場合、minimumLayer とmaximumLayer で指定される配列レイヤーの数は正確に 1 でなければなりません。

viewFormat 。詳細は上記のリンクと仕様を参照してください。

minimumMipmapLevel 、maximumMipmapLevel 、minimumLayer 、maximumLayer の引数は、テクスチャビューがアクセスできるテクスチャの部分を制限する役割を果たします。

テクスチャビューの作成に失敗した場合、この関数は0を返します。この関数が成功すると、isTextureView() 関数からtrue を返す新しいQOpenGLTexture オブジェクトへのポインタが返されます。

isTextureView()も参照してください 。

int QOpenGLTexture::depth() const

3D テクスチャの深度を返します。

width()、height() およびsetSize()も参照してください 。

QOpenGLTexture::DepthStencilMode QOpenGLTexture::depthStencilMode() const

深度/ステンシル複合フォーマットを使用するテクスチャの深度ステンシルモードを返します。

setDepthStencilMode()も参照してください 。

void QOpenGLTexture::destroy()

基礎となるOpenGLテクスチャオブジェクトを破棄します。これには現在有効なOpenGLコンテキストが必要です。

create(),isCreated(),textureId()も参照してください 。

int QOpenGLTexture::faces() const

このテクスチャの面の数を返します。cubemap および cubemap array タイプのターゲットの場合、これは 6 になります。

非キューブマップタイプのターゲットの場合、これは1を返します。

QOpenGLTexture::TextureFormat QOpenGLTexture::format() const

このテクスチャオブジェクトのフォーマットを返します。

setFormat()も参照してください 。

void QOpenGLTexture::generateMipMaps()

このテクスチャオブジェクトのミップマップをミップマップレベル 0 から生成します。ミップマップを必要とするテクスチャターゲットとフィルタリングオプションを使用していて、自動ミップマップ生成を無効にしている場合は、この関数またはオーバーロードを呼び出してミップマップチェインを生成する必要があります。

setAutoMipMapGenerationEnabled(),setMipLevels(),mipLevels()も参照してください 。

void QOpenGLTexture::generateMipMaps(int baseLevel, bool resetBaseLevel = true)

このテクスチャオブジェクトのミップマップをミップマップレベルbaseLevel から生成します。ミップマップを必要とするテクスチャターゲットとフィルタリングオプションを使用していて、自動ミップマップ生成を無効にしている場合は、この関数またはオーバーロードを呼び出してミップマップチェインを生成する必要があります。

baseLevel 以上へのミップマップの生成は、ミップマップのベースレベルをbaseLevel に設定してからミップマップチェインを生成することで実現します。resetBaseLevel がtrue の場合、テクスチャのベースレベルは以前の値にリセットされます。

setAutoMipMapGenerationEnabled()、setMipLevels()、mipLevels()も参照してください 。

[static] bool QOpenGLTexture::hasFeature(QOpenGLTexture::Feature feature)

OpenGLの実装とバージョンがテクスチャ機能をサポートしている場合、true を返すfeature 。

int QOpenGLTexture::height() const

2D または 3D テクスチャの高さを返します。

width()、depth() およびsetSize()も参照してください 。

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

このテクスチャオブジェクトに対して自動ミップマップ生成が有効かどうかを返します。

setAutoMipMapGenerationEnabled() およびgenerateMipMaps()も参照して ください。

bool QOpenGLTexture::isBound() const

このテクスチャが現在アクティブなテクスチャユニットの対応するターゲットにバインドされている場合、true を返します。

bind() およびrelease()も参照してください 。

bool QOpenGLTexture::isBound(uint unit)

このテクスチャがテクスチャユニットunit の対応するターゲットにバインドされている場合、true を返します。

bind() およびrelease()も参照してください 。

bool QOpenGLTexture::isCreated() const

基礎となるOpenGLテクスチャオブジェクトが作成された場合、true を返す。

create(),destroy(),textureId()も参照してください 。

bool QOpenGLTexture::isFixedSamplePositions() const

このテクスチャがマルチサンプルサンプルの固定パターンを使用するかどうかを返します。このテクスチャに対してストレージがまだ割り当てられていない場合、この関数は要求された固定サンプル位置設定を返します。

マルチサンプリングをサポートしないテクスチャターゲットの場合、これはtrue を返します。

setFixedSamplePositions() およびisStorageAllocated()も参照してください 。

bool QOpenGLTexture::isStorageAllocated() const

このテクスチャのサーバー側ストレージが割り当てられた場合、true を返します。

テクスチャのフォーマット、寸法、ミップマップレベル、および配列レイヤは、ストレージ i が割り当てられた後は変更できません。

allocateStorage()、setSize()、setMipLevels()、setLayers()、setFormat()も参照 。

bool QOpenGLTexture::isTextureView() const

このテクスチャオブジェクトが実際に別のテクスチャオブジェクトへのビューである場合、true を返します。

createTextureView()も参照してください 。

int QOpenGLTexture::layers() const

このテクスチャの配列レイヤの数を返します。このテクスチャに対してまだストレージが割り当てられていない場合、この関数は要求された配列レイヤの数を返します。

アレイレイヤーをサポートしていないテクスチャターゲットの場合、これは 1 を返します。

setLayers() およびisStorageAllocated()も参照してください 。

QPair<float, float> QOpenGLTexture::levelOfDetailRange() const

詳細度パラメータの最小値と最大値を返す。

setLevelOfDetailRange()、minimumLevelOfDetail() およびmaximumLevelOfDetail()も参照 。

float QOpenGLTexture::levelofDetailBias() const

詳細度バイアスパラメータを返します。

setLevelofDetailBias()も参照 。

QOpenGLTexture::Filter QOpenGLTexture::magnificationFilter() const

倍率フィルタを返します。

setMagnificationFilter()も参照 。

float QOpenGLTexture::maximumAnisotropy() const

テクスチャのルックアップを実行するときに考慮される異方性の最大レベルを返します。これには GL_EXT_texture_filter_anisotropic 拡張が必要です。

setMaximumAnisotropy()も参照してください 。

float QOpenGLTexture::maximumLevelOfDetail() const

パラメータの最大詳細レベルを返します。

setMaximumLevelOfDetail()、minimumLevelOfDetail() およびlevelOfDetailRange()も参照 。

int QOpenGLTexture::maximumMipLevels() const

このテクスチャが現在の寸法で持つことができるミップマップレベルの最大数を返します。

setMipLevels()、mipLevels() およびsetSize()も参照してください 。

QPair<QOpenGLTexture::Filter, QOpenGLTexture::Filter> QOpenGLTexture::minMagFilters() const

現在の最小化・拡大フィルタを返します。

setMinMagFilters()も参照ください 。

QOpenGLTexture::Filter QOpenGLTexture::minificationFilter() const

最小化フィルタを返します。

setMinificationFilter()も参照ください 。

float QOpenGLTexture::minimumLevelOfDetail() const

パラメータの最小詳細レベルを返します。

setMinimumLevelOfDetail()、maximumLevelOfDetail() およびlevelOfDetailRange()も参照 。

int QOpenGLTexture::mipBaseLevel() const

このテクスチャのすべてのテクスチャ参照に使用されるミップマップのベースレベルを返します。デフォルトは 0 です。

setMipBaseLevel()、mipMaxLevel()、mipLevelRange()も参照してください 。

QPair<int, int> QOpenGLTexture::mipLevelRange() const

このテクスチャでテクスチャ参照に使用できるミップマップレベルの範囲を返します。

setMipLevelRange(),mipBaseLevel(),mipMaxLevel()も参照してください 。

int QOpenGLTexture::mipLevels() const

このテクスチャのミップマップレベルの数を返します。このテクスチャに対してまだストレージが割り当てられていない場合は、要求されたミップマップレベル数を返します。

setMipLevels()、maximumMipLevels()、isStorageAllocated()も参照してください 。

int QOpenGLTexture::mipMaxLevel() const

このテクスチャのすべてのテクスチャ参照に使用されるミップマップの最大レベルを返します。

setMipMaxLevel(),mipBaseLevel(),mipLevelRange()も参照してください 。

void QOpenGLTexture::release()

現在アクティブなテクスチャユニットからこのテクスチャのバインドを解除します。

bind()も参照してください 。

void QOpenGLTexture::release(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

このテクスチャをテクスチャユニットunit からアンバインドします。

パラメータreset がtrue の場合、この関数はアクティブなユニットを、入力時にアクティブだったテクスチャユニットに戻します。

int QOpenGLTexture::samples() const

このテクスチャのマルチサンプルサンプルポイントの数を返します。このテクスチャに対してまだストレージが割り当てられていない場合、この関数は要求されたサンプル数を返します。

マルチサンプリングをサポートしていないテクスチャターゲットの場合、これは 0 を返します。

setSamples() およびisStorageAllocated()も参照してください 。

void QOpenGLTexture::setAutoMipMapGenerationEnabled(bool enabled)

enabled がtrue の場合、レベル 0 のミップマップデータがsetData() で設定されるたびに、このテクスチャオブジェクトの自動ミップマップ生成を有効にします。

自動ミップマップ生成はデフォルトで有効になっています。

isAutoMipMapGenerationEnabled() およびgenerateMipMaps()も参照して ください。

void QOpenGLTexture::setBorderColor(const QColor &color)

テクスチャのボーダーカラーをcolor に設定します。

borderColor()も参照してください 。

void QOpenGLTexture::setBorderColor(float r, float g, float b, float a)

赤をr に、緑をg に、青をb に、そしてa をアルファ値に設定する。

これはオーバーロードされた関数です。

void QOpenGLTexture::setBorderColor(int r, int g, int b, int a)

色の赤をr に、緑をg に、青をb に、アルファ値をa に設定します。

これはオーバーロードされた関数です。

void QOpenGLTexture::setBorderColor(uint r, uint g, uint b, uint a)

色の赤をr に、緑をg に、青をb に、アルファ値をa に設定します。

これはオーバーロードされた関数です。

void QOpenGLTexture::setComparisonFunction(QOpenGLTexture::ComparisonFunction function)

このテクスチャのテクスチャ比較関数をfunction に設定します。 テクスチャ比較関数は、深度テクスチャをサンプリングするときにシャドウサンプラによって使用されます。

comparisonFunction()も参照してください 。

void QOpenGLTexture::setComparisonMode(QOpenGLTexture::ComparisonMode mode)

このテクスチャのテクスチャ比較モードをmode に設定します。 テクスチャ比較モードは、深度テクスチャをサンプリングするときにシャドウサンプラによって使用されます。

comparisonMode()も参照してください 。

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

圧縮ピクセルdata をmipLevel 、配列layer 、およびcubeFace にアップロードする。ピクセルの転送は、オプションでoptions で制御できる。引数dataSize には、data が指すデータのサイズを指定する。

圧縮format() を使用しない場合は、この関数の代わりにsetData() を使用する。

void QOpenGLTexture::setCompressedData(int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数である。

void QOpenGLTexture::setCompressedData(int mipLevel, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数である。

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数である。

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int layerCount, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数です。

パラメータlayerCount は、この呼び出しによってアップロード/入力されるテクスチャ配列内のレイヤーの数です。

void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

このテクスチャオブジェクトmipLevel 、配列layer 、およびcubeFace のピクセルdata をアップロードします。ピクセルデータをアップロードする前に、ストレージが割り当てられている必要があります。setData()のいくつかのオーバーロードは、適切な寸法、ミップマップレベル、および配列レイヤを設定し、それを行うのに十分な情報がある場合は、ストレージを割り当ててくれます。これは関数のドキュメントに記載されています。

data が指すピクセルデータの構造は、sourceFormat とsourceType で指定される。ピクセルデータのアップロードは、オプションとしてoptions で制御することができる。

圧縮されたformat() を使用する場合は、この関数の代わりにsetCompressedData() を使用する必要がある。

setCompressedData()も参照 。

void QOpenGLTexture::setData(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

setData()のこのオーバーロードは、あなたのためにストレージを確保する。ピクセルデータはimage に格納されます。ミップマップはデフォルトで生成されます。ミップマップの生成をオフにするには、genMipMaps をDontGenerateMipMaps に設定します。

これはオーバーロードされた関数です。

void QOpenGLTexture::setData(QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数である。

void QOpenGLTexture::setData(int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数である。

void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数である。

void QOpenGLTexture::setData(int mipLevel, int layer, int layerCount, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数です。

パラメータlayerCount は、この呼び出しによってアップロード/入力されるテクスチャ配列内のレイヤーの数です。

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数です。

このオーバーロードは、テクスチャの一部を更新するために使用します。パラメータxOffset,yOffset,zOffset は、テクスチャ内のテクセルオフセットを指定します。パラメータwidth,height,depth は、サブイメージの寸法を指定します。

data が指すピクセルデータの構造は、sourceFormat とsourceType で指定します。ピクセルデータのアップロードは、オプションでoptions によって制御できます。

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数です。

このオーバーロードは、テクスチャの一部を更新するために使用します。パラメータxOffset,yOffset,zOffset は、テクスチャ内のテクセルオフセットを指定します。パラメータwidth,height,depth はサブイメージの寸法を指定します。更新したいサブイメージのミップマップレベルはmipLevel で指定します。

data が指すピクセルデータの構造は、sourceFormat とsourceType で指定します。ピクセルデータのアップロードは、オプションとしてoptions で制御できます。

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数です。

このオーバーロードは、テクスチャの一部を更新するために使用します。パラメータxOffset,yOffset,zOffset は、テクスチャ内のテクセルオフセットを指定します。パラメータwidth,height およびdepth は、サブイメージの寸法を指定します。更新したいサブイメージのミップマップレベルとレイヤーは、mipLevel とlayer で指定します。

data が指すピクセルデータの構造は、sourceFormat とsourceType で指定します。ピクセルデータのアップロードは、オプションとしてoptions で制御できます。

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数です。

このオーバーロードは、テクスチャの一部を更新するために使用します。パラメータxOffset,yOffset,zOffset は、テクスチャ内のテクセルオフセットを指定します。width height depth 更新したいサブイメージのミップマップレベル、レイヤー、キューブマップ面は、mipLevel,layer,face で指定します。

data が指すピクセルデータの構造は、sourceFormat およびsourceType で指定します。ピクセルデータのアップロードは、オプションとしてoptions で制御できる。

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, int layerCount, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

これはオーバーロードされた関数です。

このオーバーロードは、テクスチャの一部を更新するために使用します。パラメータxOffset,yOffset,zOffset は、テクスチャ内のテクセルオフセットを指定します。width height depth 更新したいサブイメージのミップマップレベル、開始レイヤー、キューブマップ面、レイヤー数は、mipLevel,layer,face,layerCount で指定します。

data が指すピクセルデータの構造は、sourceFormat とsourceType で指定します。ピクセルデータのアップロードは、オプションとしてoptions で制御できます。

void QOpenGLTexture::setDepthStencilMode(QOpenGLTexture::DepthStencilMode mode)

深度／ステンシル形式を組み合わせたテクスチャを使用する場合、 この関数はテクスチャのどのコンポーネントにアクセスするかをmode に設定します。

パラメータがDepthMode に設定されている場合、シェーダからアクセスすると、通常通り、1つの float として depth コンポーネントにアクセスします。しかし、パラメータがStencilMode に設定されると、 シェーダはステンシルコンポーネントにアクセスします。

depthStencilMode()も参照してください 。

void QOpenGLTexture::setFixedSamplePositions(bool fixed)

マルチサンプル対応テクスチャターゲットで使用するサンプル位置とサンプル数をfixed に設定します。true に設定すると、使用するサンプル位置とサンプル数は画像内のすべてのテクセルで同じになり、画像サイズや内部フォーマットに依存しません。この関数は、テクスチャ用にストレージが割り当てられる前に呼び出す必要があります。

マルチサンプリングをサポートしないターゲットでは、この関数は何の効果もありません。

デフォルト値はtrue です。

isFixedSamplePositions() およびisStorageAllocated()も参照してください 。

void QOpenGLTexture::setFormat(QOpenGLTexture::TextureFormat format)

このテクスチャオブジェクトのフォーマットをformat に設定します。 この関数は、テクスチャストレージが割り当てられる前に呼び出す必要があります。

すべてのフォーマットがサポートされているとは限らないことに注意してください。サポートされるフォーマットの正確なセットは、OpenGLの実装とバージョンに依存します。

format() およびallocateStorage()も参照してください 。

void QOpenGLTexture::setLayers(int layers)

ストレージを割り当てる配列layers の数を設定します。この関数は、ストレージがテクスチャ用に割り当てられる前に呼び出される必要があります。

配列レイヤーをサポートしないターゲットでは、この関数は何の効果もありません。

layers() およびisStorageAllocated()も参照してください 。

void QOpenGLTexture::setLevelOfDetailRange(float min, float max)

詳細パラメータの最小レベルをmin に、最大レベルをmax に設定します。

levelOfDetailRange(),setMinimumLevelOfDetail(),setMaximumLevelOfDetail()も参照してください 。

void QOpenGLTexture::setLevelofDetailBias(float bias)

詳細レベルの偏りをbias に設定する。レベルオブディテールバイアスは、ミップマッピングレベルが変化するポイントに影響します。詳細度バイアスの値を大きくすると、画像全体がぼやけたり滑らかになったりします。値を下げると、画像全体がシャープになります。

levelofDetailBias()も参照してください 。

void QOpenGLTexture::setMagnificationFilter(QOpenGLTexture::Filter filter)

拡大フィルタをfilter に設定する。

magnificationFilter(),setMinificationFilter(),setMinMagFilters()も参照 。

void QOpenGLTexture::setMaximumAnisotropy(float anisotropy)

OpenGL実装がGL_EXT_texture_filter_anisotropic拡張をサポートしている場合、この関数は最大異方性レベルをanisotropy に設定します。

maximumAnisotropy()も参照してください 。

void QOpenGLTexture::setMaximumLevelOfDetail(float value)

最大詳細レベルをvalue に設定する。 これにより、最低解像度のミップマップ（最高ミップマップレベル）の選択が制限される。デフォルト値は1000です。

maximumLevelOfDetail(),setMinimumLevelOfDetail(),setLevelOfDetailRange()も参照してください 。

void QOpenGLTexture::setMinMagFilters(QOpenGLTexture::Filter minificationFilter, QOpenGLTexture::Filter magnificationFilter)

最小化フィルタをminificationFilter に、拡大フィルタをmagnificationFilter に設定する。

minMagFilters(),setMinificationFilter(),setMagnificationFilter()も参照 。

void QOpenGLTexture::setMinificationFilter(QOpenGLTexture::Filter filter)

最小化に使用するフィルタをfilter に設定します。

minificationFilter(),setMagnificationFilter(),setMinMagFilters()も参照 。

void QOpenGLTexture::setMinimumLevelOfDetail(float value)

最小詳細レベルをvalue に設定します。 これにより、最高解像度のミップマップ（最低ミップマップレベル）の選択が制限されます。デフォルト値は-1000です。

minimumLevelOfDetail(),setMaximumLevelOfDetail(),setLevelOfDetailRange()も参照してください 。

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

このテクスチャのすべてのテクスチャ参照に使用されるベースミップマップレベルをbaseLevel に設定します。

mipBaseLevel(),setMipMaxLevel(),setMipLevelRange()も参照してください 。

void QOpenGLTexture::setMipLevelRange(int baseLevel, int maxLevel)

このテクスチャでテクスチャのルックアップに使用できるミップマップレベルの範囲をbaseLevel からmaxLevel の範囲に設定します。

setMipBaseLevel(),setMipMaxLevel(),mipLevelRange()も参照してください 。

void QOpenGLTexture::setMipLevels(int levels)

ミップマップをサポートするテクスチャターゲットに対して、この関数はストレージを割り当てるミップマップlevels の要求数を設定します。この関数は、ストレージがテクスチャのために割り当てられる前に呼び出されるべきです。

テクスチャターゲットがミップマップをサポートしていない場合、この関数は何の効果もありません。

mipLevels()、maximumMipLevels()、isStorageAllocated()も参照してください 。

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

このテクスチャのすべてのテクスチャ参照に使用される最大ミップマップレベルをmaxLevel に設定します。

mipMaxLevel(),setMipBaseLevel(),setMipLevelRange()も参照してください 。

void QOpenGLTexture::setSamples(int samples)

マルチサンプル対応テクスチャターゲットにレンダリングするときに、ストレージを割り当てるsamples の数を設定します。この関数は、テクスチャ用にストレージが割り当てられる前に呼び出す必要があります。

マルチサンプリングをサポートしないターゲットに対しては、この関数は何の効果もありません。

samples() およびisStorageAllocated()も参照してください 。

void QOpenGLTexture::setSize(int width, int height = 1, int depth = 1)

このテクスチャオブジェクトの寸法をwidth 、height 、depth に設定します。各寸法のデフォルトは 1 です。許容される最大テクスチャサイズは、OpenGL の実装に依存します。システムがリソース不足の場合、最大サイズ未満のテクスチャにストレージを割り当てても失敗することがあります。

非2乗width 、height またはdepth が提供され、OpenGL 実装が非2乗テクスチャの繰り返しをサポートしていない場合、ラップモードは自動的にClampToEdge に設定されます。

width()、height()、depth()も参照してください 。

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleComponent component, QOpenGLTexture::SwizzleValue value)

GLSLシェーダは、テクスチャ関数によって返されるvec4のコンポーネントを並べ替えることができます。また、CPU側のコードからこの並べ替えを制御できることが望ましい。これは、OpenGL 3.3以降のスウィズルマスクによって可能になりました。

テクスチャの各コンポーネントは、SwizzleValue オプションの1つにマッピングできます。

この関数はcomponent を出力value にマッピングします。

swizzleMask()も参照してください 。

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleValue r, QOpenGLTexture::SwizzleValue g, QOpenGLTexture::SwizzleValue b, QOpenGLTexture::SwizzleValue a)

パラメータr,g,b,a は、色の赤、緑、青、アルファ値を設定するための値です。

これはオーバーロードされた関数です。

void QOpenGLTexture::setWrapMode(QOpenGLTexture::WrapMode mode)

すべてのテクスチャ寸法のラップ（またはリピートモード）をmode に設定します。

wrapMode()も参照してください 。

void QOpenGLTexture::setWrapMode(QOpenGLTexture::CoordinateDirection direction, QOpenGLTexture::WrapMode mode)

テクスチャ寸法direction を保持します。

これはオーバーロードされた関数です。

QOpenGLTexture::SwizzleValue QOpenGLTexture::swizzleMask(QOpenGLTexture::SwizzleComponent component) const

テクスチャcomponent のスウィズルマスクを返します。

setSwizzleMask()も参照してください 。

QOpenGLTexture::Target QOpenGLTexture::target() const

このテクスチャのバインディングターゲットを返します。

GLuint QOpenGLTexture::textureId() const

基礎となるOpenGLテクスチャオブジェクトの名前を返すか、まだ作成されていない場合は0を返す。

create(),destroy(),isCreated()も参照してください 。

int QOpenGLTexture::width() const

1D、2D、または 3D テクスチャの幅を返します。

height(),depth(),setSize()も参照 。

QOpenGLTexture::WrapMode QOpenGLTexture::wrapMode(QOpenGLTexture::CoordinateDirection direction) const

テクスチャ寸法direction のラップモードを返します。

setWrapMode()も参照してください 。