QCanvasRhiPaintDriver Class

Documentation des fonctions membres

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

Commence à peindre sur le hors-écran spécifié canvas, en enregistrant les commandes de rendu dans le tampon de commande cb.

L'effacement se fait avec fill color set on the canvas, sauf si le drapeau QCanvasOffscreenCanvas::Flag::PreserveContents est activé, auquel cas il n'y a pas d'effacement et le contenu de la toile est préservé (avec des implications potentielles pour les performances, en fonction de l'architecture GPU sous-jacente).

flags spécifie les drapeaux optionnels qui contrôlent le rendu.

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

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

Cette surcharge prend une matrice personnalisée matrix, qui est utilisée pour transformer les sommets. La matrice doit être adaptée au traitement des sommets dont les coordonnées sont exprimées en pixels. Un cas d'utilisation courant consiste à transmettre la matrice de projection de la vue modèle de Qt Quick lors de la mise en œuvre du rendu basé sur QCanvasPainter dans une sous-classe de QSGRenderNode.

La taille de la fenêtre de visualisation et le ratio de pixels de l'appareil proviennent de la cible de rendu.

Cette surcharge ne prend pas de couleur de remplissage car, dans la pratique, elle est censée être suivie d'un endPaint() avec l'indicateur EndPaintFlag::DoNotRecordRenderPass activé.

flags spécifie les drapeaux optionnels qui contrôlent le rendu.

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

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

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

logicalSize est facultatif. Lorsqu'il n'est pas vide, il spécifie la taille de la fenêtre de visualisation en unités logiques. dpr doit ensuite spécifier le facteur d'échelle (rapport de pixels de l'appareil) 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 drapeaux optionnels qui contrôlent le rendu.

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

Rince et enregistre tous les rendus de QRhi générés par les commandes de dessin de QCanvasPainter.

Par défaut, cette fonction enregistre une passe de rendu complète, ce qui signifie qu'elle appellera en interne QRhiCommandBuffer::beginPass() et QRhiCommandBuffer::endPass(). La couleur claire est spécifiée par l'argument fillColor de beginPaint(), ou par la couleur de remplissage du canevas hors écran.

flags peut être utilisé pour contrôler l'enregistrement d'une passe 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 suivants sont identiques en ce qui concerne les résultats, mais le second offre plus de flexibilité, au cas où l'application voudrait faire plus dans la même passe 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 aussi beginPaint() et renderPaint().

void QCanvasRhiPaintDriver::grabCanvas(const QCanvasOffscreenCanvas &canvas, std::function<void (const QImage &)> callback)

Emet une demande de relecture de texture pour canvas.

callback est invoquée soit avant le retour de la fonction, soit plus tard, en fonction de l'implémentation sous-jacente de QRhi et de l'API 3D. La relecture du contenu des textures peut impliquer une copie GPU->CPU, en fonction de l'architecture du GPU.

Cette fonction peut être appelée à l'intérieur d'un bloc beginPaint() - endPaint() ou à l'extérieur. Lorsqu'elle est appelée à l'extérieur, elle invoque en interne QRhi::beginOffscreenFrame(), etc., ce qui permet d'effectuer des saisies à tout moment.

void QCanvasRhiPaintDriver::renderPaint()

Enregistre tous les rendus QRhi générés par les commandes de dessin QCanvasPainter. Cette fonction ne doit être appelée que si endPaint() a été invoqué avec DoNotRecordRenderPass. Elle ne doit pas être appelée autrement.

Le site QRhi associé doit être en train d'enregistrer une passe de rendu lorsque cette fonction est invoquée.

Voir également endPaint().

void QCanvasRhiPaintDriver::resetForNewFrame()

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