# Galerie

Die Galerie ist die visuelle Medienbibliothek des Gebäudes. Sie speichert Fotos, Renderings und andere Bilder im Zusammenhang mit dem Objekt und ermöglicht es Stakeholdern, das Titelbild des Gebäudes zu verwalten, Bilder öffentlich zu teilen und die visuelle Geschichte des Gebäudes zu organisieren.

***

## Übersicht

Die Galerie zeigt alle hochgeladenen Bilder in einem **unendlichen Scroll-Raster** an. Wenn Sie nach unten scrollen, werden automatisch weitere Bilder geladen, ohne Seitenumbruch. Jedes Bild im Raster wird durch ein Vorschaubild dargestellt, und beim Bewegen des Mauszeigers über ein Vorschaubild werden die verfügbaren Aktionen für dieses Bild angezeigt.

***

## Bilder hochladen

### So laden Sie hoch

Bilder werden zur Galerie hinzugefügt per Drag-and-Drop oder durch Klicken auf die Upload-Zone:

1. Ziehen Sie eine oder mehrere Bilddateien auf den Galerie-Upload-Bereich, **oder** klicken Sie auf den Bereich, um den Dateibrowser zu öffnen.
2. Wählen Sie die Datei aus, die Sie hochladen möchten.
3. Das Bild wird hochgeladen und erscheint im Galerieraster.

### Upload-Einschränkungen

| Eigenschaft          | Limit                                           |
| -------------------- | ----------------------------------------------- |
| Maximale Dateigröße  | 100 MB pro Datei                                |
| Dateien pro Upload   | 1 Datei auf einmal                              |
| Unterstützte Formate | JPG, JPEG, PNG (und andere gängige Bildformate) |

> **Hinweis:** Pro Vorgang kann nur eine Datei hochgeladen werden. Um mehrere Bilder hochzuladen, wiederholen Sie den Vorgang für jede Datei.

***

## Aktionen pro Bild

Jedes Bild in der Galerie unterstützt die folgenden Aktionen, zugänglich über Hover oder ein Kontextmenü:

### Als Gebäude-Titelbild festlegen

Legt das ausgewählte Bild als offizielles Titelfoto des Gebäudes fest. Das Titelbild erscheint:

* Auf der Gebäudekarte im Gebäude-Dashboard.
* Oben auf der Profilseite des Gebäudes.
* Auf der DTT-Karte beim Minting.

**Titelbildänderungs-Verhalten:** Wenn Sie ein neues Titelbild festlegen, wird das **vorherige Titelbild automatisch in die Galerie verschoben** anstatt gelöscht zu werden. Dadurch wird sichergestellt, dass keine Bilder verloren gehen, wenn das Titelbild aktualisiert wird. Die gleiche Heraufstufung funktioniert auch umgekehrt — Sie können jedes Galerieelement direkt aus der Galerie als Gebäude-Titelbild festlegen.

### Vollbild anzeigen (Lightbox)

Öffnet das Bild in einem Vollbild-**Lightbox-Viewer** mit Zoom- und Schwenkfähigkeiten. Mit Navigationspfeilen können Sie durch alle Galeriebilder blättern, ohne die Lightbox zu schließen.

### Teilen

Generiert einen **öffentlichen Zugriffslink** für das Bild:

1. Klicken Sie auf **Teilen** beim Bild.
2. Die Plattform generiert eine eindeutige öffentliche Zugangs-Code-URL.
3. Die URL wird automatisch **in die Zwischenablage kopiert**.
4. Jeder mit diesem Link kann das Bild ansehen, ohne sich anzumelden oder ein Magma-Konto zu haben.

Dies ist nützlich zum Teilen von Gebäudefotos mit potenziellen Mietern, Investoren oder externen Parteien, die keinen Zugang zur Plattform haben.

### Löschen

Entfernt das Bild dauerhaft aus der Galerie. Gelöschte Bilder können nicht wiederhergestellt werden.

> **Hinweis:** Wenn das Bild derzeit als Gebäude-Titelbild festgelegt ist, müssen Sie zunächst ein anderes Titelbild festlegen, bevor Sie es löschen, oder die Plattform fordert Sie auf, ein Ersatz-Titelbild auszuwählen.

***

## Das Gebäude-Titelbild festlegen

Das Gebäude-Titelbild kann auf zwei Wegen geändert werden:

1. **Aus der Galerie** — Bewegen Sie den Mauszeiger über ein beliebiges Galeriebild und klicken Sie auf **Als Gebäude-Titelbild festlegen**.
2. **Über Datei-Upload** — Wenn Sie ein neues Titelbild direkt über die Gebäudeeinstellungen oder den Gebäudeerstellungs-Assistenten (Schritt 4) hochladen, wird das alte Titelbild automatisch in die Galerie verschoben.

In beiden Fällen ist der Übergang nahtlos — keine Bilder gehen verloren und die Galerie bewahrt immer die vollständige visuelle Geschichte des Gebäudes.

***

## Galerie und Gebäudeprofil

Das über die Galerie festgelegte Titelbild ist die primäre visuelle Darstellung des Gebäudes auf der gesamten Magma-Plattform:

* **Dashboard-Karte** — Als Kartenhintergrund im Gebäude-Dashboard (Rasteransicht) angezeigt.
* **Gebäudeheader** — Oben auf der Hauptseite des Gebäudes angezeigt.
* **DTT-Karte** — In der Digital Twin Token-Karte des Gebäudes verwendet, die in den Abschnitten Belohnungen und DTT erscheint.
* **Aktivitätsfeed-Miniaturbilder** — Das Gebäude-Miniaturbild neben Aktivitätselementen im Aktivitätsfeed.

***

## Tipps und Best Practices

* Laden Sie ein **hochwertiges Außenfoto** als Gebäude-Titelbild hoch — es ist der erste visuelle Eindruck, den Stakeholder und externe Parteien vom Gebäude haben.
* Verwenden Sie die **Teilen**-Funktion, um potenziellen Mietern oder Investoren schnell eine Foto-URL bereitzustellen, ohne ein Plattformkonto für sie erstellen zu müssen.
* Halten Sie die Galerie auf dem neuesten Stand, während sich das Gebäude entwickelt — laden Sie Baufortschrittsfotos, Renovierungs-Vorher/Nachher-Aufnahmen und aktuelle Innenaufnahmen hoch, um einen genauen visuellen Nachweis zu pflegen.
* Beachten Sie, dass das **100-MB-Limit** pro Datei gilt — verwenden Sie eine standardmäßige Bildkomprimierung vor dem Hochladen, um die Ladezeiten schnell zu halten, ohne sichtbare Qualität zu opfern.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mymagma.com/magma-documentation/de/funktionen/gallery.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
