Version dev

# Rotation von Inhalten

Objekte, die mit `PlaceObject` ausgegeben werden, können gedreht werden. Dazu gibt es das Attribut `rotate`, das einen Winkel (in Grad) erwartet, wobei positive Werte eine Drehung im Uhrzeigersinn bewirken.

        <PlaceObject rotate="10">
          <Image file="_sampleb.pdf" width="3"/>
        </PlaceObject>

Wenn ein Objekt gedreht wird, muss man festlegen, um welchen Punkt es sich drehen soll. Die Voreinstellung ist die linke obere Ecke. Mit den Attributen `origin-x` (`left`, `center` und `right`) und `origin-y` (`top`, `center`, `bottom`) kann die Drehachse festgelegt werden. Neben diesen Werten sind auch die Zahlen von 0 bis 100 möglich, die linke obere Ecke ist 0,0 und rechts unten ist 100, 100. In Abbildung sieht man, dass die Drehachse oben links ist.

| Im Beispiele-Repository auf Github gibt es im Verzeichnis `technical` ein Dokument, das den Effekt von `origin-x` und `origin-y` aufzeigt.

## Rotieren von Bildern

Das Attribut `rotate` gibt es sowohl bei `<PlaceObject>` als auch bei `<Image>`. Das Attribut bei `<Image>` kann Bilder nur in 90-Grad-Schritten drehen (positive Werte: im Uhrzeigersinn). Daher wird in der Praxis die Drehung eher über `<PlaceObject>` gesteuert. Das folgende Minimalbeispiel zeigt die beiden Varianten:

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

      <Record element="data">
        <PlaceObject rotate="-90">
          <Image file="_sampleb.pdf" width="3cm"/>
        </PlaceObject>
        <ClearPage/>
        <PlaceObject>
          <Image file="_sampleb.pdf" width="3cm"  rotate="-90"/>
        </PlaceObject>
      </Record>
    </Layout>

Zu beachten: die Drehung kann sich auch auf angegebene Bildmaße auswirken.

Das nachfolgende Beispiel dreht ein Bild um 90 Grad gegen den Uhrzeigersinn, wenn es sich um ein Hochformat-Bild handelt. Mit dem XPath-Befehl `sd:aspectratio(<Dateiname>)` kann man das Seitenverhältnis eines Bildes ermitteln. Wenn es größer als 1 ist, dann handelt es sich um ein Bild im Querformat. Das zweite Bild aus der Datensatzdatei wird um 90° gegen den Uhrzeigersinn gedreht.

    <data>
      <img file="_samplea.pdf" />
      <img file="_sampleb.pdf" />
    </data>

Datensatzdatei

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

      <Record element="data">
        <ForAll select="img">
          <PlaceObject>
            <Image file="{@file}" width="5"
              rotate="{if ( sd:aspectratio(@file) &lt; 1 ) then '-90' else '0'}"/>
          </PlaceObject>
        </ForAll>
      </Record>
    </Layout>

Das Bild wird um 90 Grad gedreht, wenn es ein hochformatiges Bild ist.

| Die geschweiften Klammern bei `file` und `rotate` bedeuten, dass in den XPath-Modus gesprungen wird, um die XPath-Ausdrücke (Zugriff auf das Attribut `file` und die Wenn-Dann-Abfrage) auszuwerten. Mehr dazu im Abschnitt XPath- und Layoutfunktionen.

Achtung: ist das Bild im Argument von `sd:aspectratio()` nicht im Dateisystem vorhanden, wird der Wert von dem Platzhalterbild (Abschnitt Bild nicht gefunden?) genommen. Um zu überprüfen, ob ein Bild überhaupt vorhanden ist, kann man den Befehl `sd:file-exists(<Dateiname>)` benutzen.

## Rotieren über Transformation

Über den Befehl `<Transformation>` (siehe Abschnitt Transformation und in der Referenz die Befehlsbeschreibung) kann man auch Inhalte drehen. Die Matrix hat die Form »cos θ sin θ −sin θ cos θ 0 0«, für eine Drehung um 90 Grad also »0 1 -1 0 0 0«. Das wird im Abschnitt Bild hinter dem Text gezeigt.

#### Inhalt