gardener, Interface administrators, Administrators
3,893
edits
Changes
m
< [[Graphics]]|[[Metafun]]|[[Metapost]]>__TOC__
ConTeXT provides a tight integration of TeX and [[MetaPost]]. MetaPost can used behind the scenes for some graphic trickery. This integration is also helpful for drawing figures in MetaPost and use them in the document. This page is a brief overviw of some of the commonly used commands.
== \defineMPinstance MetaFun is ConTeXt extension the [[MetaPost]] language. It provides a tight integration of both TeX and \setupMPinstance ==[[MetaPost]]. MetaPost can used behind the scenes for some graphic trickery. This integration is also helpful for drawing figures in MetaPost and use them in the document.
{{cmd'''THE [[manual:metafun-p.pdf|defineMPinstance}} and {{cmdMetaFun manual]]''', also available in a [[manual:metafun-s.pdf|setupMPinstance}} can be used to set up MetaPost invocations with particular features. One use case could be to select a sans serif font for all MetaPostlabelsscreen version]].
=== \startMPenvironment ===
{{cmd|startMPenvironment}} This page is a '''deprecated''' evironment in which one could place settings that one only wanted to apply in brief overview of some of the MetaPost environment, but not in the document itself. One should use {{cmd|defineMPinstance}} and {{cmd|setupMPinstance}}, insteadcommonly used commands.
== \startMPinclusions ==
Inside {{cmd|startMPinclusions}} one can specify MetaPost files to ''input'', and also define MetaPost functions.= Commonly used commands =
== \startuseMPgraphic ; {{cmd|defineMPinstance}}, {{cmd|setupMPinstance}}: used to set up MetaPost invocations with particular features. One use case could be to select a sans serif font for all MetaPost labels. : {{cmd|startMPenvironment}} '''is DEPRECATED''' in which one could place settings that one only wanted to apply in the MetaPost environment, but not in the document itself. One should use {{cmd|defineMPinstance}} and \useMPgraphic =={{cmd|setupMPinstance}}, instead.
== \startreusableMPgraphic and \reuseMPgraphic ==For graphics that are the same every time; {{cmd|startuseMPgraphic}}, it is better to use {{cmd|startreusableMPgraphicuseMPgraphic}}: defines a piece of graphics code that is processed anew every time the graphic is compiled only once, and the one resulting picture can be placed at various points with {{cmd|reuseMPgraphicuseMPgraphic}}.
== \startMPcode ==; {{cmd|startreusableMPgraphic}}, {{cmd|reuseMPgraphic}}: For graphics that are the same every time, it is better to use {{cmd|startreusableMPgraphic}}: the graphic is compiled only once, and the one resulting picture can be placed at various points with {{cmd|reuseMPgraphic}}.
<context source=yes>\startMPcode fill fullcircle scaled 20pt withcolor ; {{cmd|startMPpage}}: produces a page a containing MetaPost graphic. The page is just large enough to contain the graphic. The resulting pdf is self-contained (it has all the fonts embedded). This is useful if you want to send the figure to a coauthor or a journal.625green;\stopMPcode</context>
== \startMPpage ==; {{cmd|startstaticMPfigure}}, {{cmd|usestaticMPfigure}}: The {{cmd|startuseMPgraphic}} series of commands were designed for using MetaPost for drawing fancy frames and backgrounds and not for using <i>stand-alone</i> graphics for a document. {{cmd|startstaticMPfigure}} creates a separate pdf file containing the graphic. This pdf can be included in the document using {{cmd|usestaticMPfigure}}. ConTeXt is clever enough to recompile the resulting MetaPost file only if something inside the {{cmd|startstaticMPfigure}} has changed.
{{cmd|startMPpage}} produces a page a containing MetaPost graphic. The page is just large enough to contain the graphic. The resulting pdf is self-contained (it has all the fonts embedded) This is useful if you want to send the figure to a coauthor or a journal. = Documentation and links =
== \startstaticMPfigure ==* [[manual:mmakempy.pdf|MakeMPY]]: create MetaPost outlines (by Pragma)* [[Flow Charts|FlowCharts]]: encapsulated application, demonstration of MetaPost/MetaFun* [http://www.pragma-ade.com/general/sources/mptopdf.pdf MPtoPDF]: create PDF from MetaPost (by Pragma)* [http://www.pragma-ade.com/show-gra.pdf a few examples of MetaPost graphics]* [http://www.pragma-ade.com/articles/art-puzz.pdf Puzzling graphics in MetaPost] (article)* [http://www.ntg.nl/maps/25/15.pdf metapost metafun. Hans Hagen at MAPS]
The {{cmd|startuseMPgraphic}} series of commands were designed for using MetaPost for drawing fancy frames and backgrounds and not for using <i>stand-alone</i> graphics for a document. {{cmd|startstaticMPfigure}} creates a separate pdf file containing the graphic. This pdf can be included in the document using {{cmd|usestaticMPfigure}}. ConTeXt is clever enough to recompile the resulting MetaPost file only if something inside the {{cmd|startstaticMPfigure}} has changed.
no edit summary
; {{cmd|startuseMPgraphic}}defines a piece of graphics code that is processed anew every time the graphic is placed with {{cmd|useMPgraphicstartMPinclusions}}: Inside, one can specify MetaPost files to ''input'', and also define MetaPost functions.
; {{cmd|startMPcode}}: When reusing a graphic is not important, you can simply use {{cmd|startMPcode}}.
----
[[Category:Graphics]]
[[Category:Metapost]]
{{MetaPost see also}}
{{Metapost navbox}}