QCanvasRhiPaintDriver Class

Documentation des fonctions membres

void QCanvasRhiPaintDriver::beginPaint(QCanvasOffscreenCanvas &canvas, QRhiCommandBuffer *cb, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

Commence à dessiner sur l'canvas hors écran spécifiée, en enregistrant les commandes de rendu dans le tampon de commandes cb.

L'effacement s'effectue via la fonction fill color set on the canvas, sauf si l'indicateur QCanvasOffscreenCanvas::Flag::PreserveContents est activé, auquel cas il n'y a pas d'effacement et le contenu du canevas est conservé (ce qui peut avoir des implications sur les performances, en fonction de l'architecture du GPU sous-jacent).

flags Spécifie les indicateurs facultatifs qui contrôlent le rendu.

void QCanvasRhiPaintDriver::beginPaint(QRhiCommandBuffer *cb, QRhiRenderTarget *rt, const QMatrix4x4 &matrix, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

Commence à dessiner sur la cible de rendu rt, en enregistrant les commandes de rendu dans le tampon de commandes cb.

Cette surcharge prend en paramètre une matrice personnalisée matrix, qui sert à transformer les sommets. La matrice doit être adaptée au traitement de sommets dont les coordonnées sont exprimées en pixels. Un cas d’utilisation courant consiste à passer la matrice de projection modelview de Qt Quick lors de l’implémentation d’un rendu basé sur QCanvasPainter au sein d’une sous-classe de QSGRenderNode.

La taille de la fenêtre d’affichage et le rapport de pixels du périphérique sont extraits de la cible de rendu.

Cette surcharge ne prend pas de couleur de remplissage, car en pratique, elle est censée être suivie d’un appel à ` endPaint()` avec le drapeau ` EndPaintFlag::DoNotRecordRenderPass ` activé.

flags Spécifie les indicateurs facultatifs qui contrôlent le rendu.

void QCanvasRhiPaintDriver::beginPaint(QRhiCommandBuffer *cb, QRhiRenderTarget *rt, QColor fillColor = Qt::black, QSize logicalSize = QSize(), qreal dpr = 1.0, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

Commence à dessiner sur la cible de rendu rt, en enregistrant les commandes de rendu dans le tampon de commandes cb.

fillColor Spécifie la couleur utilisée pour effacer le tampon de couleur. Cette valeur est ignorée lorsque les indicateurs de la fonction endPaint() contiennent EndPaintFlag::DoNotRecordRenderPass.

logicalSize est facultatif. Lorsqu’il n’est pas vide, il spécifie la taille de la fenêtre d’affichage en unités logiques. dpr doit alors spécifier le facteur d’échelle (rapport de pixels du périphérique) afin que logicalSize puisse être converti en pixels en interne. En pratique, cela sera rarement nécessaire, car la taille de la cible de rendu est utilisée automatiquement par défaut.

flags Spécifie les indicateurs facultatifs qui contrôlent le rendu.

void QCanvasRhiPaintDriver::endPaint(QCanvasRhiPaintDriver::EndPaintFlags flags = {})

Vide le cache et enregistre l'ensemble du rendu « QRhi » généré par les commandes de dessin « QCanvasPainter ».

Par défaut, cette fonction enregistre un passage de rendu complet, ce qui signifie qu’elle appellera en interne les méthodes ` QRhiCommandBuffer::beginPass()` et ` QRhiCommandBuffer::endPass()`. La couleur de fond est spécifiée par l’argument `fillColor` de la méthode ` beginPaint()`, ou par la couleur de remplissage du canevas hors écran.

flags peut être utilisé pour contrôler l’enregistrement d’un passage de rendu, car dans certains cas, il n’est pas souhaitable de laisser endPaint() émettre une séquence complète beginPass() - endPass().

Les deux extraits de code suivants donnent des résultats identiques, mais le second offre davantage de flexibilité, au cas où l'application souhaiterait effectuer d'autres opérations au cours du même passage de rendu :

pd->beginPaint(cb, rt, Qt::black);
// painter->...
pd->endPaint();

pd->beginPaint(cb, rt);
// painter->...
pd->endPaint(QCanvasRhiPaintDriver::EndPaintFlag::DoNotRecordRenderPass);

cb->beginPass(rt, Qt::black, { 1.0f, 0 });
pd->renderPaint();
cb->endPass();

Voir également beginPaint() et renderPaint().

template <typename Functor> void QCanvasRhiPaintDriver::grabCanvas(const QCanvasOffscreenCanvas &canvas, const QObject *context, Functor &&callback)

Émet une requête de relecture de texture pour canvas, en l'associant à context.

callback est appelée soit avant que la fonction ne renvoie une valeur, soit plus tard, selon l’implémentation sous-jacente d’ QRhi et de l’API 3D. La relecture du contenu d’une texture peut impliquer une copie GPU→CPU, selon l’architecture du GPU. Elle prend un seul argument const QImage & et peut être n’importe quel foncteur, y compris ceux de type « move-only ».

Si context est détruit avant la fin de la relecture, la capture est annulée et callback n’est pas appelé. Cela permet au callback de référencer en toute sécurité des objets qui pourraient ne pas survivre à la relecture en cours.

Cette fonction peut être appelée aussi bien à l’intérieur d’un bloc beginPaint() - endPaint() qu’à l’extérieur. Lorsqu’elle est appelée à l’extérieur, elle appelle en interne QRhi::beginOffscreenFrame() etc., ce qui permet d’effectuer des captures à tout moment.

Par exemple, le code suivant enregistrerait le contenu d’un canevas hors écran dans un fichier PNG :

grabCanvas(offscreenCanvas, qGuiApp, [](const QImage &image) {
    image.save("result.png");
});

void QCanvasRhiPaintDriver::renderPaint()

Enregistre tous les rendus d'QRhi s générés par les commandes de dessin de l'QCanvasPainter. N'appelez cette fonction que lorsque la fonction endPaint() a été appelée avec l'argument DoNotRecordRenderPass. Elle ne doit en aucun cas être appelée dans d'autres circonstances.

L'QRhi associé doit être en train d'enregistrer un passage de rendu lorsque cette fonction est appelée.

Voir également endPaint().

void QCanvasRhiPaintDriver::resetForNewFrame()

Réinitialise l'état du moteur de rendu. Cette fonction est censée être appelée une seule fois au début d'une nouvelle image, généralement après l'appel de ` QRhi::beginFrame()` ou ` QRhi::beginOffscreenFrame()`.