miktex-mpost

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

`--debug`

  Print debugging info and leave temporary files in place.

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

  Write output files in `dir`. instead of the current directory. Look up input files in `dir` 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`

  Be secure: disable tex, makempx and editor commands.

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

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