QCanvasRhiPaintDriver Class

Documentación de las funciones miembro

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

Comienza a pintar sobre la pantalla apagada especificada canvas, grabando los comandos de renderizado en el búfer de comandos cb.

El borrado se realiza con fill color set on the canvas, a menos que se active la bandera QCanvasOffscreenCanvas::Flag::PreserveContents, en cuyo caso no hay borrado y se preserva el contenido del lienzo (con implicaciones potenciales para el rendimiento, dependiendo de la arquitectura GPU subyacente).

flags especifica las banderas opcionales que controlan el renderizado.

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

Comienza a pintar sobre el objetivo de renderizado rt, registrando los comandos de renderizado en el buffer de comandos cb.

Esta sobrecarga toma una matriz personalizada matrix, que se utiliza para transformar los vértices. La matriz debe ser adecuada para tratar con vértices en los que las coordenadas se dan en píxeles. Un caso de uso común es pasar Qt Quick's modelview-projection matrix cuando se implementa QCanvasPainter-pased rendering dentro de una subclase QSGRenderNode.

El tamaño de la ventana gráfica y la proporción de píxeles del dispositivo se toman del objetivo de renderizado.

Esta sobrecarga no toma un color de relleno ya que en la práctica se espera que vaya seguida de un endPaint() con la bandera EndPaintFlag::DoNotRecordRenderPass activada.

flags especifica las banderas opcionales que controlan el renderizado.

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

Comienza a pintar sobre el objetivo de renderizado rt, registrando los comandos de renderizado en el buffer de comandos cb.

fillColor especifica el color usado para limpiar el buffer de color. Este valor se ignora cuando las banderas de endPaint() contienen EndPaintFlag::DoNotRecordRenderPass.

logicalSize es opcional. Cuando no está vacío, especifica el tamaño de la ventana gráfica en unidades lógicas. dpr debe especificar entonces el factor de escala (proporción de píxeles del dispositivo) para que logicalSize pueda convertirse a píxeles internamente. En la práctica, esto rara vez será necesario, ya que el tamaño del objetivo de renderizado se utiliza automáticamente por defecto.

flags especifica las banderas opcionales que controlan el renderizado.

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

Descarga y registra todo el renderizado de QRhi generado por los comandos de dibujo de QCanvasPainter.

Por defecto, esta función registra un pase de renderizado completo, lo que significa que llamará internamente a QRhiCommandBuffer::beginPass() y QRhiCommandBuffer::endPass(). El color claro se especifica mediante el argumento fillColor de beginPaint(), o el color de relleno del lienzo fuera de pantalla.

flags puede usarse para controlar la grabación de un pase de render, ya que en algunos casos no será deseable dejar que endPaint() emita una secuencia entera beginPass() - endPass().

Los dos siguientes snippets son idénticos en cuanto a los resultados, pero el segundo ofrece más flexibilidad, en caso de que la aplicación quiera hacer más cosas dentro del mismo pase de render:

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();

Véase también beginPaint() y renderPaint().

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

Emite una solicitud de lectura de textura para canvas.

callback es invocada antes de que la función retorne, o más tarde, dependiendo de QRhi y de la implementación de la API 3D. La lectura del contenido de la textura puede implicar una copia GPU->CPU, dependiendo de la arquitectura de la GPU.

Esta función puede ser llamada tanto dentro de un bloque beginPaint() - endPaint(), como fuera de él. Cuando se llama fuera, invocará internamente QRhi::beginOffscreenFrame() etc., permitiendo que se realicen grabs en cualquier momento.

void QCanvasRhiPaintDriver::renderPaint()

Registra todos los renderizados de QRhi generados por los comandos de dibujo de QCanvasPainter. Llame a esta función sólo cuando endPaint() fue invocado con DoNotRecordRenderPass. No debe ser llamado de otra manera.

El QRhi asociado debe estar grabando un pase de renderizado cuando se invoque a esta función.

Véase también endPaint().

void QCanvasRhiPaintDriver::resetForNewFrame()

Restablece el estado del motor del pintor. Se espera que esta función se invoque una vez al iniciar un nuevo fotograma, normalmente después de QRhi::beginFrame() o QRhi::beginOffscreenFrame().