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(...);

Dokumentation der Mitgliedsfunktionen

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

Erzeugt ein QOpenGLTexture-Objekt, das später an target gebunden werden kann.

Das zugrundeliegende OpenGL-Textur-Objekt wird dabei nicht erzeugt. Daher erfordert die Konstruktion mit diesem Konstruktor keinen gültigen aktuellen OpenGL-Kontext.

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

Erzeugt ein QOpenGLTexture-Objekt, das später an das 2D-Textur-Ziel gebunden werden kann und die in image enthaltenen Pixeldaten enthält. Wenn Sie eine Kette von Mipmaps generieren lassen möchten, setzen Sie genMipMaps auf true (dies ist die Voreinstellung).

Dadurch wird das zugrundeliegende OpenGL-Texturobjekt erstellt. Daher erfordert die Konstruktion mit diesem Konstruktor einen gültigen aktuellen OpenGL-Kontext.

void QOpenGLTexture::allocateStorage()

Weist serverseitigen Speicher für dieses Texturobjekt zu, wobei Format, Abmessungen, Mipmap-Ebenen, Array-Ebenen und Cubemap-Flächen berücksichtigt werden.

Sobald der Speicherplatz zugewiesen wurde, können diese Eigenschaften nicht mehr geändert werden.

Wenn QOpenGLTexture unterstützt wird, wird ein unveränderlicher Texturspeicher verwendet.

Sobald der Speicher für die Textur zugewiesen wurde, können die Pixeldaten über eine der Überladungen setData() hochgeladen werden.

Siehe auch isStorageAllocated() und setData().

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

Weist serverseitigen Speicher für dieses Texturobjekt zu, wobei Format, Abmessungen, Mipmap-Ebenen, Array-Ebenen und Cubemap-Flächen berücksichtigt werden.

Sobald der Speicherplatz zugewiesen wurde, können diese Eigenschaften nicht mehr geändert werden.

Wenn QOpenGLTexture unterstützt wird, wird unveränderlicher Texturspeicher verwendet. Wenn jedoch kein unveränderlicher Texturspeicher verfügbar ist, werden die angegebenen pixelFormat und pixelType verwendet, um veränderbaren Speicher zuzuweisen; beachten Sie, dass sie in bestimmten OpenGL-Implementierungen (insbesondere OpenGL ES 2) perfekt mit dem Format und dem Typ übereinstimmen müssen, die an jeden nachfolgenden setData()-Aufruf übergeben werden.

Sobald der Speicher für die Textur zugewiesen wurde, können die Pixeldaten über eine der setData()-Überladungen hochgeladen werden.

Siehe auch isStorageAllocated() und setData().

void QOpenGLTexture::bind()

Bindet diese Textur an die gerade aktive Textureinheit, die zum Rendern bereit ist. Beachten Sie, dass Sie keine QOpenGLTexture -Objekte binden müssen, um sie zu ändern, da die Implementierung die EXT_direct_state_access-Erweiterung nutzt, wo sie verfügbar ist, und sie simuliert, wo sie nicht verfügbar ist.

Siehe auch release().

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

Bindet diese Textur an die Textureinheit unit, die für das Rendering bereit ist. Beachten Sie, dass Sie keine QOpenGLTexture Objekte binden müssen, um sie zu ändern, da die Implementierung die EXT_direct_state_access-Erweiterung nutzt, wo sie verfügbar ist, und sie simuliert, wo sie nicht verfügbar ist.

Wenn der Parameter reset gleich true ist, setzt diese Funktion die aktive Einheit auf die Textureinheit zurück, die bei der Eingabe aktiv war.

Siehe auch release().

QColor QOpenGLTexture::borderColor() const

Gibt die borderColor dieser Textur zurück.

Siehe auch setBorderColor().

void QOpenGLTexture::borderColor(float *border) const

Schreibt die Randfarbe der Textur in die ersten vier Elemente des Arrays, auf das border zeigt.

