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 テクスチャターゲットにバインドでき、image に含まれるピクセルデータを含む QOpenGLTexture オブジェクトを作成します。ミップマップのチェーンを生成させたい場合は、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 配列タイプのターゲットの場合、これは 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の実装とバージョンがテクスチャ機能feature をサポートしている場合、true を返します。

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 を返します。

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

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 テクスチャオブジェクトの名前を返します。

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

int QOpenGLTexture::width() const

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

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

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

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

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