Name

miktex-mpost — MetaPost, a system for drawing pictures

Synopsis

miktex-post [option...] [[command...] | [file]]

Description

MetaPost (installed as miktex-mpost) 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 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. See dvitomp(1) for details.

Options

--alias=name

Pretend to be program name, i.e., set program (and memory dump) name to name. This may affect the search paths and other values used. Using this option is equivalent to copying the program file to name and invoking 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. This option implies \scrollmode.

--dont-parse-first-line

Disable checking whether the first line of the main input file starts with %&.

--halt-on-error

Quit after the first error.

--help

Give help and exit.

--initialize

Become the INI variant of the program.

--interaction=mode

Set the interaction mode. Must be one of batchmode, nonstopmode, scrollmode and errorstopmode. 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

Don't change the way, error messages are printed.

-numbersystem=string

Set number system mode (string one of: scaled, double, binary, decimal).

--output-directory=dir

Create output files in dir. This implies --include-directory=dir.

--parse-first-line

Check whether the first line of the main input file starts with %&, and parse if it does. This can be used to specify extra command-line options.

--quiet

Suppress all output, except errors.

--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.

-s internal="string"

Set internal to the string value.

-s internal=number

Set internal to the number value.

-tex=texprogram

Use texprogram instead of miktex-tex when compiling text labels.

This flag overrides the environment variable TEX.

--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

MFINPUTS

Extra paths to locate METAFONT input and openin files.

MFINPUTS

Extra paths to locate METAFONT input and openin files.

See also

AT&T technical report CSTR-162

Run mthelp mpman