Siehe auch setBorderColor().

void QOpenGLTexture::borderColor(int *border) const

Schreibt die Randfarbe der Textur in die ersten vier Elemente des Arrays, auf das border zeigt.

Dies ist eine überladene Funktion.

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

Schreibt die Randfarbe der Textur in die ersten vier Elemente des Arrays, auf das border zeigt.

Dies ist eine überladene Funktion.

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

Gibt die textureId der Textur zurück, die an die target der derzeit aktiven Textureinheit gebunden ist.

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

Gibt die textureId der Textur zurück, die an die target der Textureinheit unit gebunden ist.

QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

Gibt den Texturvergleichsoperator zurück, der für diese Textur festgelegt wurde. Standardmäßig hat eine Textur eine CompareLessEqual Vergleichsfunktion.

Siehe auch setComparisonFunction().

QOpenGLTexture::ComparisonMode QOpenGLTexture::comparisonMode() const

Gibt den für diese Textur eingestellten Vergleichsmodus zurück. Standardmäßig hat eine Textur den Vergleichsmodus CompareNone (d. h. Vergleiche sind deaktiviert).

Siehe auch setComparisonMode().

bool QOpenGLTexture::create()

Erzeugt das zugrunde liegende OpenGL-Texturobjekt. Dies erfordert einen aktuellen gültigen OpenGL-Kontext. Wenn das Texturobjekt bereits existiert, bewirkt diese Funktion nichts.

Sobald das Texturobjekt erstellt ist, können Sie den Objektnamen von der Funktion textureId() erhalten. Dies kann nützlich sein, wenn Sie einige rohe OpenGL-Aufrufe im Zusammenhang mit dieser Textur machen wollen.

Normalerweise sollte es nicht notwendig sein, diese Funktion direkt aufzurufen, da alle Funktionen, die Eigenschaften des Texturobjekts setzen, implizit create() in Ihrem Namen aufrufen.

Gibt true zurück, wenn die Erstellung erfolgreich war, andernfalls false.

Siehe auch destroy(), isCreated(), und textureId().

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

Versucht, eine Texturansicht auf diese Textur zu erstellen. Eine Texturansicht ist in gewisser Weise mit einer Ansicht in SQL vergleichbar, da sie eine eingeschränkte oder neu interpretierte Ansicht der Originaldaten darstellt. Texturansichten weisen keinen weiteren serverseitigen Speicherplatz zu, sondern greifen auf den Speicherpuffer der Ausgangstextur zurück.

Texturansichten sind nur verfügbar, wenn unveränderlicher Speicher verwendet wird. Für weitere Informationen über Texturansichten siehe http://www.opengl.org/wiki/Texture_Storage#Texture_views.

Das Argument target gibt das Ziel an, das für die Ansicht verwendet werden soll. Nur einige Ziele können verwendet werden, abhängig von dem Ziel des ursprünglichen Ziels. Zum Beispiel kann eine Ansicht auf eine Target1DArray Textur entweder Target1DArray oder Target1D spezifizieren, aber für letzteres muss die Anzahl der mit minimumLayer und maximumLayer spezifizierten Array-Ebenen genau 1 sein.

Ähnliche Einschränkungen gelten für viewFormat. Siehe den obigen Link und die Spezifikation für weitere Details.

Die Argumente minimumMipmapLevel, maximumMipmapLevel, minimumLayer und maximumLayer dienen dazu, die Teile der Textur einzuschränken, auf die die Texturansicht zugreifen kann.

Wenn die Erstellung der Texturansicht fehlschlägt, gibt diese Funktion 0 zurück. Wenn die Funktion erfolgreich ist, gibt sie einen Zeiger auf ein neues QOpenGLTexture Objekt zurück, das true von seiner isTextureView() Funktion zurückgibt.

Siehe auch isTextureView().

int QOpenGLTexture::depth() const

Gibt die Tiefe einer 3D-Textur zurück.

Siehe auch width(), height(), und setSize().

QOpenGLTexture::DepthStencilMode QOpenGLTexture::depthStencilMode() const

Gibt den Tiefenschablonenmodus für Texturen zurück, die ein kombiniertes Tiefen-/Schablonenformat verwenden.

Siehe auch setDepthStencilMode().

void QOpenGLTexture::destroy()

Zerstört das zugrunde liegende OpenGL-Texturobjekt. Dies erfordert einen aktuellen gültigen OpenGL-Kontext.

Siehe auch create(), isCreated(), und textureId().

int QOpenGLTexture::faces() const

Gibt die Anzahl der Flächen für diese Textur zurück. Bei Zielen vom Typ cubemap und cubemap array ist dies 6.

Für Ziele, die nicht vom Typ cubemap sind, wird 1 zurückgegeben.

QOpenGLTexture::TextureFormat QOpenGLTexture::format() const

Gibt das Format dieses Texturobjekts zurück.

Siehe auch setFormat().

void QOpenGLTexture::generateMipMaps()

Erzeugt Mipmaps für dieses Texturobjekt ab Mipmap-Ebene 0. Wenn Sie ein Texturziel und eine Filteroption verwenden, die Mipmaps erfordern, und Sie die automatische Mipmap-Generierung deaktiviert haben, müssen Sie diese Funktion oder die Überladung aufrufen, um die Mipmap-Kette zu erstellen.

Siehe auch setAutoMipMapGenerationEnabled(), setMipLevels(), und mipLevels().

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

Erzeugt Mipmaps für dieses Texturobjekt aus der Mipmap-Ebene baseLevel. Wenn Sie ein Texturziel und eine Filteroption verwenden, die Mipmaps erfordern, und Sie die automatische Mipmap-Generierung deaktiviert haben, müssen Sie diese Funktion oder die Überladung aufrufen, um die Mipmap-Kette zu erstellen.

Die Erzeugung von Mipmaps oberhalb von baseLevel wird erreicht, indem die Mipmap-Basisebene auf baseLevel gesetzt und dann die Mipmap-Kette erzeugt wird. Wenn resetBaseLevel gleich true ist, wird der BaseLevel der Textur auf seinen vorherigen Wert zurückgesetzt.

Siehe auch setAutoMipMapGenerationEnabled(), setMipLevels(), und mipLevels().

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

Gibt true zurück, wenn Ihre OpenGL-Implementierung und Version die Texturfunktion feature unterstützt.

int QOpenGLTexture::height() const

Gibt die Höhe einer 2D- oder 3D-Textur zurück.

Siehe auch width(), depth(), und setSize().

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

Gibt zurück, ob die automatische Erzeugung von Mipmaps für dieses Texturobjekt aktiviert ist.

Siehe auch setAutoMipMapGenerationEnabled() und generateMipMaps().

bool QOpenGLTexture::isBound() const

Gibt true zurück, wenn diese Textur an das entsprechende Ziel der derzeit aktiven Textureinheit gebunden ist.

Siehe auch bind() und release().

bool QOpenGLTexture::isBound(uint unit)

Gibt true zurück, wenn diese Textur an das entsprechende Ziel der Textureinheit unit gebunden ist.

Siehe auch bind() und release().

bool QOpenGLTexture::isCreated() const

Gibt true zurück, wenn das zugrunde liegende OpenGL-Texturobjekt erstellt wurde.

Siehe auch create(), destroy(), und textureId().

bool QOpenGLTexture::isFixedSamplePositions() const

Gibt zurück, ob diese Textur ein festes Muster von Multisample-Samples verwendet. Wenn für diese Textur noch kein Speicherplatz zugewiesen wurde, gibt diese Funktion die angeforderte Einstellung für die feste Sampleposition zurück.

Bei Texturzielen, die kein Multisampling unterstützen, gibt diese Funktion true zurück.

Siehe auch setFixedSamplePositions() und isStorageAllocated().

bool QOpenGLTexture::isStorageAllocated() const

Gibt true zurück, wenn der serverseitige Speicher für diese Textur zugewiesen wurde.

Das Texturformat, die Abmessungen, die Mipmap-Ebenen und die Array-Ebenen können nicht mehr geändert werden, sobald der Speicherplatz zugewiesen wurde.

Siehe auch allocateStorage(), setSize(), setMipLevels(), setLayers(), und setFormat().

bool QOpenGLTexture::isTextureView() const

Gibt true zurück, wenn dieses Texturobjekt tatsächlich eine Ansicht auf ein anderes Texturobjekt ist.

Siehe auch createTextureView().

int QOpenGLTexture::layers() const

Gibt die Anzahl der Array-Ebenen für diese Textur zurück. Wenn für diese Textur noch kein Speicherplatz zugewiesen wurde, gibt diese Funktion die angeforderte Anzahl von Array-Layern zurück.

Für Texturziele, die keine Array-Layer unterstützen, wird 1 zurückgegeben.

Siehe auch setLayers() und isStorageAllocated().

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

Liefert den minimalen und maximalen Detaillierungsgrad der Parameter.

Siehe auch setLevelOfDetailRange(), minimumLevelOfDetail(), und maximumLevelOfDetail().

float QOpenGLTexture::levelofDetailBias() const

Gibt den Bias-Parameter für die Detailgenauigkeit zurück.

Siehe auch setLevelofDetailBias().

QOpenGLTexture::Filter QOpenGLTexture::magnificationFilter() const

Gibt den Vergrößerungsfilter zurück.

Siehe auch setMagnificationFilter().

float QOpenGLTexture::maximumAnisotropy() const

Gibt den maximalen Grad der Anisotropie zurück, der bei der Durchführung von Textur-Lookups zu berücksichtigen ist. Dies erfordert die Erweiterung GL_EXT_texture_filter_anisotropic.

Siehe auch setMaximumAnisotropy().

float QOpenGLTexture::maximumLevelOfDetail() const

Gibt den Parameter für die maximale Detailebene zurück.

Siehe auch setMaximumLevelOfDetail(), minimumLevelOfDetail(), und levelOfDetailRange().

int QOpenGLTexture::maximumMipLevels() const

Gibt die maximale Anzahl von Mipmap-Ebenen zurück, die diese Textur bei den aktuellen Abmessungen haben kann.

Siehe auch setMipLevels(), mipLevels(), und setSize().

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

Gibt die aktuellen Verkleinerungs- und Vergrößerungsfilter zurück.

Siehe auch setMinMagFilters().

QOpenGLTexture::Filter QOpenGLTexture::minificationFilter() const

Gibt den Minifizierungsfilter zurück.

Siehe auch setMinificationFilter().

float QOpenGLTexture::minimumLevelOfDetail() const

Gibt den Parameter für die kleinste Detailstufe zurück.

Siehe auch setMinimumLevelOfDetail(), maximumLevelOfDetail(), und levelOfDetailRange().

int QOpenGLTexture::mipBaseLevel() const

Gibt die Mipmap-Basisebene zurück, die für alle Textur-Lookups mit dieser Textur verwendet wird. Die Vorgabe ist 0.

Siehe auch setMipBaseLevel(), mipMaxLevel(), und mipLevelRange().

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

Gibt den Bereich der Mipmap-Ebenen zurück, der für Textur-Lookups mit dieser Textur verwendet werden kann.

Siehe auch setMipLevelRange(), mipBaseLevel(), und mipMaxLevel().

int QOpenGLTexture::mipLevels() const

Gibt die Anzahl der Mipmap-Ebenen für diese Textur zurück. Wenn für diese Textur noch kein Speicherplatz zugewiesen wurde, wird die angeforderte Anzahl der Mipmap-Ebenen zurückgegeben.

Siehe auch setMipLevels(), maximumMipLevels(), und isStorageAllocated().

int QOpenGLTexture::mipMaxLevel() const

Gibt den maximalen Mipmap-Level zurück, der für alle Textur-Lookups mit dieser Textur verwendet wird.

Siehe auch setMipMaxLevel(), mipBaseLevel(), und mipLevelRange().

void QOpenGLTexture::release()

Bindet diese Textur von der derzeit aktiven Textureinheit ab.

Siehe auch bind().

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

Bindet diese Textur von der Textureinheit unit ab.

Wenn der Parameter reset true ist, dann stellt diese Funktion die aktive Einheit auf die Textureinheit zurück, die bei der Eingabe aktiv war.

int QOpenGLTexture::samples() const

Gibt die Anzahl der Multisample-Samplepunkte für diese Textur zurück. Wenn für diese Textur noch kein Speicherplatz zugewiesen wurde, gibt diese Funktion die angeforderte Anzahl von Samples zurück.

Bei Texturzielen, die kein Multisampling unterstützen, gibt diese Funktion 0 zurück.

Siehe auch setSamples() und isStorageAllocated().

void QOpenGLTexture::setAutoMipMapGenerationEnabled(bool enabled)

Wenn enabled gleich true ist, wird die automatische Mipmap-Generierung für dieses Texturobjekt aktiviert, sobald die Mipmap-Daten der Ebene 0 über setData() gesetzt werden.

Die automatische Mipmap-Generierung ist standardmäßig aktiviert.

Siehe auch isAutoMipMapGenerationEnabled() und generateMipMaps().

void QOpenGLTexture::setBorderColor(const QColor &color)

Setzt die Randfarbe der Textur auf color.

Siehe auch borderColor().

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

Setzt die Farbe Rot auf r, Grün auf g, Blau auf b und a auf den Alpha-Wert.

Dies ist eine überladene Funktion.

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

Setzt die Farbe Rot auf r, Grün auf g, Blau auf b, und den Alphawert auf a.

Dies ist eine überladene Funktion.

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

Setzt die Farbe Rot auf r, Grün auf g, Blau auf b, und den Alphawert auf a.

Dies ist eine überladene Funktion.

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

Setzt die Texturvergleichsfunktion für diese Textur auf function. Die Texturvergleichsfunktion wird von Schattensamplern beim Sampling einer Tiefentextur verwendet.

Siehe auch comparisonFunction().

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

Setzt den Texturvergleichsmodus für diese Textur auf mode. Der Texturvergleichsmodus wird von Schattensamplern verwendet, wenn eine Tiefentextur gesampelt wird.

Siehe auch comparisonMode().

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

Lädt komprimierte Pixel data auf mipLevel, array layer und cubeFace hoch. Die Übertragung der Pixel kann optional mit options gesteuert werden. Das Argument dataSize sollte die Größe der Daten angeben, auf die data verweist.

Wenn Sie kein komprimiertes format() verwenden, sollten Sie setData() anstelle dieser Funktion benutzen.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

Parameter layerCount ist die Anzahl der Ebenen in einem Textur-Array, die durch diesen Aufruf hochgeladen/aufgefüllt werden.

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

Lädt Pixel data für dieses Texturobjekt mipLevel, Array layer und cubeFace hoch. Vor dem Hochladen von Pixeldaten muss Speicher zugewiesen worden sein. Einige Überladungen von setData() setzen die entsprechenden Dimensionen, Mipmap-Ebenen und Array-Ebenen und weisen Ihnen dann Speicherplatz zu, wenn sie über genügend Informationen verfügen, um dies zu tun. Dies wird in der Funktionsdokumentation vermerkt.

Die Struktur der Pixeldaten, auf die data verweist, wird durch sourceFormat und sourceType festgelegt. Der Upload der Pixeldaten kann optional durch options gesteuert werden.

Wenn Sie eine komprimierte format() verwenden, sollten Sie setCompressedData() anstelle dieser Funktion benutzen.

Siehe auch setCompressedData().

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

Diese Überladung von setData() wird Ihnen Speicherplatz zuweisen. Die Pixeldaten sind in image enthalten. Mipmaps werden standardmäßig erzeugt. Setzen Sie genMipMaps auf DontGenerateMipMaps, um die Mipmap-Generierung zu deaktivieren.

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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

Dies ist eine überladene Funktion.

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)

Dies ist eine überladene Funktion.

Parameter layerCount ist die Anzahl der Ebenen in einem Textur-Array, die durch diesen Aufruf hochgeladen/aufgefüllt werden.

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)

Dies ist eine überladene Funktion.

Diese Überladung wird verwendet, um einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset, zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Dimensionen des Teilbildes an.

Die Struktur der Pixeldaten, auf die data verweist, wird durch sourceFormat und sourceType festgelegt. Der Upload der Pixeldaten kann optional durch options gesteuert werden.

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)

Dies ist eine überladene Funktion.

Diese Überladung wird verwendet, um einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset, zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Abmessungen des Teilbildes an. Die Mip-Map-Ebene des Teilbildes, das aktualisiert werden soll, wird mit mipLevel angegeben.

Die Struktur der Pixeldaten, auf die data verweist, wird durch sourceFormat und sourceType festgelegt. Der Upload der Pixeldaten kann optional über options gesteuert werden.

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)

Dies ist eine überladene Funktion.

Diese Überladung wird verwendet, um einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset, zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Abmessungen des Teilbildes an. Die Mip-Map-Ebene und die Ebene des Teilbildes, das aktualisiert werden soll, werden mit mipLevel und layer angegeben.

Die Struktur der Pixeldaten, auf die data verweist, wird durch sourceFormat und sourceType festgelegt. Der Upload der Pixeldaten kann optional über options gesteuert werden.

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)

Dies ist eine überladene Funktion.

Diese Überladung wird verwendet, um einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset, zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Dimensionen des Teilbildes an. mipLevel, layer und face spezifizieren die Mip-Map-Ebene, den Layer und die Cube-Map-Fläche des Teilbildes, das aktualisiert werden soll.

Die Struktur der Pixeldaten, auf die data verweist, wird durch sourceFormat und sourceType festgelegt. Der Upload der Pixeldaten kann optional über options gesteuert werden.

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)

Dies ist eine überladene Funktion.

Diese Überladung wird verwendet, um einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset, zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Dimensionen des Teilbildes an. mipLevel, layer, face und layerCount spezifizieren die Mip-Map-Ebene, die Startebene, die Cube-Map-Fläche und die Anzahl der Ebenen des Teilbildes, das aktualisiert werden soll.

Die Struktur der Pixeldaten, auf die data verweist, wird durch sourceFormat und sourceType festgelegt. Der Upload der Pixeldaten kann optional über options gesteuert werden.

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

Wenn Sie eine Textur mit einem kombinierten Tiefen-/Schablonenformat verwenden, legt diese Funktion fest, welche Komponente der Textur auf mode zugegriffen wird.

Wenn der Parameter auf DepthMode gesetzt ist, erfolgt der Zugriff vom Shader auf die Tiefenkomponente wie üblich als einzelne Gleitkommazahl. Wenn der Parameter jedoch auf StencilMode gesetzt ist, greift der Shader auf die Stencil-Komponente zu.

Siehe auch depthStencilMode().

void QOpenGLTexture::setFixedSamplePositions(bool fixed)

Legt fest, ob die Sample-Positionen und die Anzahl der Samples, die mit einem Multisample-fähigen Textur-Ziel verwendet werden, auf fixed gesetzt werden. Wenn auf true gesetzt, sind die Sample-Positionen und die Anzahl der verwendeten Samples für alle Texel im Bild gleich und hängen nicht von der Bildgröße oder dem internen Format ab. Diese Funktion sollte aufgerufen werden, bevor Speicherplatz für die Textur zugewiesen wird.

Bei Zielen, die kein Multisampling unterstützen, hat diese Funktion keine Wirkung.

Der Standardwert ist true.

Siehe auch isFixedSamplePositions() und isStorageAllocated().

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

Setzt das Format dieses Texturobjekts auf format. Diese Funktion muss aufgerufen werden, bevor Texturspeicher zugewiesen wird.

Beachten Sie, dass möglicherweise nicht alle Formate unterstützt werden. Die genaue Menge der unterstützten Formate hängt von Ihrer OpenGL-Implementierung und -Version ab.

Siehe auch format() und allocateStorage().

void QOpenGLTexture::setLayers(int layers)

Legt die Anzahl der Arrays layers fest, für die Speicherplatz zugewiesen werden soll. Diese Funktion sollte aufgerufen werden, bevor Speicher für die Textur zugewiesen wird.

Für Ziele, die keine Array-Ebenen unterstützen, hat diese Funktion keine Wirkung.

Siehe auch layers() und isStorageAllocated().

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

Setzt die Parameter für die minimale Detailstufe auf min und die maximale Stufe auf max.

Siehe auch levelOfDetailRange(), setMinimumLevelOfDetail(), und setMaximumLevelOfDetail().

void QOpenGLTexture::setLevelofDetailBias(float bias)

Setzt die Detailgenauigkeit auf bias. Die Detailgenauigkeit beeinflusst den Punkt, an dem sich die Mapping-Ebenen ändern. Wenn Sie die Werte für die Detailgenauigkeit erhöhen, werden die Bilder insgesamt unschärfer oder weicher. Verringern Sie die Werte, werden die Bilder insgesamt schärfer.

Siehe auch levelofDetailBias().

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

Setzt den Vergrößerungsfilter auf filter.

Siehe auch magnificationFilter(), setMinificationFilter(), und setMinMagFilters().

void QOpenGLTexture::setMaximumAnisotropy(float anisotropy)

Wenn Ihre OpenGL-Implementierung die Erweiterung GL_EXT_texture_filter_anisotropic unterstützt, setzt diese Funktion den maximalen Anisotropiegrad auf anisotropy.

Siehe auch maximumAnisotropy().

void QOpenGLTexture::setMaximumLevelOfDetail(float value)

Legt den maximalen Detailgrad auf value fest. Dies begrenzt die Auswahl der Mipmap mit der niedrigsten Auflösung (höchster Mipmap-Level). Der Standardwert ist 1000.

Siehe auch maximumLevelOfDetail(), setMinimumLevelOfDetail(), und setLevelOfDetailRange().

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

Setzt den Verkleinerungsfilter auf minificationFilter und den Vergrößerungsfilter auf magnificationFilter.

Siehe auch minMagFilters(), setMinificationFilter(), und setMagnificationFilter().

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

Setzt den für die Minifizierung verwendeten Filter auf filter.

Siehe auch minificationFilter(), setMagnificationFilter(), und setMinMagFilters().

void QOpenGLTexture::setMinimumLevelOfDetail(float value)

Setzt die minimale Detailebene auf value. Dies begrenzt die Auswahl der Mipmap mit der höchsten Auflösung (niedrigste Mipmap-Ebene). Der Standardwert ist -1000.

Siehe auch minimumLevelOfDetail(), setMaximumLevelOfDetail(), und setLevelOfDetailRange().

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

Setzt die Basis-Mipmap-Ebene, die für alle Textur-Lookups mit dieser Textur verwendet wird, auf baseLevel.

Siehe auch mipBaseLevel(), setMipMaxLevel(), und setMipLevelRange().

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

