Difference between revisions of "Command/startuseMPgraphic"
< Command
Jump to navigation
Jump to search
(Add info about MPinstance) |
m (Taco moved page Environment/useMPgraphic to Command/startuseMPgraphic over a redirect without leaving a redirect) |
||
(8 intermediate revisions by 3 users not shown) | |||
Line 3: | Line 3: | ||
|attributes= | |attributes= | ||
}} | }} | ||
+ | |||
+ | == [[Help:Reference|Syntax]] (autogenerated) == | ||
+ | <syntax>startuseMPgraphic</syntax> | ||
== [[Help:Reference|Syntax]] == | == [[Help:Reference|Syntax]] == | ||
Line 25: | Line 28: | ||
Define code for a MetaPost graphic. The graphic can be placed in the document with {{cmd|useMPgraphic}}, and will be recompiled every time it is placed. | Define code for a MetaPost graphic. The graphic can be placed in the document with {{cmd|useMPgraphic}}, and will be recompiled every time it is placed. | ||
− | If a custom MetaPost instance should be used, the name of the | + | 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 == | == Example == | ||
− | < | + | <texcode> |
\def\mycolor{.625red} | \def\mycolor{.625red} | ||
Line 48: | Line 51: | ||
\def\mycolor{.625blue} | \def\mycolor{.625blue} | ||
blue: \useMPgraphic{name} | 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> | </context> | ||
+ | |||
== See also == | == See also == |
Latest revision as of 09:50, 7 August 2020
\startuseMPgraphic
Syntax (autogenerated)
\startuseMPgraphic{...}{...,...} ... \stopuseMPgraphic | |
{...} | name |
{...,...} | key |
Syntax
\startuseMPgraphic{...} | |
%% MetaPost code | |
\stopuseMPgraphic | |
{...} | name under which the graphic will be known |
Description
Define code for a MetaPost graphic. The graphic can be placed in the document with \useMPgraphic, and will be recompiled every time it is placed.
If a custom MetaPost instance (defined with \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: \startuseMPgraphic{instancename::graphicname}.
Example
\def\mycolor{.625red} \defineMPinstance [myinstance] [metafun] \startuseMPgraphic{myinstance::name} fill fullcircle scaled 20pt withcolor \mycolor; \stopuseMPgraphic \startuseMPgraphic{name} fill fullcircle scaled 20pt withcolor \mycolor; \stopuseMPgraphic red: \useMPgraphic{name} red: \useMPgraphic{myinstance::name} \def\mycolor{.625blue} blue: \useMPgraphic{name}
The command is very nice for defining overlays that vary randomly:
\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}
See also
- \defineMPinstance
- \setupMPinstance
- \startMPinclusions
- \startMPenvironment — deprecated
- \startMPcode
- \startuseMPgraphic — dynamic graphics that are recompiled at every use
- \useMPgraphic — use a dynamic graphic
- \startuniqueMPgraphic — dynamic graphics that are recompiled when parameters (width, height, depth, background color, line color) change
- \uniqueMPgraphic — use a dynamic graphic
- \startreusableMPgraphic — static graphics that are compiled once
- \reuseMPgraphic — use a static graphic
- \startstaticMPfigure — standalone graphics
- \usestaticMPfigure — use a standalone graphic
- \startMPpage — a page just large enough to fit its MetaPost contents
- MetaFun - MetaPost in ConTeXt
Help from ConTeXt-Mailinglist/Forum
All issues with: