Name
miktex-mpost — MetaPost, a system for creating graphics
Synopsis
miktex-mpost
[option
...] [[command
...] | [file
]]
Description
This man page is an adaption of the corresponding TeX Live man page.
MetaPost interprets the MetaPost language and produces PostScript (EPS) or Scalable Vector Graphics (SVG) pictures. The MetaPost language is similar to Knuth's METAFONT with additional features for including TeX commands and accessing features of PostScript not found in METAFONT.
MetaPost is normally used with some preloaded macros, and it
will use its executable name as the name of the preload file to use.
For example, when called as miktex-mpost the mpost.mp
file is used, which is identical to
plain.mp
. When the --initialize
option is given, preloading does not happen.
The commands
given on the command
line to the MetaPost program are passed to it as the first input
line. (But it is often easier to type extended arguments as the first
input line, since shells tend to gobble up or misinterpret
MetaPost's favorite symbols, like semicolons, unless you quote
them.) The normal usage is to say miktex-mpost
figs
to process the file figs.mp
. The
basename of figs
becomes the
“jobname”, and is used in forming output file names. If
no file is named, the jobname becomes mpout
. The
default extension, .mp
, can be overridden by
specifying an extension explicitly.
When the --dvitomp
option is given, MetaPost
acts as DVI-to-MPX converter only. Run miktex-mpost
--dvitomp --help
for option explanation.
Options
--alias=
name
Pretend to be program
name
, i.e., set program (and memory dump) name toname
. This may affect the search paths and other values used. Using this option is equivalent to copying the program file to
and invokingname
.name
--c-style-errors
Change the way, error messages are printed. The alternate style looks like error messages from many compilers and is easier to parse for some editors.
--debug
--halt-on-error
--help
Give help and exit.
--initialize
--interaction=
mode
Set the interaction mode. Must be one of
batchmode
,nonstopmode
,scrollmode
anderrorstopmode
. The meaning of these modes is the same as the corresponding commands.--job-name=
name
Set the name of the job (\jobname). This has an affect on the output file names.
--no-c-style-errors
--numbersystem=
string
Set number system mode (
string
one of:scaled
,double
,binary
,decimal
).--output-directory=
dir
Write output files in
dir
. instead of the current directory. Look up input files indir
first, then along the normal search path.--recorder
Enable the file name recorder. This leaves a trace of the files opened for input and output in a file with the extension
.fls
.--restricted
-s
internal
="string
"-s
internal
=number
--tex=
texprogram
Use
texprogram
instead of miktex-tex when compiling text labels.This flag overrides the environment variable
TEX
.--troff
Set prologues:=1 and assume
--tex=troff
.--undump=
name
Use
name
as the name of the format to be used, instead of the name by which the program was called or a%&
line.
--version
Show version information and exit.
Environment
MIKTEX_TRACE
Comma-separated list of trace stream names (see Chapter 9, Trace Streams). If this variable is set, then MiKTeX programs will write trace messages into the configured log sink.
MPINPUTS
Extra paths to locate MetaPost input files.
MPINPUTS
Extra paths to locate MetaPost input files.