Setzt den Bereich der Mipmap-Ebenen, die für Textur-Lookups mit dieser Textur verwendet werden können, auf einen Bereich von baseLevel bis maxLevel.

Siehe auch setMipBaseLevel(), setMipMaxLevel(), und mipLevelRange().

void QOpenGLTexture::setMipLevels(int levels)

Für Textur-Ziele, die Mipmaps unterstützen, setzt diese Funktion die angeforderte Anzahl von Mipmaps levels, für die Speicher zugewiesen werden soll. Diese Funktion sollte aufgerufen werden, bevor Speicher für die Textur zugewiesen wird.

Wenn das Texturziel keine Mipmaps unterstützt, hat diese Funktion keine Wirkung.

Siehe auch mipLevels(), maximumMipLevels(), und isStorageAllocated().

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

Setzt den maximalen Mipmap-Level, der für alle Textur-Lookups mit dieser Textur verwendet wird, auf maxLevel.

Siehe auch mipMaxLevel(), setMipBaseLevel(), und setMipLevelRange().

void QOpenGLTexture::setSamples(int samples)

Legt die Anzahl der samples fest, für die beim Rendern auf ein Multisample-fähiges Texturziel Speicherplatz zugewiesen werden soll. Diese Funktion sollte aufgerufen werden, bevor Speicherplatz für die Textur zugewiesen wird.

Für Ziele, die kein Multisampling unterstützen, hat diese Funktion keine Wirkung.

Siehe auch samples() und isStorageAllocated().

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

Setzt die Abmessungen dieses Texturobjekts auf width, height und depth. Der Standardwert für jede Dimension ist 1. Die maximal zulässige Texturgröße ist abhängig von Ihrer OpenGL-Implementierung. Die Zuweisung von Speicherplatz für eine Textur, die kleiner als die maximale Größe ist, kann immer noch fehlschlagen, wenn Ihr System über wenig Ressourcen verfügt.

Wenn eine Nicht-Power-of-Two-Textur width, height oder depth bereitgestellt wird und Ihre OpenGL-Implementierung keine Unterstützung für die Wiederholung von Nicht-Power-of-Two-Texturen hat, dann wird der Wrap-Modus automatisch auf ClampToEdge gesetzt.

Siehe auch width(), height(), und depth().

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

GLSL-Shader sind in der Lage, die Komponenten des von Texturfunktionen zurückgegebenen vec4 neu zu ordnen. Es ist auch wünschenswert, diese Neuordnung von CPU-seitigem Code aus steuern zu können. Dies wird seit OpenGL 3.3 durch Swizzle-Masken ermöglicht.

Jede Komponente der Textur kann auf eine der SwizzleValue Optionen abgebildet werden.

Diese Funktion ordnet component der Ausgabe value zu.

Siehe auch swizzleMask().

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

Die Parameter r, g, b und a sind Werte, die für die Einstellung der Farben Rot, Grün, Blau und des Alphawertes verwendet werden.

Dies ist eine überladene Funktion.

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

Setzt den Umbruch (oder Wiederholungsmodus) für alle Texturabmessungen auf mode.

Siehe auch wrapMode().

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

Enthält die Texturabmessungen direction.

Dies ist eine überladene Funktion.

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

Gibt die Swizzle-Maske für die Textur component zurück.

Siehe auch setSwizzleMask().

QOpenGLTexture::Target QOpenGLTexture::target() const

Gibt das Bindungsziel dieser Textur zurück.

GLuint QOpenGLTexture::textureId() const

Gibt den Namen des zugrunde liegenden OpenGL-Texturobjekts zurück oder 0, wenn es noch nicht erstellt wurde.

Siehe auch create(), destroy(), und isCreated().

int QOpenGLTexture::width() const

Gibt die Breite einer 1D-, 2D- oder 3D-Textur zurück.

Siehe auch height(), depth(), und setSize().

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

Gibt den Umbruchmodus für die Texturabmessung direction zurück.

Siehe auch setWrapMode().