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

Dokumentation der Member-Funktionen

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

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

Dabei wird das zugrunde liegende OpenGL-Texturobjekt nicht erstellt. Daher ist für die Erstellung mit diesem Konstruktor kein gültiger aktueller OpenGL-Kontext erforderlich.

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

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

Hierbei wird das zugrunde liegende OpenGL-Texturobjekt erstellt. Daher erfordert die Erstellung mit diesem Konstruktor einen gültigen aktuellen OpenGL-Kontext.

void QOpenGLTexture::allocateStorage()

Weist diesem Texturobjekt serverseitigen Speicherplatz zu, wobei das Format, die Abmessungen, die Mipmap-Ebenen, die Array-Ebenen und die Cubemap-Flächen berücksichtigt werden.

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

Sofern unterstützt, nutzt ` QOpenGLTexture ` unveränderlichen Texturspeicher.

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

Siehe auch ` isStorageAllocated()` und ` setData()`.

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

Weist diesem Texturobjekt serverseitigen Speicherplatz zu, wobei das Format, die Abmessungen, die Mipmap-Ebenen, die Array-Ebenen und die Cubemap-Flächen berücksichtigt werden.

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

Sofern unterstützt, nutzt ` QOpenGLTexture ` unveränderlichen Texturspeicher. Ist jedoch kein unveränderlicher Texturspeicher verfügbar, werden die angegebenen ` pixelFormat ` und ` pixelType ` zur Zuweisung von veränderlichem Speicher verwendet; beachten Sie, dass diese in bestimmten OpenGL-Implementierungen (insbesondere OpenGL ES 2) exakt mit dem Format und dem Typ übereinstimmen müssen, die an einen nachfolgenden Aufruf von ` setData()` übergeben werden.

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

Siehe auch „ isStorageAllocated()“ und „ setData()“.

void QOpenGLTexture::bind()

Bindet diese Textur an die derzeit aktive Textureinheit, sodass sie für das Rendering bereit ist. Beachten Sie, dass Sie Objekte vom Typ „ QOpenGLTexture “ nicht binden müssen, um sie zu ändern, da die Implementierung die Erweiterung „EXT_direct_state_access“ nutzt, sofern diese verfügbar ist, und sie simuliert, falls dies nicht der Fall ist.

Siehe auch „ release()“.

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

Bindet diese Textur an die Textureinheit „ unit “, sodass sie für das Rendering bereit ist. Beachten Sie, dass Sie Objekte vom Typ „ QOpenGLTexture “ nicht binden müssen, um sie zu ändern, da die Implementierung die Erweiterung „EXT_direct_state_access“ nutzt, sofern diese verfügbar ist, und sie simuliert, falls dies nicht der Fall ist.

Wenn der Parameter ` reset ` den Wert ` true ` hat, setzt diese Funktion die aktive Einheit auf die Textur-Einheit zurück, die beim Aufruf aktiv war.

Siehe auch release().

QColor QOpenGLTexture::borderColor() const

Gibt die Rahmenfarbe dieser Textur zurück.

Siehe auch „ setBorderColor()“.

void QOpenGLTexture::borderColor(float *border) const

Schreibt die Farbe des Texturrandes in die ersten vier Elemente des Arrays, auf das border verweist.

Siehe auch setBorderColor().

void QOpenGLTexture::borderColor(int *border) const

Schreibt die Farbe des Texturrandes in die ersten vier Elemente des Arrays, auf das border verweist.

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

Schreibt die Farbe des Texturrandes in die ersten vier Elemente des Arrays, auf das border verweist.

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

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

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

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

QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

Gibt den für diese Textur festgelegten Texturvergleichsoperator zurück. Standardmäßig verfügt eine Textur über eine Vergleichsfunktion vom Typ „ CompareLessEqual “.

Siehe auch ` setComparisonFunction()`.

QOpenGLTexture::ComparisonMode QOpenGLTexture::comparisonMode() const

Gibt den für diese Textur festgelegten Texturvergleichsmodus zurück. Standardmäßig ist für eine Textur der Vergleichsmodus „ CompareNone “ (d. h., Vergleiche sind deaktiviert) eingestellt.

Siehe auch „ setComparisonMode()“.

bool QOpenGLTexture::create()

Erstellt das zugrunde liegende OpenGL-Texturobjekt. Dazu ist ein aktuell gültiger OpenGL-Kontext erforderlich. Falls das Texturobjekt bereits existiert, führt diese Funktion keine Aktion aus.

Sobald das Texturobjekt erstellt ist, können Sie den Objektnamen über die Funktion ` textureId()` abrufen. Dies kann nützlich sein, wenn Sie einige direkte OpenGL-Aufrufe im Zusammenhang mit dieser Textur ausführen möchten.

Normalerweise sollte es nicht notwendig sein, diese Funktion direkt aufzurufen, da alle Funktionen, die Eigenschaften des Texturobjekts festlegen, implizit create() für Sie 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 für diese Textur zu erstellen. Eine Texturansicht ist insofern mit einer Ansicht in SQL vergleichbar, als sie eine eingeschränkte oder neu interpretierte Ansicht der Originaldaten darstellt. Texturansichten belegen keinen zusätzlichen serverseitigen Speicherplatz, sondern nutzen stattdessen den Speicherpuffer der Quelltextur.

Texturansichten sind nur bei Verwendung von unveränderlichem Speicher verfügbar. Weitere Informationen zu Texturansichten finden Sie unter http://www.opengl.org/wiki/Texture_Storage#Texture_views.

Das Argument „ target “ gibt das für die Ansicht zu verwendende Ziel an. Je nach dem Ziel der ursprünglichen Textur können nur bestimmte Ziele verwendet werden. Beispielsweise kann eine Ansicht auf eine „ Target1DArray “-Textur entweder „ Target1DArray “ oder „ Target1D “ angeben; im letzteren Fall muss die Anzahl der Array-Ebenen, die mit „ minimumLayer “ und „ maximumLayer “ angegeben werden, jedoch genau 1 betragen.

Ähnliche Einschränkungen gelten für die „ viewFormat “. Weitere Details finden Sie unter dem obigen Link und in der Spezifikation.

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

Schlägt die Erstellung der Texturansicht fehl, gibt diese Funktion 0 zurück. Bei erfolgreicher Ausführung gibt die Funktion einen Zeiger auf ein neues ` QOpenGLTexture `-Objekt zurück, das über seine Funktion ` isTextureView()` den Wert ` true ` 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 Tiefen-Stencil-Modus für Texturen zurück, die ein kombiniertes Tiefen-/Stencil-Format verwenden.

Siehe auch „ setDepthStencilMode()“.

void QOpenGLTexture::destroy()

Löscht das zugrunde liegende OpenGL-Texturobjekt. Dazu ist ein aktuell gültiger OpenGL-Kontext erforderlich.

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

int QOpenGLTexture::faces() const

Gibt die Anzahl der Flächen dieser Textur zurück. Bei Zielen vom Typ „Cubemap“ und „Cubemap-Array“ ist dieser Wert 6.

Bei Zielen, die nicht vom Typ „Cubemap“ sind, wird der Wert 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, beginnend mit Mipmap-Ebene 0. Wenn Sie ein Texturziel und eine Filteroption verwenden, die Mipmaps erfordern, und Sie die automatische Mipmap-Erzeugung 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 ausgehend von der Mipmap-Stufe baseLevel. Wenn Sie ein Texturziel und eine Filteroption verwenden, die Mipmaps erfordern, und Sie die automatische Mipmap-Erzeugung deaktiviert haben, müssen Sie diese Funktion oder die Überladung aufrufen, um die Mipmap-Kette zu erstellen.

Die Erzeugung von Mipmaps oberhalb von „ baseLevel “ erfolgt durch Setzen der Mipmap-Basisstufe auf „ baseLevel “ und anschließendes Erzeugen der Mipmap-Kette. Wenn „ resetBaseLevel “ den Wert „ true “ annimmt, wird die „baseLevel“-Einstellung der Textur auf ihren 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 Textur-Funktion „ 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 Mipmap-Erstellung 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 Speicher zugewiesen wurde, gibt diese Funktion die angeforderte Einstellung für die feste Sample-Position zurück.

