# bx:bild

<!-- last_modified: 05. Mar 2020 -->
Das Tag `bild` fügt ein Bild aus der Bildergalerie in das Dokument ein und lässt vielfältige Möglichkeiten zur Formatierung. Falls dasselbe Bild mehrmals verwendet werden soll, kann { `titel}` mehrmals verwendet werden mit z.B. verschiedenen Größenangaben.

Dieses Tag kann sich in der Verwaltung darstellen.

## Bild anzeigen mit Größenangabe und Ausrichtung

```xml
<bx:bild.{titel} [width="{n}"] [height="{n}"] [align="(left | right | leftright | rightleft)"] [alt="{text}"] [comment={komentar}] />
```

### width, height
Breiten- bzw Höhenangabe in Pixel; Bilder, die kleiner sind als diese Größenangaben werden jedoch nicht vergrößert. Ist keine Höhe und Breite angegeben, wird das Bild in Originalgröße dargestellt.

### cover
nimmt die größere Angabe, z.B. bei Querformat wird die Höhe, bei Hochformat die Breite genommen (ab V 2.6.3, ansonsten bei 2.6.2 reinkopieren)

### cover="crop"
Originalbild wird abgeschnitten und auch so gespeichert

### align
links- bzw. rechtsseitige Ausrichtung; leftright/rightleft: die Bilder werden abwechselnd ausgerichtet, beginnend links bzw rechts

### Beispiele

**einfache Anzeige mit Alt-Angabe**
```xml
<bx:bild.Seitenbild width="700" height="150" alt="Seitenbild dieser Seite" />
```
**Anzeige mit Kommentar in der Verwaltung**

```xml
 <bx:bild.Seitenbild width="200" height="300" align="right" comment="nichts ausgewählt: Text zieht sich über die gesamte Breite" />
```

## Ausgabeart festlegen

```xml
<bx:bild.{titel} [type="(path | url | origwidth | origheight | title | author | alt | calcwidth | calcheight | id | inline)"] />
```

### path / url
es wird nur der lokale Pfad bzw die URL zum Bild ausgegeben (z.B. Angabe im img-tag oder bei Wechsel der Grafik durch JavaScript)

### origwidth / origheight
schreibt nur die Originalbreite oder -höhe (z.B. für Popup-Fenster)

### title
der ursprüngliche Dateiname (gespeichert direkt in der Bildergalerie beim Bild)

### author
Autor, falls keiner angegeben "null" (gespeichert direkt in der Bildergalerie beim Bild)

### alt
der Alternativtext (gespeichert direkt in der Bildergalerie beim Bild)

### calcwidth / calcheight
die berechnete Größe (unter Beachtung von width und height) wird ausgegeben

### empty
Abfrage, ob ein Bild verknüpft wurde (ab v 2.7.0), `not` kehrt die Bedingung um

### id
ID in der Bildergalerie (ab v 2.6.2)

### inline
erzeugt img-Tag mit Binärdaten in src (ab 2.6.1), sinnvoll bei Newsletter, da steht das Bild direkt in der Seite, also nicht als Link oder Anhang

### base64data
Tagerweiterung für vcf (Outlook-Visitenkarte) mit Foto ab v2.6.6

### Beispiele

**Anzeige mit img-tag, Angaben kommen alle aus der Bildergalerie**

```xml
<img src="<bx:bild.Seitenbild width="200" height="300" type="url"/>" alt="<bx:bild.Seitenbild type="alt"/>" 
  title="<bx:bild.Seitenbild type="title"/>, Autor:<bx:bild.Seitenbild type="author"/>" >
```

## Weitere Angaben

```xml
<bx:bild.{titel} [hspace="{n}"] [vspace="{n}"] [kategorie="{kat}"] [force] [nogifshrink] [border="{n}"] [noborder] />
```

### vspace, hspace
Vertikal- bzw. Horizontalabstand einstellen (in Pixel)

### nogifshrink
falls das Bild ein GIF ist und es nicht automatisch verkleinert werden soll, Animationen bleiben so erhalten

### kat, force
es kann der Name einer Kategorie der Bildergalerie angegeben werden, aus der das Bild gewählt werden kann. Wenn zusätzlich noch force gesetzt ist, kann die Kategorie in der Verwaltung nicht gewechselt werden.

### border, noborder
Einstellen der Rahmenbreite bzw. Rahmen abstellen