.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .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" "1" "" "GTK" "GTK commands" .SH Name gtk4-rendernode-tool \- GskRenderNode Utility .SH SYNOPSIS .nf \fBgtk4\-rendernode\-tool\fP [OPTIONS...] \fBgtk4\-rendernode\-tool\fP benchmark [OPTIONS...] \fBgtk4\-rendernode\-tool\fP compare [OPTIONS...] \fBgtk4\-rendernode\-tool\fP convert [OPTIONS...] \fBgtk4\-rendernode\-tool\fP extract [OPTIONS...] \fBgtk4\-rendernode\-tool\fP info [OPTIONS...] \fBgtk4\-rendernode\-tool\fP match [OPTIONS...] \fBgtk4\-rendernode\-tool\fP render [OPTIONS...] [] \fBgtk4\-rendernode\-tool\fP show [OPTIONS...] .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\-\-offload\fP .sp Puts the node into a GraphicsOffload. Intended for testing offloading capabilities of simple rendernodes. .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, tiff or svg image or as pdf document. 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 possible values for the \fBRENDERER\fP\&. .UNINDENT .UNINDENT .sp \fB\-\-dont\-move\fP .sp Keep the node position unchanged, relative to the pixel grid. .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. .UNINDENT .UNINDENT .SS Convert .sp The \fBconvert\fP command converts a symbolic SVG icon into a node and writes the result to stdout. .sp \fB\-\-recolor\fP .INDENT 0.0 .INDENT 3.5 If this option is used, the resulting node will have its symbolic colors replaced by the values given to the \fB\-\-fg\fP, \fB\-\-success\fP, \fB\-\-warning\fP and \fB\-\-error\fP options. Otherwise, the node will have the unreplaced colors, which can be useful to diagnose rendering issues. .UNINDENT .UNINDENT .sp \fB\-\-fg=COLOR\fP \fB\-\-success=COLOR\fP \fB\-\-warning=COLOR\fP \fB\-\-error=COLOR\fP .INDENT 0.0 .INDENT 3.5 Set the symbolic colors to recolor the icon with. If not specified, default colors are used. .UNINDENT .UNINDENT .sp \fB\-\-size=SIZE\fP .INDENT 0.0 .INDENT 3.5 Sets the size to render the icon at. The size can be either a number or a string of the form \fBWIDTHxHEIGHT\fP\&. .UNINDENT .UNINDENT .SS Extract .sp The \fBextract\fP command saves all the data urls found in a node file to a given directory. The file names for the extracted files are derived from the mimetype of the url. .sp \fB\-\-dir=DIRECTORY\fP .INDENT 0.0 .INDENT 3.5 Save extracted files in \fBDIRECTORY\fP (defaults to the current directory). .UNINDENT .UNINDENT .SS Matching .sp The \fBmatch\fP command allows to count occurrences of node patterns in a larger node. The syntax for patterns allows to describe collections of nodes with given types, like this: .INDENT 0.0 .INDENT 3.5 \fB(mask . color)\fP .sp Match mask nodes with any source child and a color node as mask child. .sp \fB(rounded\-clip linear\-gradient)\fP .sp Match rounded clip nodes containing a linear gradient. .sp \fB(container 2 color (fill color))\fP .sp Match containers with 2 children, the first of which is a color node and the second of which is a fill node containing a color node. .UNINDENT .UNINDENT .\" End of generated man page.