Bilder mit MetaPost erstellen und einbinden

Die Funktionalität, MetaPost-Grafiken zu erstellen und einzubinden ist noch sehr neu und experimentell. Die Schnittstelle kann sich noch ändern bzw. ganz wegfallen. Insofern sollte man sie mit Vorsicht benutzen.

MetaPost ist eine Programmiersprache, mit der man Grafiken erstellen kann.

So erzeugt man beispielsweise aus folgendem Programmcode:

beginfig(1)
    for a=0 upto 9:
      draw (0,0){dir 45}..{dir -10a}(6cm,0);
    endfor
endfig;

eine Grafik:

mp first

MetaPost im speedata Publisher

Die Idee ist nun, diese Bilder auch im speedata Publisher nutzen zu können. Dazu definiert man erst eine Grafik und benutzt sie später bei dem Box-Befehl:

<Layout
    xmlns="urn:speedata.de:2009/publisher/en"
    xmlns:sd="urn:speedata:2009/publisher/functions/en">

    <!-- beginfig() ... endfig nicht notwendig -->
    <DefineGraphic name="dottedbox">
      pickup pencircle scaled 1mm;
      draw (0,0) -- (box.width,0) -- (box.width, box.height) --
        (box.width, box.height) -- (0, box.height ) -- cycle
        dashed withdots withcolor 0.7red ;
    </DefineGraphic>

    <!-- dasselbe, nutzt aber den vordefinierten Pfad box: -->
    <DefineGraphic name="dottedboxsimple">
        pickup pencircle scaled 1mm;
        draw box dashed withdots withcolor 0.7red ;
    </DefineGraphic>

    <Record element="data">
        <PlaceObject row="1" column="1">
            <Box height="2" width="5" graphic="dottedbox" />
        </PlaceObject>
    </Record>
</Layout>

Die Breite der Box und die Höhe der Box sind mit den Variablen box.width und box.height in MetaPost definiert. Damit kann man die Grafik an die Vorgaben im Publisher anpassen.

mp dotted
Die gepunkteten Linien entsprechen den Vorgaben der Box. Die Rasterdarstellung wurde eingeschaltet, damit das sichtbar wird.

Koordinaten

Der Ursprung des Koordinatensystems liegt in der linken unteren Ecke der Box, positive Werte gehen also in die Richtung rechts und oben.

Variablen

Es können mit <SetVariable> Variablen für MetaPost gesetzt werden.

<SetVariable
    variable="curcol"
    type="mp:rgbcolor"
    select="'colors.mycolor'"/>

Die Zuweisung wird zu Beginn des MetaPost-Kontexts ausgewertet. Damit steht curcol am Anfang der Grafiken zur Verfügung.

Vordefinierte Werte

  • Alle Farben, die im Layout definiert werden, können mit dem Präfix colors. in MetaPost benutzt werden:
    <DefineColor name="mycolor" value="#FF4E00"/>
    
    <DefineGraphic name="dots">
        pickup pencircle scaled 3mm;
        for i=0 upto 3:
            draw (i * 1cm, i * 1cm) withcolor colors.mycolor ;
        endfor;
    </DefineGraphic>
    
    <Record element="data">
        <PlaceObject row="1" column="1">
            <Box height="5" width="1" graphic="dots" />
        </PlaceObject>
    </Record>
  • CSS Level 3 Farben sind im RGB-Farbraum vordefiniert.
  • Die Breite und Höhe der umgebenden Fläche können mit box.width und box.height abgefragt werden.
  • Der Pfad box ist für die Außmaße der Fläche definiert (siehe das Beispiel oben).
  • Hans Hagens Metafun-Makros sind teilweise eingebunden.
  • Bei Seitentypen stehen zusätzlich folgende Variablen zur Verfügung:
    Variable Beschreibung
    page.width Seitenbreite
    page.height Seitenhöhe
    page.margin.left Rand links
    page.margin.right Rand rechts
    page.margin.top Rand oben
    page.margin.bottom Rand unten
    page.trim Beschnittzugabe

MetaPost Ressourcen

Es gibt eine Reihe englischer Handbücher und Tutorials für MetaPost: