QRhiTexture Class

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512));
if (!texture->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
QImage image(512, 512, QImage::Format_RGBA8888);
image.fill(Qt::green);
batch->uploadTexture(texture, image);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

// determine newSize, e.g. based on the swapchain's output size or other factors
if (texture->pixelSize() != newSize) {
    texture->setPixelSize(newSize);
    if (!texture->create()) { error(); }
}
// continue using texture, fill it with new data

Documentation des fonctions membres

int QRhiTexture::arrayRangeLength() const

Renvoie la taille de la plage de l'array exposée lors de l'appel de la fonction setArrayRange().

Voir également ` setArrayRange()`.

int QRhiTexture::arrayRangeStart() const

Renvoie la première couche de tableau lorsque la fonction ` setArrayRange()` a été appelée.

Voir aussi setArrayRange().

int QRhiTexture::arraySize() const

Renvoie la taille du tableau de textures.

Voir également setArraySize().

[pure virtual] bool QRhiTexture::create()

Crée les ressources graphiques natives correspondantes. Si des ressources existent déjà suite à un appel antérieur à `create()` sans ` destroy()` correspondant, alors la fonction ` destroy()` est d’abord appelée implicitement.

Renvoie ` true ` en cas de succès, et ` false ` lorsqu’une opération graphique a échoué. Quelle que soit la valeur renvoyée, l’appel à ` destroy()` est toujours sans risque.

[virtual] bool QRhiTexture::createFrom(QRhiTexture::NativeTexture src)

Similaire à ` create()`, à la différence qu'aucune nouvelle texture native n'est créée. À la place, les ressources de texture natives spécifiées par ` src ` sont utilisées.

Cela permet d’importer un objet de texture native existant (qui doit appartenir au même périphérique ou au même contexte de partage, selon l’API graphique) depuis un moteur graphique externe.

Renvoie « true » si l’objet de texture native existant spécifié a bien été encapsulé en tant qu’ QRhiTexture non propriétaire.

L’opération inverse, consistant à exposer un objet de texture natif créé par QRhiTexture à un moteur tiers, est possible via nativeTexture().

int QRhiTexture::depth() const

Renvoie la profondeur des textures 3D.

Voir aussi setDepth().

QRhiTexture::Flags QRhiTexture::flags() const

Renvoie les indicateurs de texture.

Voir aussi ` setFlags()`.

QRhiTexture::Format QRhiTexture::format() const

Renvoie le format de texture.

Voir aussi setFormat().

[virtual] QRhiTexture::NativeTexture QRhiTexture::nativeTexture()

Renvoie les ressources natives sous-jacentes de cette texture. La valeur renvoyée sera vide si l'exposition des ressources natives sous-jacentes n'est pas prise en charge par le backend.

Voir également createFrom().

QSize QRhiTexture::pixelSize() const

Renvoie la taille en pixels.

Voir aussi setPixelSize().

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::readViewFormat() const

Renvoie le format de vue utilisé lors de l'échantillonnage de la texture. Si cette fonction n'est pas appelée, le format de vue est considéré comme étant identique à celui de la fonction ` format()`.

Cette fonction a été introduite dans Qt 6.8.

Voir également setReadViewFormat().

[override virtual] QRhiResource::Type QRhiTexture::resourceType() const

Réimplémente : ` QRhiResource::resourceType()` const.

Renvoie le type de ressource.

int QRhiTexture::sampleCount() const

Renvoie le nombre d'échantillons. La valeur 1 indique qu'il n'y a pas d'anticrénelage multi-échantillon.

Voir également setSampleCount().

void QRhiTexture::setArrayRange(int startIndex, int count)

En règle générale, toutes les couches du tableau sont exposées et c'est au shader de sélectionner la couche via la troisième coordonnée transmise à la fonction GLSL ` texture() ` lors de l'échantillonnage de ` sampler2DArray`. Lorsque ` QRhi::TextureArrayRange ` est signalé comme pris en charge, l'appel de `setArrayRange()` avant ` create()` ou ` createFrom()` permet de sélectionner uniquement la plage spécifiée, soit ` count ` éléments à partir de ` startIndex`. La logique du shader peut alors être écrite en tenant compte de cela.

Voir également QRhi::TextureArrayRange.

void QRhiTexture::setArraySize(int arraySize)

Définit la texture arraySize.

Voir aussi arraySize().

void QRhiTexture::setDepth(int depth)

Définit l'depth e d'une texture 3D.

Voir également depth().

void QRhiTexture::setFlags(QRhiTexture::Flags f)

Définit les indicateurs de texture sur « f ».

Voir aussi flags().

void QRhiTexture::setFormat(QRhiTexture::Format fmt)

Définit le format de texture demandé sur « fmt ».

Voir aussi format().

[virtual] void QRhiTexture::setNativeLayout(int layout)

Avec certaines API graphiques, telles que Vulkan, l’intégration d’un code de rendu personnalisé utilisant directement l’API graphique nécessite une attention particulière en ce qui concerne la disposition des images. Cette fonction permet de spécifier l’ layout attendue dans laquelle se trouve l’image sous-jacente de l’ QRhiTexture après l’exécution des commandes de rendu natives.

QRhiTexturePrenons par exemple le cas d’un rendu directement dans le `VkImage` d’une ` QRhiCommandBuffer::beginExternal` à l’aide de Vulkan, dans un bloc de code encadré par les fonctions ` ()` et ` QRhiCommandBuffer::endExternal()`, suivi de l’utilisation de cette image pour l’échantillonnage de texture dans un passage de rendu basé sur ` QRhi`. Afin d’éviter des transitions de disposition d’image potentiellement incorrectes, cette fonction peut être utilisée pour indiquer quelle sera la disposition de l’image une fois que les commandes enregistrées dans ledit bloc de code auront été exécutées.

L'appel de cette fonction n'a de sens qu'après QRhiCommandBuffer::endExternal() et avant un QRhiCommandBuffer::beginPass() suivant.

Cette fonction n’a aucun effet avec les backends « QRhi » où l’API graphique sous-jacente ne prend pas en charge le concept de disposition d’image.

void QRhiTexture::setPixelSize(const QSize &sz)

Définit la taille de la texture, exprimée en pixels, à l'aide de la fonction ` sz`.

Voir également pixelSize().

[since 6.8] void QRhiTexture::setReadViewFormat(const QRhiTexture::ViewFormat &fmt)

Définit le format d'affichage de la ressource de shader (ou le format de la vue utilisée pour l'échantillonnage de la texture) sur « fmt ». Par défaut, le format (et l'espace de couleur sRGB) utilisé est le même que celui de la texture elle-même ; dans la plupart des cas, il n'est donc pas nécessaire d'appeler cette fonction.

Ce paramètre n’est pris en compte que lorsque la fonctionnalité « QRhi::TextureViewFormat » est signalée comme prise en charge.

Cette fonction a été introduite dans Qt 6.8.

Voir également readViewFormat().

void QRhiTexture::setSampleCount(int s)

Définit le nombre d'échantillons sur s.

Voir aussi sampleCount().

[since 6.8] void QRhiTexture::setWriteViewFormat(const QRhiTexture::ViewFormat &fmt)

Définit le format d'affichage de la cible de rendu sur ` fmt`. Par défaut, le format (et l'espace colorimétrique sRGB) utilisé est le même que celui de la texture elle-même ; dans la plupart des cas, il n'est donc pas nécessaire d'appeler cette fonction.

Un cas d’utilisation courant pour la spécification d’un format de vue d’écriture consiste à travailler avec des textures fournies en externe qui, indépendamment de notre contrôle, utilisent un format sRGB avec des API 3D telles que Vulkan ou Direct 3D, mais le moteur de rendu est déjà prêt à gérer la linéarisation et la conversion vers sRGB à la fin de son pipeline de shading. Dans ce cas, ce qu’il faut lors du rendu dans une telle texture, c’est une vue de cible de rendu (par exemple VkImageView) qui ait le même format, mais non sRGB. (Si, par exemple, une implémentation OpenXR fournit une texture au format VK_FORMAT_R8G8B8A8_SRGB, il est probable que le rendu vers celle-ci doive être effectué à l’aide d’une vue de type VK_FORMAT_R8G8B8A8_UNORM, si tel est ce qu’exige le pipeline du moteur de rendu ; dans cet exemple, on appellerait cette fonction avec une ` ViewFormat ` dont le format est ` QRhiTexture::RGBA8 ` et dont ` srgb ` est défini sur ` false`).

Ce paramètre n’est pris en compte que lorsque la fonctionnalité « QRhi::TextureViewFormat » est signalée comme prise en charge.

Cette fonction a été introduite dans Qt 6.8.

Voir également writeViewFormat().

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::writeViewFormat() const

Renvoie le format de vue utilisé lors de l'écriture dans la texture et lors de son utilisation avec les fonctions de chargement/enregistrement d'images. Si cette fonction n'est pas appelée, le format de vue est supposé être le même que celui de la fonction ` format()`.

Cette fonction a été introduite dans Qt 6.8.

Voir également setWriteViewFormat().