QRhiResource Class

Fonction membre Documentation

[virtual noexcept] QRhiResource::~QRhiResource()

Destructeur.

Libère (ou demande une libération différée) les ressources graphiques natives sous-jacentes, s'il y en a.

Voir également destroy().

void QRhiResource::deleteLater()

Lorsqu'elle est appelée sans qu'une image soit enregistrée, cette fonction équivaut à la suppression de l'objet. Cependant, entre QRhi::beginFrame() et QRhi::endFrame(), le comportement est différent : l'objet QRhiResource ne sera pas détruit tant que la trame n'aura pas été soumise via QRhi::endFrame(), ce qui répond à l'exigence QRhi de ne pas modifier les objets QRhiResource qui sont référencés par la trame en cours d'enregistrement.

Si le QRhi qui a créé cet objet est déjà détruit, l'objet est supprimé immédiatement.

L'utilisation de deleteLater() peut s'avérer utile dans de nombreux cas et complète la garantie de bas niveau (que les objets graphiques natifs sous-jacents ne sont jamais détruits tant qu'il n'est pas sûr de le faire et que l'on ne sait pas avec certitude qu'ils ne sont pas utilisés par le GPU dans une image encore en vol), en offrant un moyen de s'assurer que les instances d'objets C++ (de QRhiBuffer, QRhiTexture, etc.) restent elles aussi valides jusqu'à la fin de l'image en cours.

L'exemple suivant montre un moyen pratique de créer un tampon jetable qui n'est utilisé que dans une seule image et qui est automatiquement libéré dans endFrame(). (en ce qui concerne le(s) tampon(s) natif(s) sous-jacent(s), la garantie habituelle s'applique : le backend QRhi reporte la libération de ces tampons jusqu'à ce qu'il soit garanti que la frame dans laquelle le tampon est accédé par le GPU est terminée).

rhi->beginFrame(swapchain);
QRhiBuffer *buf = rhi->newBuffer(QRhiBuffer::Immutable, QRhiBuffer::VertexBuffer, 256);
buf->deleteLater(); // !
u = rhi->nextResourceUpdateBatch();
u->uploadStaticBuffer(buf, data);
// ... draw with buf
rhi->endFrame();

Voir également destroy().

[pure virtual] void QRhiResource::destroy()

Libère (ou demande une libération différée) les ressources graphiques natives sous-jacentes. Il est possible de l'appeler plusieurs fois sans risque, mais les invocations suivantes seront alors sans effet.

Une fois que destroy() est appelé, l'instance QRhiResource peut être réutilisée en appelant à nouveau create(). Cela entraînera la création de nouvelles ressources graphiques natives en dessous.

Le destructeur QRhiResource effectue la même tâche, il n'est donc pas nécessaire d'appeler cette fonction avant de supprimer une ressource QRhiResource.

Voir également deleteLater().

quint64 QRhiResource::globalResourceId() const

Renvoie l'identifiant global et unique de ce site QRhiResource.

Le code utilisateur a rarement besoin de traiter cette valeur directement. Elle est utilisée en interne à des fins de suivi et de comptabilité.

QByteArray QRhiResource::name() const

Renvoie le nom de l'objet actuellement défini. Par défaut, le nom est vide.

Voir aussi setName().

[pure virtual] QRhiResource::Type QRhiResource::resourceType() const

Renvoie le type de la ressource.

QRhi *QRhiResource::rhi() const

Renvoie l'adresse QRhi qui a créé cette ressource.

Si le QRhi qui a créé cet objet est déjà détruit, le résultat est nullptr.

void QRhiResource::setName(const QByteArray &name)

Définit une adresse name pour l'objet.

Cela permet d'obtenir des noms descriptifs pour les ressources graphiques natives visibles dans les outils de débogage graphique, tels que RenderDoc et XCode.

Lorsqu'il s'agit de nommer des objets natifs en relayant le nom via l'API graphique appropriée, notez que le nom est ignoré lorsque QRhi::DebugMarkers n'est pas pris en charge et peut, en fonction du backend, être également ignoré lorsque QRhi::EnableDebugMarkers n'est pas défini.

Voir aussi name().