.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "VEUSZ 1"
.TH VEUSZ 1 "2023-03-20" "3.6.2" "Veusz"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Veusz \- a scientific plotting and graphing application.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
veusz [\fIoptions\fR] [\fIdocument.vsz\fR]...
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBVeusz\fR is a scientific plotting and graphing package. It is designed
to create publication-ready output in a variety of different output
formats. Graphs are built-up combining plotting widgets. Veusz has a
\&\s-1GUI\s0 user interface (started with the \f(CW\*(C`veusz\*(C'\fR command), a Python
module interface and a scripting interface.
.PP
If started without command line arguments, \fBVeusz\fR will open up with
a new empty document. The program will otherwise open the listed
documents.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-unsafe\-mode\fR" 8
.IX Item "--unsafe-mode"
Do not check opened scripts for the presence of unsafe Python
commands. This allows you to create or open complete Python scripts
with Veusz commands if they come from a trusted source.
.IP "\fB\-\-listen\fR" 8
.IX Item "--listen"
Read Veusz commands from stdin, executing them, then writing the
results to stdout. This option replaces the old veusz_listen.
.Sp
In this mode Veusz does not read any input documents, but will use the
first argument to the program as the window title, if given.
.IP "\fB\-\-quiet\fR" 8
.IX Item "--quiet"
If in listening mode, do not open a window before running commands,
but execute them quietly.
.IP "\fB\-\-export\fR=\fI\s-1FILE\s0\fR" 8
.IX Item "--export=FILE"
Export the next Veusz document file on the command line to the
graphics file \fI\s-1FILE\s0\fR. Supported file types include \s-1EPS, PDF, SVG,
PNG, BMP, JPG\s0 and \s-1XPM.\s0 The extension of the output file is used to
determine the output file format. There should be as many export
options specified as input Veusz documents on the command line.
.IP "\fB\-\-export\-option\fR=\fI\s-1OPT\s0\fR" 8
.IX Item "--export-option=OPT"
Adds the option given when exporting. Supported options are dpi=\fI\s-1DPI\s0\fR
giving the resolution for bitmap output files (default 100),
color=True/False to switch to monochrome output (default True),
page=[\fIX\fR,...] gives a list of pages to export (default [0]), where
the page numbers are numbered from 0, antialias=True/False enables or
disables antialiasing in bitmap output files (default True),
quality=\fI\s-1VAL\s0\fR gives the \s-1JPEG\s0 quality value (default 85),
backcolor='\fI#RRGGBBAA\fR' gives the background color of bitmap files
(default '#ffffff00'), pdfdpi=\fI\s-1DPI\s0\fR gives the \s-1DPI\s0 when outputting to
\&\s-1PDF\s0 files (default 150) and svgtextastext=True/False outputs text in
\&\s-1SVG\s0 files as text, rather than as curves (default False).
.IP "\fB\-\-veusz\-plugin\fR=\fI\s-1FILE\s0\fR" 8
.IX Item "--veusz-plugin=FILE"
Loads the Veusz plugin \fI\s-1FILE\s0\fR when starting Veusz. This option
provides a per-session alternative to adding the plugin in the
preferences dialog box.
.IP "\fB\-\-help\fR" 8
.IX Item "--help"
Displays the options to the program and exits.
.IP "\fB\-\-version\fR" 8
.IX Item "--version"
Displays information about the currently installed version and exits.
.SH "BUGS"
.IX Header "BUGS"
Please report bugs at https://github.com/veusz/veusz/issues
.SH "AUTHORS"
.IX Header "AUTHORS"
\&\fBVeusz\fR was written by Jeremy Sanders <jeremy@jeremysanders.net>.
.PP
This manual page was written by Jeremy Sanders <jeremy@jeremysanders.net>.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2003\-2023 Jeremy Sanders <jeremy@jeremysanders.net>.
.PP
This program is free software; you can redistribute it and/or modify it
under the terms of the \s-1GNU\s0 General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.
.PP
On Debian GNU/Linux systems, the complete text of the \s-1GNU\s0 General
Public License can be found in `/usr/share/common\-licenses/GPL'.