Sur cette page

Qt3DRender::QSharedGLTexture Class

class Qt3DRender::QSharedGLTexture

Permet d'utiliser un « textureId » provenant d'un contexte OpenGL distinct dans une scène « Qt 3D ». En savoir plus...

En-tête : #include <Qt3DRender/QTexture>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : SharedGLTexture
Hérite de : Qt3DRender::QAbstractTexture
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

int textureId() const

Emplacements publics

void setTextureId(int id)

Signaux

void textureIdChanged(int textureId)

Description détaillée

Selon le mode de rendu utilisé par Qt 3D, le contexte partagé sera soit :

  • qt_gl_global_share_context lorsque l'on laisse Qt 3D gérer le rendu. Lorsque l'on définit l'attribut Qt::AA_ShareOpenGLContexts sur la classe QApplication, cela fait automatiquement en sorte que les instances de QOpenGLWidget partagent leur contexte avec qt_gl_global_share_context.
  • le contexte partagé de la scène « QtQuick ». Vous devrez peut-être créer une sous-classe de ` QWindow ` ou utiliser `QtQuickRenderControl` pour contrôler la nature de ce contexte partagé ; toutefois, à partir de la version 5.13, il s’agit de `qt_gl_global_share_context`.

Tout moteur tiers partageant son contexte avec le moteur de rendu « Qt 3D » peut désormais fournir des identifiants de texture qui seront référencés par la texture « Qt 3D ».

Vous pouvez omettre de spécifier les propriétés de la texture ; Qt 3D tentera de les déterminer lors de l’exécution. Si vous les connaissez, vous pouvez bien sûr les fournir, ce qui évitera un travail supplémentaire à Qt 3D.

Gardez à l’esprit que si vous utilisez des matériaux et des shaders personnalisés, vous devez spécifier le type d’échantillonneur approprié à utiliser.

Documentation sur les propriétés

textureId : int

La valeur d'identifiant de texture OpenGL à laquelle vous souhaitez que Qt3D puisse accéder.

Fonctions d'accès :

int textureId() const
void setTextureId(int id)

Signal de notification :

void textureIdChanged(int textureId)

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