3,897
edits
Changes
Jump to navigation
Jump to search
m
Taco moved page Environment/useMPgraphic to Command/startuseMPgraphic over a redirect without leaving a redirect
|attributes=
}}
== [[Help:Reference|Syntax]] (autogenerated) ==
<syntax>startuseMPgraphic</syntax>
== [[Help:Reference|Syntax]] ==
--><span class="first">{...}</span><!--
--></td>
</tr>
<tr><td>%% MetaPost code</td></tr>
<tr>
<td colspan="2" class="cmd">\stopuseMPgraphic</td>
</tr>
<tr valign="top" class="first">
</tr>
</table>
== Description ==
Define code for a MetaPost graphic. The graphic can be placed in the document with {{cmd|useMPgraphic}}, and will be recompiled every time it it is placed. If a custom MetaPost instance (defined with {{cmd|defineMPinstance}}) should be used, the name of the graphic has to be preceded by the name of the MetaPost instance, with a double colon in between: {{cmd|startuseMPgraphic|{instancename::graphicname}|link=no}}.
== Example ==
<context source=yestexcode>
\def\mycolor{.625red}
\defineMPinstance
[myinstance]
[metafun]
\startuseMPgraphic{myinstance::name}
fill fullcircle scaled 20pt withcolor \mycolor;
\stopuseMPgraphic
\startuseMPgraphic{name}
red: \useMPgraphic{name}
red: \useMPgraphic{myinstance::name}
\def\mycolor{.625blue}
blue: \useMPgraphic{name}
</texcode>
The command is very nice for defining [[Overlays|overlays]] that vary randomly:
<context source=yes>
\startuseMPgraphic{randomcolor}
fill unitsquare
xyscaled (\overlaywidth, \overlayheight)
% `uniformdeviate 1` produces a random number between 0 and 1
withcolor (uniformdeviate 1, uniformdeviate 1, uniformdeviate 1);
\stopuseMPgraphic
\defineoverlay
[beta]
[\useMPgraphic{randomcolor}]
\dontleavehmode
\framed[background=beta]{randomcolor}
\framed[background=beta]{randomcolor}
\framed[background=beta]{rather wide}
</context>
== See also ==
