QSGTexture Class

Documentation des fonctions membres

QSGTexture::QSGTexture()

Construit la classe de base QSGTexture.

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

Détruit le site QSGTexture.

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

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

Voir aussi setAnisotropyLevel().

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

Cette fonction est appelée pour mettre en file d'attente les opérations de téléchargement d'images vers resourceUpdates, au cas où il y en aurait en attente. S'il n'y a pas de nouvelles données (par exemple, parce qu'il n'y a pas eu de setImage() depuis le dernier appel à cette fonction), la fonction ne fait rien.

Les matériaux impliquant des textures rhi sont censés appeler cette fonction à partir de leur implémentation updateSampledImage(), généralement sans aucune condition, en transmettant state.rhi() et state.resourceUpdateBatch() à partir de QSGMaterialShader::RenderState.

Cette fonction a été introduite dans Qt 6.0.

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

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

La simple comparaison des pointeurs QSGTexture n'est pas toujours suffisante, car deux instances QSGTexture qui font référence au même objet de texture natif en dessous 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) au cas où il n'y en aurait pas encore.

Un site QSGTexture qui n'a pas d'objet de texture natif en dessous n' est généralement pas égal à un autre site QSGTexture, et la valeur de retour doit donc être élaborée en conséquence. Il existe des exceptions à cette règle, notamment en cas d'utilisation de l'atlas (lorsque plusieurs textures partagent la même texture atlas sous le capot), qu'il appartient alors aux implémentations des sous-classes de gérer comme il convient.

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

Retourne rect converti 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

Retourne vrai si les données de texture contiennent un canal alpha.

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

Retourne vrai si les données de texture contiennent des niveaux de mipmap.

QSGTexture::WrapMode QSGTexture::horizontalWrapMode() const

Renvoie le mode d'habillage 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

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

Voir aussi setMipmapFiltering().

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

Renvoie une interface native du type donné pour la texture.

Cette fonction permet d'accéder aux fonctionnalités spécifiques à la plate-forme QSGTexture, telles qu'elles sont déclarées dans l'espace de noms QNativeInterface:

Cela permet d'accéder à l'objet de texture natif sous-jacent, tel que l'ID de texture GLuint avec OpenGL, ou le handle VkImage avec Vulkan.

Si l'interface demandée n'est pas disponible, une adresse nullptr est renvoyée.

[virtual] QRectF QSGTexture::normalizedTextureSubRect() const

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

L'implémentation par défaut renvoie un rectangle à la position (0, 0) avec une largeur et une hauteur de 1.

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

Cette fonction renvoie une copie de la texture courante qui est supprimée de son atlas.

La texture courante reste inchangée, les coordonnées de la texture n'ont donc pas besoin d'être mises à jour.

La suppression d'une texture d'un atlas est principalement utile lorsqu'il s'agit de la passer à un shader qui opère sur les coordonnées de texture 0-1 au lieu du sous-répertoire de texture à 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é aux implémentations de cette fonction de renvoyer la même instance pour plusieurs appels afin de limiter l'utilisation de la mémoire.

resourceUpdates est un lot facultatif de mise à jour de la ressource, sur lequel les opérations de texture, le cas échéant, sont mises en file d'attente. Les matériaux peuvent récupérer une instance à partir de QSGMaterialShader::RenderState. Si 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 soumettra pas le lot de mise à jour.

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

Renvoie le site QRhiTexture pour ce site QSGTexture ou null s'il n'y en a pas (soit parce qu'une texture valide n'a pas encore été créée en interne, soit parce que le concept n'est pas applicable au backend scenegraph utilisé).

Cette fonction n'est pas censée créer une nouvelle QRhiTexture s'il n'y en a pas. Elle doit renvoyer null dans ce cas. Le moteur de rendu s'attend à ce qu'une texture nulle entraîne l'utilisation d'une texture transparente et fictive à la place.

Cette fonction a été introduite dans Qt 6.0.

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

Définit le niveau de filtrage anisotropique à level. La valeur par défaut est QSGTexture::AnisotropyNone, ce qui signifie qu'aucun filtrage anisotropique n'est activé.

Voir également anisotropyLevel().

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

Définit le mode d'échantillonnage à filter.

Voir aussi filtering().

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

Définit le mode d'habillage horizontal à hwrap

Voir aussi horizontalWrapMode().

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

Définit le mode d'échantillonnage de la mipmap à filter.

La définition du filtrage de la mipmap n'a aucun effet si la texture n'a pas de mipmap.

Voir aussi mipmapFiltering() et hasMipmaps().

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

Définit le mode d'enroulement vertical à 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 d'enveloppement vertical à utiliser pour cette texture.

Voir aussi setVerticalWrapMode().