Bei Texturzielen, die Multisampling nicht unterstützen, gibt diese Funktion „ true “ zurück.

Siehe auch „ setFixedSamplePositions()“ und „ isStorageAllocated()“.

bool QOpenGLTexture::isStorageAllocated() const

Gibt „ true “ zurück, wenn serverseitiger Speicherplatz für diese Textur zugewiesen wurde.

Das Texturformat, die Abmessungen, die Mipmap-Ebenen und die Array-Ebenen können nach der Zuweisung des Speicherplatzes nicht mehr geändert werden.

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 Speicher zugewiesen wurde, gibt diese Funktion die angeforderte Anzahl von Array-Ebenen zurück.

Bei Texturzielen, die keine Array-Ebenen unterstützen, wird hier 1 zurückgegeben.

Siehe auch setLayers() und isStorageAllocated().

std::pair<float, float> QOpenGLTexture::levelOfDetailRange() const

Gibt den minimalen und maximalen Detaillierungsgrad zurück.

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

float QOpenGLTexture::levelofDetailBias() const

Gibt den Parameter für die Detailgenauigkeitsverzerrung 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 Anisotropiegrad zurück, der bei der Texturabfrage berücksichtigt werden soll. Hierfür ist die Erweiterung GL_EXT_texture_filter_anisotropic erforderlich.

Siehe auch ` setMaximumAnisotropy()`.

float QOpenGLTexture::maximumLevelOfDetail() const

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

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

int QOpenGLTexture::maximumMipLevels() const

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

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

std::pair<QOpenGLTexture::Filter, QOpenGLTexture::Filter> QOpenGLTexture::minMagFilters() const

Gibt die aktuellen Filter für Verkleinerung und Vergrößerung 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 minimale Detailstufe zurück.

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

int QOpenGLTexture::mipBaseLevel() const

Gibt die Mipmap-Basisstufe zurück, die für alle Texturabfragen mit dieser Textur verwendet wird. Der Standardwert ist 0.

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

std::pair<int, int> QOpenGLTexture::mipLevelRange() const

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

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 Speicher zugewiesen wurde, wird die angeforderte Anzahl von Mipmap-Ebenen zurückgegeben.

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

int QOpenGLTexture::mipMaxLevel() const

Gibt die maximale Mipmap-Stufe zurück, die für alle Texturabrufe mit dieser Textur verwendet wird.

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

void QOpenGLTexture::release()

Löst die Verknüpfung dieser Textur mit der derzeit aktiven Textureinheit.

Siehe auch „ bind()“.

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

Löst die Verknüpfung dieser Textur mit der Textureinheit „ unit “.

Wenn der Parameter „ reset “ den Wert „ true “ hat, setzt diese Funktion die aktive Einheit auf die Textureinheit zurück, die beim Aufruf aktiv war.

int QOpenGLTexture::samples() const

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

Bei Texturzielen, die Multisampling nicht unterstützen, wird hier 0 zurückgegeben.

Siehe auch setSamples() und isStorageAllocated().

void QOpenGLTexture::setAutoMipMapGenerationEnabled(bool enabled)

Wenn „ enabled “ auf „ true “ gesetzt ist, wird die automatische Mipmap-Erstellung für dieses Texturobjekt aktiviert, sobald die Mipmap-Daten der Stufe 0 über „ setData()“ festgelegt werden.

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

Siehe auch „ isAutoMipMapGenerationEnabled “ () und „ generateMipMaps “ ().

void QOpenGLTexture::setBorderColor(const QColor &color)

Legt die Rahmenfarbe der Textur auf „ color “ fest.

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.

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 Alpha-Wert auf a.

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 Alpha-Wert auf a.

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

Setzt die Texturvergleichsfunktion für diese Textur auf „ function “. Die Texturvergleichsfunktion wird von Schatten-Samplern beim Abtasten einer Tiefentextur verwendet.

Siehe auch „ comparisonFunction()“.

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

Legt den Texturvergleichsmodus für diese Textur auf „ mode “ fest. Der Texturvergleichsmodus wird von Schatten-Samplern beim Abtasten einer Tiefentextur verwendet.

Siehe auch ` comparisonMode()`.

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

