QOpenGLTexture Class

// Prepare texture
QOpenGLTexture *texture = new QOpenGLTexture(QImage(fileName).flipped());
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()

このテクスチャを、現在アクティブなテクスチャユニットにバインドし、レンダリングの準備を整えます。なお、QOpenGLTexture オブジェクトを変更するために、それらをバインドする必要はありません。これは、実装が利用可能な場合はEXT_direct_state_access拡張機能を利用し、利用できない場合はそれをシミュレートするためです。

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

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

このテクスチャをテクスチャユニットunit にバインドし、レンダリングの準備を整えます。なお、QOpenGLTexture オブジェクトを変更するために、それらをバインドする必要はありません。これは、実装がEXT_direct_state_access拡張機能を利用可能な場合はそれを使用し、利用できない場合はそれをシミュレートするためです。

パラメータ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

このテクスチャの面数を返します。キューブマップおよびキューブマップ配列タイプのターゲットの場合、この値は 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 の場合、テクスチャの baseLevel は以前の値にリセットされます。

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()も参照してください 。

std::pair<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()も参照してください 。

std::pair<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()も参照してください 。

std::pair<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 の場合、setData()を介してレベル0のミップマップデータが設定されるたびに、このテクスチャオブジェクトに対して自動ミップマップ生成が行われるようになります。

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

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` に設定されている場合、シェーダーからアクセスすると、通常通り深度コンポーネントが単一の浮動小数点数としてアクセスされます。しかし、パラメータが `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の実装によって異なります。最大サイズ未満のテクスチャ用にメモリを割り当てても、システムのリソースが不足している場合は割り当てに失敗する可能性があります。

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

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

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

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

テクスチャの各成分は、SwizzleValue のオプションのいずれかにマッピングできます。

この関数は、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 のラップ（またはリピートモード）をmode に設定します。

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

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

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

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

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

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