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 tableaux exposée lorsque setArrayRange() a été appelé.

Voir aussi setArrayRange().

int QRhiTexture::arrayRangeStart() const

Renvoie la première couche du tableau lorsque setArrayRange() a été appelé.

Voir aussi setArrayRange().

int QRhiTexture::arraySize() const

Renvoie la taille du tableau de textures.

Voir aussi setArraySize().

[pure virtual] bool QRhiTexture::create()

Crée les ressources graphiques natives correspondantes. Si des ressources sont déjà présentes en raison d'un create() antérieur sans destroy() correspondant, alors destroy() est appelé implicitement en premier.

Retourne true en cas de succès, false en cas d'échec de l'opération graphique. Quelle que soit la valeur de retour, l'appel à destroy() est toujours sûr.

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

Similaire à create(), sauf qu'aucune nouvelle texture native n'est créée. Au lieu de cela, les ressources de textures natives spécifiées par src sont utilisées.

Cela permet d'importer un objet de texture natif existant (qui doit appartenir au même périphérique ou contexte de partage, en fonction de l'API graphique) à partir d'un moteur graphique externe.

Retourne vrai si l'objet de texture natif spécifié a été enveloppé avec succès en tant qu'objet non propriétaire QRhiTexture.

L'inverse de cette opération, à savoir l'exposition d'un objet de texture natif créé par QRhiTexture à un moteur étranger, est possible via nativeTexture().

int QRhiTexture::depth() const

Renvoie la profondeur des textures 3D.

Voir également setDepth().

QRhiTexture::Flags QRhiTexture::flags() const

Renvoie les drapeaux de texture.

Voir aussi setFlags().

QRhiTexture::Format QRhiTexture::format() const

Renvoie le format de la texture.

Voir aussi setFormat().

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

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

Voir aussi 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. S'il n'est pas appelé, le format d'affichage est supposé être le même que celui de format().

Cette fonction a été introduite dans Qt 6.8.

Voir aussi 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. 1 signifie qu'il n'y a pas d'anti-crénelage multi-échantillon.

Voir aussi setSampleCount().

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

Normalement, toutes les couches du tableau sont exposées et il appartient au nuanceur de sélectionner la couche via la troisième coordonnée transmise à la fonction GLSL texture() lors de l'échantillonnage du tableau sampler2DArray. Lorsque QRhi::TextureArrayRange est signalé comme étant pris en charge, l'appel à setArrayRange() avant create() ou createFrom() demande de ne sélectionner que la plage spécifiée, les éléments count commençant à startIndex. La logique du nuanceur peut alors être écrite en gardant cela à l'esprit.

Voir également QRhi::TextureArrayRange.

void QRhiTexture::setArraySize(int arraySize)

Définit la texture arraySize.

Voir aussi arraySize().

void QRhiTexture::setDepth(int depth)

Définit le site depth pour une texture 3D.

Voir également depth().

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

Définit les drapeaux de texture à f.

Voir aussi flags().

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

Définit le format de texture demandé à fmt.

Voir également format().

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

Avec certaines API graphiques, telles que Vulkan, l'intégration d'un code de rendu personnalisé qui utilise directement l'API graphique doit faire l'objet d'une attention particulière en ce qui concerne la mise en page des images. Cette fonction permet de communiquer l'adresse layout prévue pour l'image sauvegardée sur le site QRhiTexture après les commandes de rendu natives.

Par exemple, considérons le rendu dans une QRhiTexture's VkImage directement avec Vulkan dans un bloc de code entouré par QRhiCommandBuffer::beginExternal() et QRhiCommandBuffer::endExternal(), suivi de l'utilisation de l'image pour l'échantillonnage de texture dans une passe de rendu basée sur QRhi. Pour éviter des transitions potentiellement incorrectes dans la disposition de l'image, 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 seront terminées.

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

Cette fonction n'a aucun effet avec les backends QRhi où l'API graphique sous-jacente n'expose pas de concept de disposition d'image.

void QRhiTexture::setPixelSize(const QSize &sz)

Fixe la taille de la texture, spécifiée en pixels, à sz.

Voir également pixelSize().

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

Définit le format de la vue de la ressource du shader (ou le format de la vue utilisée pour l'échantillonnage de la texture) à fmt. Par défaut, le même format (et le caractère sRGB) est utilisé que la texture elle-même, et dans la plupart des cas, cette fonction n'a pas besoin d'être appelée.

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

Cette fonction a été introduite dans Qt 6.8.

Voir aussi readViewFormat().

void QRhiTexture::setSampleCount(int s)

Fixe le nombre d'échantillons à s.

Voir aussi sampleCount().

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

Définit le format de vue de la cible de rendu à fmt. Par défaut, le même format (et le caractère sRGB) est utilisé que la texture elle-même, et dans la plupart des cas, cette fonction n'a pas besoin d'être appelée.

Un cas d'utilisation courant pour fournir un format de vue d'écriture est de travailler avec des textures fournies en externe qui, en dehors 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 en sRGB à la fin de son pipeline d'ombrage. Dans ce cas, ce que l'on souhaite obtenir lors du rendu d'une telle texture, c'est une vue cible de rendu (par exemple VkImageView) qui a le même format, mais qui n'est pas RVB. (si, par exemple, une implémentation OpenXR permet d'obtenir une texture VK_FORMAT_R8G8B8A8_SRGB, il est probable que le rendu dans cette texture devrait être effectué en utilisant une vue VK_FORMAT_R8G8B8A8_UNORM, si c'est ce que le pipeline du moteur de rendu exige ; dans cet exemple, on appellerait cette fonction avec une vue ViewFormat dont le format est QRhiTexture::RGBA8 et srgb réglé sur false).

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

Cette fonction a été introduite dans Qt 6.8.

Voir aussi writeViewFormat().

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

Renvoie le format d'affichage utilisé lors de l'écriture dans la texture et lors de son utilisation avec le chargement/stockage d'images. S'il n'est pas appelé, le format d'affichage est supposé être le même que celui de format().

Cette fonction a été introduite dans Qt 6.8.

Voir aussi setWriteViewFormat().