mipLevelLädt das komprimierte Pixel- data, das Array layer sowie cubeFace hoch. Die Pixelübertragung 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 anstelle dieser Funktion ` setData()` verwenden.

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)

Der Parameter „ layerCount “ gibt die Anzahl der Ebenen in einem Textur-Array an, die durch diesen Aufruf hochgeladen bzw. gefü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 die Pixel data für dieses Texturobjekt mipLevel, das Array layer und cubeFace hoch. Der Speicherplatz muss vor dem Hochladen der Pixeldaten zugewiesen worden sein. Einige Überladungen von setData() legen die entsprechenden Abmessungen, Mipmap-Ebenen und Array-Ebenen fest und weisen anschließend Speicherplatz für Sie zu, sofern sie über ausreichende Informationen dafür verfügen. Dies wird in der Funktionsdokumentation vermerkt.

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

Wenn Sie ein komprimiertes ` format()` verwenden, sollten Sie anstelle dieser Funktion ` setCompressedData()` nutzen.

Siehe auch setCompressedData().

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

Diese Überladung von setData() reserviert Speicherplatz für Sie. Die Pixeldaten sind in „ image “ enthalten. Mipmaps werden standardmäßig generiert. Setzen Sie „ genMipMaps “ auf „ DontGenerateMipMaps “, um die Mipmap-Generierung zu deaktivieren.

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)

Der Parameter „ layerCount “ gibt die Anzahl der Ebenen in einem Textur-Array an, die durch diesen Aufruf hochgeladen bzw. gefü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)

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

Die Struktur der Pixeldaten, auf die „ data “ verweist, wird durch „ sourceFormat “ und „ sourceType “ festgelegt. Das Hochladen 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)

Diese Überladung dient dazu, einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset und zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Abmessungen des Teilbildes an. Die Mipmap-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. Das Hochladen 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)

Diese Überladung dient dazu, einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset und zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth legen die Abmessungen des Teilbildes fest. Die Mipmap-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. Das Hochladen 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)

Diese Überladung dient dazu, einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset und zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Abmessungen des Teilbildes an. Die Mipmap-Ebene, die Ebene und die Cube-Map-Fläche des Teilbildes, das aktualisiert werden soll, werden mit mipLevel, layer und face angegeben.

Die Struktur der Pixeldaten, auf die „ data “ verweist, wird durch „ sourceFormat “ und „ sourceType “ festgelegt. Das Hochladen 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, int layer, QOpenGLTexture::CubeMapFace face, int layerCount, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

Diese Überladung dient dazu, einen Teil der Textur zu aktualisieren. Die Parameter xOffset, yOffset und zOffset geben die Texel-Offsets innerhalb der Textur an. Die Parameter width, height und depth geben die Abmessungen des Teilbildes an. Die Mipmap-Ebene, die Startschicht, die Cube-Map-Fläche und die Anzahl der Schichten des Teilbildes, das aktualisiert werden soll, werden mit mipLevel, layer, face und layerCount festgelegt.

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

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

Bei Verwendung einer Textur mit einem kombinierten Tiefen-/Stencil-Format legt diese Funktion fest, auf welche Komponente der Textur zugegriffen wird: „ mode “.

Ist der Parameter auf „ DepthMode “ gesetzt, greift der Shader wie gewohnt auf die Tiefenkomponente als einzelnes Float-Wert zu. Ist der Parameter hingegen auf „ StencilMode “ gesetzt, greift der Shader auf die Stencil-Komponente zu.

Siehe auch ` depthStencilMode()`.

void QOpenGLTexture::setFixedSamplePositions(bool fixed)

Legt fest, ob die Abtastpositionen und die Anzahl der Abtastungen bei einem Multisampling-fähigen Texturziel auf „ fixed “ gesetzt werden. Bei der Einstellung „ true “ sind die Abtastpositionen und die Anzahl der Abtastungen für alle Texel im Bild identisch 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 Auswirkung.

Der Standardwert ist „ true “.

Siehe auch ` isFixedSamplePositions()` und ` isStorageAllocated()`.

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

Legt das Format dieses Texturobjekts auf „ format “ fest. Diese Funktion muss aufgerufen werden, bevor Speicherplatz für die Textur zugewiesen wird.

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

