.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GTK4-RENDERNODE-TOOL" "" "" ""
.SH NAME
gtk4-rendernode-tool \- GskRenderNode Utility
.SH SYNOPSIS
.nf
\fBgtk4\-rendernode\-tool\fP <COMMAND> [OPTIONS...] <FILE>

\fBgtk4\-rendernode\-tool\fP benchmark [OPTIONS...] <FILE>
\fBgtk4\-rendernode\-tool\fP compare [OPTIONS...] <FILE1> <FILE2>
\fBgtk4\-rendernode\-tool\fP info [OPTIONS...] <FILE>
\fBgtk4\-rendernode\-tool\fP render [OPTIONS...] <FILE> [<FILE>]
\fBgtk4\-rendernode\-tool\fP show [OPTIONS...] <FILE>
.fi
.sp
.SH DESCRIPTION
.sp
\fBgtk4\-rendernode\-tool\fP can perform various operations on serialized rendernodes.
.SH COMMANDS
.SS Information
.sp
The \fBinfo\fP command shows general information about the rendernode, such
as the number of nodes, and the depth of the tree.
.SS Showing
.sp
The \fBshow\fP command displays the rendernode.
.sp
\fB\-\-undecorated\fP
.sp
Removes window decorations. This is meant for rendering of exactly the rendernode
without any titlebar.
.SS Rendering
.sp
The \fBrender\fP command saves a rendering of the rendernode as a png or tiff image.
The name of the file to write can be specified as a second FILE argument.
.sp
\fB\-\-renderer=RENDERER\fP
.INDENT 0.0
.INDENT 3.5
Use the given renderer. Use \fB\-\-renderer=help\fP to get a information
about poassible values for the \fBRENDERER\fP\&.
.UNINDENT
.UNINDENT
.SS Benchmark
.sp
The \fBbenchmark\fP command benchmarks rendering of a node with the existing renderers
and prints the runtimes.
.sp
\fB\-\-renderer=RENDERER\fP
.INDENT 0.0
.INDENT 3.5
Add the given renderer. This argument can be passed multiple times to test multiple
renderers. By default, all major GTK renderers are run.
.UNINDENT
.UNINDENT
.sp
\fB\-\-runs=RUNS\fP
.INDENT 0.0
.INDENT 3.5
Number of times to render the node on each renderer. By default, this is 3 times.
Keep in mind that the first run is often used to populate caches and might be
significantly slower.
.UNINDENT
.UNINDENT
.sp
\fB\-\-no\-download\fP
.INDENT 0.0
.INDENT 3.5
Do not attempt to download the result. This may cause the measurement to not include
the execution of the commands on the GPU. It can be useful to use this flag to test
command submission performance.
.UNINDENT
.UNINDENT
.SS Compare
.sp
The \fBcompare\fP command compares the rendering of a node with a reference image,
or the renderings of two nodes, or two images. If any differences are found, the
exit code is 1. If the images are identical, it is 0.
.sp
\fB\-\-renderer=RENDERER\fP
.INDENT 0.0
.INDENT 3.5
Use the given renderer.
.UNINDENT
.UNINDENT
.sp
\fB\-\-output=FILE\fP
.INDENT 0.0
.INDENT 3.5
Save the differences as a png image in \fBFILE\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-\-quiet\fP
.INDENT 0.0
.INDENT 3.5
Don\(aqt write results to stdout.\(ga
.UNINDENT
.UNINDENT
.\" Generated by docutils manpage writer.
.