QSGOpenGLTexture Struct

struct QNativeInterface::QSGOpenGLTexture

Ermöglicht den Zugriff auf und die Übernahme von OpenGL-Texturobjekten. Mehr...

Kopfzeile: #include <QSGTexture>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Seit: Qt 6.0

Öffentliche Funktionen

virtual GLuint nativeTexture() const = 0

Statische öffentliche Mitglieder

(since 6.0) QSGTexture *fromNative(GLuint textureId, QQuickWindow *window, const QSize &size, QQuickWindow::CreateTextureOptions options = {})
(since 6.1) QSGTexture *fromNativeExternalOES(GLuint textureId, QQuickWindow *window, const QSize &size, QQuickWindow::CreateTextureOptions options = {})

Detaillierte Beschreibung

Dokumentation der Mitgliedsfunktionen

[static, since 6.0] QSGTexture *QSGOpenGLTexture::fromNative(GLuint textureId, QQuickWindow *window, const QSize &size, QQuickWindow::CreateTextureOptions options = {})

Erzeugt ein neues QSGTexture, das ein vorhandenes OpenGL-Texturobjekt für window umhüllt.

Das in textureId angegebene native Objekt wird von dem resultierenden QSGTexture umhüllt, gehört ihm aber nicht. Der Aufrufer der Funktion ist dafür verantwortlich, das zurückgegebene QSGTexture zu löschen, aber das zugrunde liegende native Objekt wird dadurch nicht zerstört.

Diese Funktion ist derzeit nur für 2D-RGBA-Texturen geeignet.

Warnung: Diese Funktion gibt null zurück, wenn der Scenegraph noch nicht initialisiert wurde.

Verwenden Sie options, um die Texturattribute anzupassen. Hier werden nur die TextureHasAlphaChannel und TextureHasMipmaps berücksichtigt.

size gibt die Größe in Pixeln an.

Hinweis: Diese Funktion muss im Rendering-Thread des Scenegraphs aufgerufen werden.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch QQuickWindow::sceneGraphInitialized(), QSGTexture, Scene Graph - Metal Texture Import, und Scene Graph - Vulkan Texture Import.

[static, since 6.1] QSGTexture *QSGOpenGLTexture::fromNativeExternalOES(GLuint textureId, QQuickWindow *window, const QSize &size, QQuickWindow::CreateTextureOptions options = {})

Erzeugt ein neues QSGTexture, das ein vorhandenes OpenGL ES-Texturobjekt für window umhüllt.

Das in textureId angegebene native Objekt wird von dem resultierenden QSGTexture umhüllt, ist aber nicht sein Eigentum. Der Aufrufer der Funktion ist dafür verantwortlich, das zurückgegebene QSGTexture zu löschen, aber das zugrunde liegende native Objekt wird dadurch nicht zerstört.

Diese Funktion ist nur für Texturen geeignet, die mit dem Ziel GL_TEXTURE_EXTERNAL_OES verwendet werden sollen: normalerweise Texturen, in die ein anderes Gerät (z. B. eine Kamera) Daten schreibt.

Warnung: Diese Funktion gibt null zurück, wenn der Scenegraph noch nicht initialisiert wurde.

Verwenden Sie options, um die Texturattribute anzupassen. Nur TextureHasAlphaChannel und TextureHasMipmaps werden hier berücksichtigt.

size gibt die Größe in Pixeln an.

Hinweis: Diese Funktion muss im Rendering-Thread des Szenegraphs aufgerufen werden.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch fromNative().

[pure virtual] GLuint QSGOpenGLTexture::nativeTexture() const

Gibt die OpenGL-Textur-ID zurück.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.