# Elementname: `Bild`

## Beschreibung

Bindet eine externe Grafik ein. Erlaubte Grafikformate sind PDF (.pdf), PNG (.png) und JPEG (.jpg).

Erlaubte Attribute: ausschnitt, breite, datei, dpiwarnung, href, höhe, maxbreite, maxhöhe, maximale-größe, minbreite, minhöhe, natürliche-größe, seite

Kindelemente: (keine)

Elternelemente: Absatz, B, Bis, Fall, Farbe, FürAlle, I, ObjektAusgeben, Rahmen, Schleife, Schriftart, Solange, Sonst, Td, Transformation, U, URL

### Attribute

ausschnitt (optional)

  Wenn ja, dann behält das Bild sein Seitenverhältnis wenn Breite und Höhe gegeben ist. Um das Bild einzupassen, wird ein Teil abgeschnitten.

  ja: | Seitenverhältnis beibehalten und linken und rechten oder oberen und unteren Rand abschneiden.
  nein: | Bild verzerren, damit es in den vorgegebenen Rahmen passt.

breite (Zahl oder Längenangabe, optional)

  Bildbreite. Angabe in der Form 'auto' (Voreinstellung, natürliche Bildbreite), '100%' (Breite des aktuellen Platzierungsbereichs), Längenangabe wie '4cm' oder Zahl (Anzahl von Rasterspalten)

datei (Text, optional)

  Dateiname des Bildes. Kann entweder eine Datei im Suchpfad sein oder ein file-URI-Schema (z.B. `file:///pfad/zum/bild.pdf`).

dpiwarnung (Zahl, optional)

  Warnung ausgeben, wenn das Bild eine geringere Auflösung bekommt als angegeben.

href (Text, optional)

  Eine URL (http://...) des Bildes. Wird herunter geladen und in `TEMPDIR/sp/images` (kann mit der Einstellung `imagecache` in der Konfigurationsdatei geändert werden) zwischengespeichert. Alternativ zur Angabe »datei«.

höhe (Zahl oder Längenangabe, optional)

  Bildhöhe. Angabe in der Form 'auto' (Voreinstellung, natürliche Bildbreite), Längenangabe wie '4cm' oder Zahl (Anzahl von Rasterspalten)

maxbreite (Zahl oder Längenangabe, optional)

  Die maximale Breite des Bilds. Nur, wenn ausschnitt="nein". Angabe in absoluten Längen, Rasterzellen oder »100%« für volle Breite.

maxhöhe (Zahl oder Längenangabe, optional)

  Die maximale Breite des Bilds. Nur, wenn ausschnitt="nein". Angabe in absoluten Längen oder Anzahl Rasterzellen.

maximale-größe (Text, optional)

  Die PDF-Box, die die maximale Größe angibt. Voreinstellung ist »cropbox«.

minbreite (Zahl oder Längenangabe, optional)

  Die minimale Breite des Bilds. Nur, wenn ausschnitt="nein". Angabe in absoluten Längen, Rasterzellen oder »100%« für volle Breite.

minhöhe (Zahl oder Längenangabe, optional)

  Die minimale Breite des Bilds. Nur, wenn ausschnitt="nein". Angabe in absoluten Längen oder Anzahl Rasterzellen.

natürliche-größe (Text, optional)

  Die PDF-Box, die den sichtbaren Bereich angibt. Voreinstellung ist »cropbox«.

seite (Zahl, optional)

  Die Seitenzahl aus dem PDF. Voreinstellung ist 1.

### Bemerkungen

Die Werte der Attribute natürliche-größe und maximale-größe können artbox, bleedbox, cropbox, mediabox und trimbox sein. Diese beiden Angaben werden dafür benutzt, um das eingebundene Bild für den Anschnitt zu vergrößern. Im zweiten Beispiel unten ist der gewünschte Bildausschnitt in der »artbox« definiert, die Grafik in der PDF-Datei hat aber noch eine Beschnittzugabe, deren Ausmaß hier in der »cropbox« beschrieben ist. Die im zweiten Beispiel angegebene Breite entspricht der Papierbreite, so dass das der Inhalt der »artbox« 21cm breit dargestellt wird, der Anschnitt um das Bild herum aber weiterhin existiert.

## Beispiel

    <Datensatz element="produktbild">
      <ObjektAusgeben spalte="{ $spalte }">
        <Bild breite="10" datei="{string(.)}" />
      </ObjektAusgeben>
    </Datensatz>

Nimmt den Dateinamen des Bildes aus dem Elementinhalt »produktbild« aus der Datensatzdatei, z.B.

    <produktbild>grafik.pdf</produktbild>

Folgendes Beispiel nimmt eine Seite aus einer PDF Datei:

    <ObjektAusgeben spalte="0mm" zeile="0mm">
      <Bild breite="210mm" datei="katalog.pdf" seite="132" natürliche-größe="artbox" />
    </ObjektAusgeben>

## Hinweis

Die Anzahl der Seiten in einer PDF-Datei kann mit der XPath-Funktion `sd:anzahl-seiten()` ermittelt werden.

## Siehe auch

ObjektAusgeben

# Befehlsübersicht

- A
- Absatz
- Aktion
- Attribut
- Ausgabe
- B
- BearbeiteKnoten
- BeiSeitenAusgabe
- BeiSeitenErzeugung
- Bild
- Bis
- Box
- Br
- Datensatz
- DefiniereFarbe
- DefiniereSchriftfamilie
- DefiniereTextformat
- Element
- Fall
- Fallunterscheidung
- Farbe
- Fett
- FettKursiv
- FürAlle
- Gruppe
- HLeerraum
- I
- Include
- Indexerstellen
- Inhalt
- Kopie-von
- Kursiv
- LadeDatensatzdatei
- LadeSchriftdatei
- Layout
- Leerzeile
- Lesezeichen
- Li
- Linie
- Marke
- Nachricht
- NeueSeite
- NeueZeile
- Normal
- NächsterRahmen
- ObjektAusgeben
- Ol
- Optionen
- Platzierungsbereich
- Platzierungsrahmen
- Rahmen
- Rand
- Raster
- Schleife
- Schriftart
- SeitenEinfügen
- SeitenSpeichern
- Seitenformat
- Seitentyp
- Sequenz
- SetzeRaster
- Solange
- Sonst
- SortiereSequenz
- Spalte
- Spalten
- SpeichereDatensatzdatei
- Strichcode
- Stylesheet
- Sub
- Sup
- Tabelle
- Tabellenfuß
- Tabellenkopf
- Td
- Text
- Textblock
- Tlinie
- Tr
- Transformation
- Trennvorschlag
- U
- URL
- Ul
- VLeerraum
- Wert
- ZurListeHinzufügen
- Zuweisung

Version: 2.2.0 | Startseite | Befehlsreferenz | Andere Sprache: Englisch