Auf dieser Seite

QNativeInterface::QSGOpenGLTexture Struct

Bietet Zugriff auf OpenGL-Texturobjekte und ermöglicht deren Verwendung. Mehr...

Header: #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

QSGOpenGLTexture()
QSGOpenGLTexture(const QNativeInterface::QSGOpenGLTexture &)
QSGOpenGLTexture(QNativeInterface::QSGOpenGLTexture &&)
virtual GLuint nativeTexture() const = 0
QNativeInterface::QSGOpenGLTexture &operator=(QNativeInterface::QSGOpenGLTexture &&)
QNativeInterface::QSGOpenGLTexture &operator=(const QNativeInterface::QSGOpenGLTexture &)

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 = {})

Ausführliche Beschreibung

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept default] QSGOpenGLTexture::QSGOpenGLTexture()

Erstellt standardmäßig eine Instanz von ` QSGOpenGLTexture`.

[delete] QSGOpenGLTexture::QSGOpenGLTexture(const QNativeInterface::QSGOpenGLTexture &)

Erstellt eine Instanz von „ QSGOpenGLTexture “ durch Kopieren. Diese Funktion wurde gelöscht.

[delete] QSGOpenGLTexture::QSGOpenGLTexture(QNativeInterface::QSGOpenGLTexture &&)

Erstellt eine Instanz von ` QSGOpenGLTexture`. Diese Funktion wurde gelöscht.

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

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

Das in ` textureId ` angegebene native Objekt wird von dem resultierenden ` QSGTexture` umschlossen, gehört diesem jedoch nicht. Der Aufrufer der Funktion ist dafür verantwortlich, das zurückgegebene ` QSGTexture` zu löschen, wodurch das zugrunde liegende native Objekt jedoch nicht zerstört wird.

Diese Funktion eignet sich derzeit nur für 2D-RGBA-Texturen.

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

Verwenden Sie „ options “, um die Texturattribute anzupassen. Dabei werden hier nur „TextureHasAlphaChannel“ und „TextureHasMipmaps“ berücksichtigt.

size gibt die Größe in Pixeln an.

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

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` QQuickWindow::sceneGraphInitialized()`, ` QSGTexture`, „Scene Graph – Metal-Texturimport“ und „Scene Graph – Vulkan-Texturimport“.

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

Erstellt ein neues ` QSGTexture `, das ein vorhandenes OpenGL ES-Texturobjekt für ` window` umschließt.

Das in ` textureId ` angegebene native Objekt wird vom resultierenden ` QSGTexture` umschlossen, gehört diesem jedoch nicht. Der Aufrufer der Funktion ist dafür verantwortlich, das zurückgegebene ` QSGTexture` zu löschen, wodurch das zugrunde liegende native Objekt jedoch nicht zerstört wird.

Diese Funktion eignet sich nur für Texturen, die für die Verwendung mit dem Ziel „ GL_TEXTURE_EXTERNAL_OES “ vorgesehen sind: in der Regel Texturen, in die ein anderes Gerät (z. B. eine Kamera) Daten schreibt.

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

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

size Gibt die Größe in Pixeln an.

Hinweis: Diese Funktion muss im Rendering-Thread des Szenengrafen 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.

[delete] QNativeInterface::QSGOpenGLTexture &QSGOpenGLTexture::operator=(QNativeInterface::QSGOpenGLTexture &&)

Weist „ other “ dieser „ QSGOpenGLTexture “-Instanz zu. Diese Funktion wird gelöscht.

[delete] QNativeInterface::QSGOpenGLTexture &QSGOpenGLTexture::operator=(const QNativeInterface::QSGOpenGLTexture &)

other Weist dieser Instanz von „ QSGOpenGLTexture “ den Wert „ “ zu. Diese Funktion wird gelöscht.

© 2026 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.