QSGTexture Class

Documentation des fonctions membres

QSGTexture::QSGTexture()

Crée la classe de base QSGTexture.

[override virtual noexcept] QSGTexture::~QSGTexture()

Supprime l'QSGTexture.

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

Renvoie le niveau d'anisotropie utilisé pour le filtrage de cette texture.

Voir aussi setAnisotropyLevel().

[virtual, since 6.0] void QSGTexture::commitTextureOperations(QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates)

Appelez cette fonction pour mettre en file d'attente les opérations de téléchargement d'images vers resourceUpdates, s'il y en a en attente. Lorsqu'il n'y a pas de nouvelles données (par exemple, parce qu'aucun appel à setImage() n'a été effectué depuis le dernier appel à cette fonction), la fonction ne fait rien.

Les matériaux utilisant des textures provenant de rhi doivent appeler cette fonction depuis leur implémentation de updateSampledImage(), généralement sans aucune condition, en transmettant les paramètres state.rhi() et state.resourceUpdateBatch() provenant de QSGMaterialShader::RenderState.

Cette fonction a été introduite dans Qt 6.0.

[pure virtual] qint64 QSGTexture::comparisonKey() const

Renvoie une clé permettant de comparer des textures. Généralement utilisée dans les implémentations de la fonction ` QSGMaterial::compare()`.

La simple comparaison des pointeurs ` QSGTexture ` n’est pas toujours suffisante, car deux instances ` QSGTexture ` faisant référence au même objet de texture natif sous-jacent doivent également être considérées comme égales. D’où la nécessité de cette fonction.

Les implémentations de cette fonction ne sont pas censées, et ne doivent pas, créer de ressources graphiques (objets de texture natifs) s’il n’y en a pas encore.

Un ` QSGTexture ` qui ne dispose pas d’un objet de texture natif sous-jacent n’ est généralement pas égal à un autre ` QSGTexture` ; la valeur de retour doit donc être définie en conséquence. Il existe toutefois des exceptions à cette règle, notamment lorsque l’atlas est utilisé (cas où plusieurs textures partagent en arrière-plan la même texture d’atlas) ; il appartient alors aux implémentations des sous-classes de gérer cela de manière appropriée.

QRectF QSGTexture::convertToNormalizedSourceRect(const QRectF &rect) const

Renvoie l'rect, convertie en coordonnées normalisées.

Voir aussi normalizedTextureSubRect().

QSGTexture::Filtering QSGTexture::filtering() const

Renvoie le mode d'échantillonnage à utiliser pour cette texture.

Voir aussi setFiltering().

[pure virtual] bool QSGTexture::hasAlphaChannel() const

Renvoie « true » si les données de texture contiennent un canal alpha.

[pure virtual] bool QSGTexture::hasMipmaps() const

Renvoie « true » si les données de texture contiennent des niveaux de mipmap.

QSGTexture::WrapMode QSGTexture::horizontalWrapMode() const

Renvoie le mode de retour à la ligne horizontal à utiliser pour cette texture.

Voir également setHorizontalWrapMode().

[virtual] bool QSGTexture::isAtlasTexture() const

Indique si cette texture fait partie d'un atlas ou non.

L'implémentation par défaut renvoie « false ».

QSGTexture::Filtering QSGTexture::mipmapFiltering() const

Indique si le mipmapping doit être utilisé lors de l'échantillonnage de cette texture.

Voir également setMipmapFiltering().

template <typename QNativeInterface> QNativeInterface *QSGTexture::nativeInterface() const

Renvoie une interface native du type spécifié pour la texture.

Cette fonction permet d'accéder aux fonctionnalités spécifiques à la plateforme d'QSGTexture, telles que déclarées dans l'espace de noms QNativeInterface:

Cela permet d’accéder à l’objet de texture natif sous-jacent, tel que l’identifiant de texture « GLuint » avec OpenGL, ou le descripteur « VkImage » avec Vulkan.

Si l’interface demandée n’est pas disponible, une valeur « nullptr » est renvoyée.

[virtual] QRectF QSGTexture::normalizedTextureSubRect() const

Renvoie le rectangle situé à l'intérieur de textureSize() que cette texture représente en coordonnées normalisées.

L'implémentation par défaut renvoie un rectangle situé à la position (0, 0) et dont la largeur et la hauteur sont égales à 1.

[virtual] QSGTexture *QSGTexture::removedFromAtlas(QRhiResourceUpdateBatch *resourceUpdates = nullptr) const

Cette fonction renvoie une copie de la texture actuelle, qui est retirée de son atlas.

La texture actuelle reste inchangée ; il n'est donc pas nécessaire de mettre à jour les coordonnées de texture.

Le retrait d’une texture d’un atlas est particulièrement utile lorsqu’on la transmet à un shader qui opère sur les coordonnées de texture 0-1 plutôt que sur le sous-rectangle de texture situé à l’intérieur de l’atlas.

Si la texture ne fait pas partie d’un atlas de textures, cette fonction renvoie 0.

Il est recommandé que les implémentations de cette fonction renvoient la même instance pour plusieurs appels afin de limiter l’utilisation de la mémoire.

resourceUpdates est un lot de mise à jour de ressources facultatif, dans lequel les opérations sur les textures, le cas échéant, sont mises en file d’attente. Les matériaux peuvent récupérer une instance à partir de QSGMaterialShader::RenderState. Lorsqu’elle est nulle, l’implémentation de removedFromAtlas() crée son propre lot et le soumet immédiatement. Cependant, lorsqu’une instance valide est spécifiée, cette fonction ne soumet pas le lot de mise à jour.

[virtual, since 6.0] QRhiTexture *QSGTexture::rhiTexture() const

Renvoie l'QRhiTexture pour cet QSGTexture ou null s'il n'y en a pas (soit parce qu'aucune texture valide n'a encore été créée en interne, soit parce que le concept ne s'applique pas au backend de graphe de scène utilisé).

Cette fonction n’est pas censée créer une nouvelle texture « QRhiTexture » s’il n’y en a pas. Elle doit renvoyer null dans ce cas. On attend du moteur de rendu qu’une texture null entraîne l’utilisation d’une texture factice transparente à la place.

Cette fonction a été introduite dans Qt 6.0.

void QSGTexture::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

Définit le niveau de filtrage anisotrope sur « level ». La valeur par défaut est « QSGTexture::AnisotropyNone », ce qui signifie qu’aucun filtrage anisotrope n’est activé.

Voir également anisotropyLevel().

void QSGTexture::setFiltering(QSGTexture::Filtering filter)

Définit le mode d'échantillonnage sur « filter ».

Voir également filtering().

void QSGTexture::setHorizontalWrapMode(QSGTexture::WrapMode hwrap)

Définit le mode de retour à la ligne horizontal sur hwrap

Voir aussi horizontalWrapMode().

void QSGTexture::setMipmapFiltering(QSGTexture::Filtering filter)

Définit le mode d'échantillonnage des mipmaps sur « filter ».

La configuration du filtrage des mipmaps n'a aucun effet si la texture ne comporte pas de mipmaps.

Voir également ` mipmapFiltering()` et ` hasMipmaps()`.

void QSGTexture::setVerticalWrapMode(QSGTexture::WrapMode vwrap)

Définit le mode de retour à la ligne vertical sur vwrap

Voir aussi verticalWrapMode().

[pure virtual] QSize QSGTexture::textureSize() const

Renvoie la taille de la texture en pixels.

QSGTexture::WrapMode QSGTexture::verticalWrapMode() const

Renvoie le mode de retour à la ligne vertical à utiliser pour cette texture.

Voir aussi setVerticalWrapMode().