.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 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 "GENPNG" "1" "2026-07-07" "2.5" "LCOV"
.SH NAME
genpng \- genpng documentation
.SH NAME
.INDENT 0.0
.TP
.B genpng
Generate an overview image from a source file (internal tool)
.UNINDENT
.INDENT 0.0
.TP
.B Manual section
1
.TP
.B Manual group
LCOV 2.0
.TP
.B Date
2026\-07\-07
.UNINDENT
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
genpng [ \-h | \-\-help ]
 [ \-v | \-\-version ]
 [ \-t | \-\-tab\-size *tabsize* ]
 [ \-w | \-\-width *width* ]
 [ \-d | \-\-dark\-mode ]
 [ \-o | \-\-output\-filename *output\-filename* ]
 source\-file
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBgenpng\fP creates an overview image for a given source code file of either
plain text or .gcov file format.
.sp
Note that the \fIGD.pm\fP Perl module has to be installed for this script to work
(it may be obtained from \%<http://\:www\:.cpan\:.org>).
.sp
Note also that \fBgenpng\fP is called from within \fBgenhtml\fP so that there is
usually no need to call it directly.
.SH OPTIONS
.INDENT 0.0
.TP
\fB\-h\fP, \fB–help\fP
Print a short help text, then exit.
.TP
\fB\-v\fP, \fB–version\fP
Print version number, then exit.
.TP
\fB\-t\fP \fItab\-size\fP, \fB–tab\-size\fP \fItab\-size\fP
Use \fItab\-size\fP spaces in place of tab.
.sp
All occurrences of tabulator signs in the source code file will be replaced
by the number of spaces defined by \fItab\-size\fP (default is 4).
.TP
\fB\-w\fP \fIwidth\fP, \fB–width\fP \fIwidth\fP
Set width of output image to \fIwidth\fP pixel.
.sp
The resulting image will be exactly \fIwidth\fP pixel wide (default is 80).
.sp
Note that source code lines which are longer than \fIwidth\fP will be truncated.
.TP
\fB\-d\fP, \fB–dark\-mode\fP
Use a light\-display\-on\-dark\-background color scheme rather than the default
dark\-display\-on\-light\-background.
.TP
\fB\-o\fP \fIfilename\fP, \fB–output\-filename\fP \fIfilename\fP
Write image to \fIfilename\fP\&.
.sp
Specify a name for the resulting image file (default is \fIsource\-file\fP\&.png).
.UNINDENT
.SH AUTHOR
.sp
Peter Oberparleiter <\%<Peter\:.Oberparleiter@\:de\:.ibm\:.com>>
.SH SEE ALSO
.sp
\fBlcov(1) \%<file://\:\:../\:man/\:lcov\:.1\:.html>\fP, \fBgenhtml(1) \%<file://\:\:../\:man/\:genhtml\:.1\:.html>\fP, \fBgeninfo(1) \%<file://\:\:../\:man/\:geninfo\:.1\:.html>\fP, \fBgendesc(1) \%<file://\:\:../\:man/\:gendesc\:.1\:.html>\fP, \fBgcov(1) \%<file://\:\:../\:man/\:gcov\:.1\:.html>\fP
.sp
\%<https://\:github\:.com/\:linux-test-project/\:lcov>
.SH Copyright
2024-2026, LCOV Project
.\" End of generated man page.