Siehe auch „ format()“ und „ allocateStorage()“.

void QOpenGLTexture::setLayers(int layers)

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

Bei Zielen, die Array-Ebenen nicht unterstützen, hat diese Funktion keine Auswirkung.

Siehe auch ` layers()` und ` isStorageAllocated()`.

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

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

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

void QOpenGLTexture::setLevelofDetailBias(float bias)

Legt den Detailgrad-Versatz auf „ bias “ fest. Der Detailgrad-Versatz beeinflusst den Punkt, an dem sich die Mipmapping-Stufen ändern. Durch Erhöhen des Werts für den Detailgrad-Versatz werden die Bilder insgesamt unschärfer oder glatter. Durch Verringern des Werts 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 die maximale Detailstufe auf „ value “ fest. Dadurch wird die Auswahl der Mipmap mit der niedrigsten Auflösung (höchste Mipmap-Stufe) eingeschränkt. Der Standardwert ist 1000.

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

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

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

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

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

Legt den für die Minifizierung verwendeten Filter auf „ filter “ fest.

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

void QOpenGLTexture::setMinimumLevelOfDetail(float value)

Legt die minimale Detailstufe auf „ value “ fest. Dadurch wird die Auswahl der Mipmap mit der höchsten Auflösung (niedrigste Mipmap-Stufe) eingeschränkt. Der Standardwert ist -1000.

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

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

Setzt die Basis-Mipmap-Stufe, die für alle Texturabrufe mit dieser Textur verwendet wird, auf „ baseLevel “.

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

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

Legt den Bereich der Mipmap-Ebenen fest, die für Texturabfragen mit dieser Textur verwendet werden können, und zwar von baseLevel bis maxLevel.

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

void QOpenGLTexture::setMipLevels(int levels)

Bei Texturzielen, die Mipmaps unterstützen, legt diese Funktion die gewünschte Anzahl von Mipmap- levels n fest, für die Speicherplatz zugewiesen werden soll. Diese Funktion sollte aufgerufen werden, bevor Speicherplatz für die Textur zugewiesen wird.

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

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

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

Legt die maximale Mipmap-Stufe fest, die für alle Texturabfragen 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 Speicherplatz zugewiesen werden soll, wenn auf ein Multisampling-fähiges Texturziel gerendert wird. Diese Funktion sollte aufgerufen werden, bevor Speicherplatz für die Textur zugewiesen wird.

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

Siehe auch „ samples()“ und „ isStorageAllocated()“.

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

Legt die Abmessungen dieses Texturobjekts auf width, height und depth fest. Der Standardwert für jede Abmessung beträgt 1. Die maximal zulässige Texturgröße hängt von Ihrer OpenGL-Implementierung ab. Die Zuweisung von Speicherplatz für eine Textur, die kleiner als die maximale Größe ist, kann dennoch fehlschlagen, wenn Ihr System über zu wenige Ressourcen verfügt.

Wenn ein Wert für ` width`, ` height ` oder ` depth ` angegeben wird, der keine Zweierpotenz ist, und Ihre OpenGL-Implementierung keine Unterstützung für sich wiederholende Texturen bietet, die keine Zweierpotenz sind, 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 können die Komponenten des von Texturfunktionen zurückgegebenen vec4 neu anordnen. Es ist zudem wünschenswert, diese Neuanordnung über Code auf der CPU-Seite steuern zu können. Dies wird seit OpenGL 3.3 durch Swizzle-Masken ermöglicht.

Jede Komponente der Textur kann einer der Optionen „ SwizzleValue “ zugeordnet 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 zur Einstellung der Farben Rot, Grün, Blau und des Alpha-Werts verwendet werden.

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

Legt den Wrap-Modus (oder Wiederholungsmodus) für alle Texturdimensionen auf „ mode “ fest.

Siehe auch ` wrapMode()`.

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

Legt den Wrap-Modus (oder Wiederholungsmodus) für die Textur-Dimension „ direction “ auf „ mode “ fest.

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, falls dieses 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 Wrap-Modus für die Texturdimension „ direction “ zurück.

Siehe auch setWrapMode().