Bildformate

Ablago liest selbst nur PDF, JPEG und PNG. Mit dem Paket Bildformate bekommen auch TIFF-Scans (auch mehrseitig, wie sie viele Dokumentenscanner speichern), WebP, GIF und BMP ein Vorschaubild und einen Volltext: Das Paket wandelt jede solche Datei in eine Fassung, die Ablago kennt – daraus macht Ablago das Vorschaubild und liest den Text (bei Scans über das Paket Texterkennung). Das Original bleibt das Dokument; Herunterladen, Weitergeben und Versionen betreffen weiter die Originaldatei.

Es läuft im Paket-Läufer von Ablago: abgeschottet, ohne Netz, mit Grenzen für Speicher und Zeit.

So arbeitet es

1. Eine TIFF-, WebP-, GIF- oder BMP-Datei kommt in Ablago. Ablago meldet sie dem Paket (Ereignis Datei umwandeln); am Dokument steht so lange „wartet auf Umwandlung (Paket Bildformate)“.
2. Das Paket liest die Datei, erkennt den Typ am Inhalt (nicht am Namen) und gibt die Fassung zurück:

1. Ablago macht aus der Fassung das Vorschaubild und den Volltext. Am Dokument steht dann z. B. „Texterkennung durch Paket Texterkennung 2.0.0“ und „aus der umgewandelten Fassung (Bildformate 1.0.0)“ mit Fassung ansehen; das Vorschaubild hat den Hinweis „Vorschau aus der umgewandelten Fassung eines Pakets“; in der Historie der Mappe „umgewandelte Fassung erstellt – TIFF → PDF (Bildformate 1.0.0)“.
2. Vorhandene Dateien: Beim Installieren gibt Ablago alle vorhandenen TIFF-, WebP-, GIF- und BMP-Dateien an das Paket. Später holt Werkbank → Wartungsoperationen → Vorschaubilder nachholen fehlende Fassungen nach (etwa nach einer Wiederherstellung – Fassungen gehen nicht in die Sicherung).

Kann das Paket eine Datei nicht lesen (beschädigt, unbekannte Variante), steht der Grund am Dokument („Umwandlung durch Paket Bildformate: TIFF lässt sich nicht lesen: …“).

Rechte und Netzwerkzugriff

Bei der Installation zeigt Ablago diese Rechte und lässt sie dich bestätigen:

• Mappen lesen: alle Mappentypen – Dokumente liegen in Mappen beliebiger Typen; die Mappen selbst liest das Paket nicht.
• Dokumente lesen – es liest die Originaldatei. Dokumente ändert, ersetzt oder löscht es nicht.
• Dateien umwandeln, die Ablago nicht selbst lesen kann – das Paket liest die Originaldatei und liefert eine Fassung (PDF, PNG oder JPEG) für Vorschaubild und Volltext; das Original bleibt unverändert (dms:umwandeln): TIFF, WebP, GIF, BMP – Ablago gibt diese Dateitypen an das Paket und nimmt die Fassung an.
• Kein Netz. Alles geschieht im Paket.
• Es reagiert auf Eine Datei soll umgewandelt werden (datei.umwandeln).

Einstellungen

Unter Werkbank → Pakete → Bildformate → Einstellungen:

Messung

Gemessen am 02.11.2026 auf amd64 mit 2 Kernen (nebenher belastet), Node 22, nur das Umwandeln im Modul (node tests/modul_test.mjs <ordner> --messen), mit erfundenen Testseiten:

In Ablago (Paket-Läufer, mit dem Paket Texterkennung): ein zweiseitiger TIFF-Scan war vom Hochladen bis zum fertigen Volltext nach etwa 5 Sekunden durchsuchbar, die Umwandlung selbst dauerte unter einer Sekunde. Das Modul ist 1,2 MB groß.

Grenzen

• Höchstens 36 Millionen Bildpunkte je Seite bzw. Bild (A3 mit 400 dpi passt) und 50 MB je Datei und Fassung; größere Dateien gibt Ablago gar nicht erst ab.
• Ein beschädigtes JPEG innerhalb eines TIFF beendet den Aufruf (WebAssembly ohne setjmp); der Paket-Läufer versucht es dann einige Male und meldet einen Fehler.
• TIFF mit 12 oder 16 Bit je Kanal liest das Paket über libtiff als 8 Bit; Farbprofile werden nicht umgerechnet.
• HEIC (Fotos vom iPhone) wandelt es nicht um – siehe unten. Office-Dateien und E-Mails auch nicht (geplant mit #30).

Warum kein HEIC? Warum kein Office?

• HEIC/HEIF speichert Bilder mit HEVC (H.265). Die freien Decoder (libheif mit libde265) stehen unter LGPL-3.0 – das ginge mit einem eigenen Paket unter LGPL-3.0-or-later. Für HEVC verlangen aber mehrere Patentpools Lizenzen auch für Software-Decoder; ob und wie das offizielle Katalog-Paket das darf, klären wir vorher (dms-registry #48). Bis dahin: auf dem iPhone Einstellungen → Kamera → Formate → Maximale Kompatibilität (dann speichert es JPEG); beim Hochladen über den Browser wandelt iOS Fotos aus der Mediathek meist schon selbst in JPEG.
• Office (Word, Excel, PowerPoint, OpenDocument) bräuchte ein ganzes Office-Paket als WebAssembly. LibreOffice ist dafür ein Vielfaches größer als die Grenze von 32 MB je Paket; kleinere Bibliotheken setzen Office-Dateien nicht verlässlich. Das gehört zu #30 (Office und E-Mail) und kommt als eigenes Paket – die Schnittstelle von Ablago dafür gibt es schon (siehe unten).

Voraussetzungen

• Ablago 0.137.0 oder neuer (Schnittstelle „Dateien umwandeln“, dms:umwandeln).
• Für den Text aus Scans: das Paket Texterkennung (2.0 oder neuer). Ohne das Paket bekommen umgewandelte Scans ein Vorschaubild, aber erst mit ihm einen Volltext.

Für Entwickler

WASI_SDK=$(werkzeuge/wasi-sdk.sh) python3 werkzeuge/bauen.py pakete/bildformate   # beim ersten Mal einige Minuten
pakete/bildformate/tests/pruefen.sh                                                 # bauen und alle Tests

libtiff holt der Bau vom Original auf gitlab.com (Tag v4.7.1); so baut auch die CI. Ist gitlab.com nicht erreichbar, nimmt der Bau mit LIBTIFF_QUELLE=https://github.com/libsdl-org/libtiff den GitHub-Spiegel – der Commit (5fe20d0e…) ist derselbe und wird in beiden Fällen geprüft.

Die Schnittstelle – wie ein Paket mit Ablago spricht und welche Formate es zurückgeben darf – beschreibt das Entwicklerhandbuch von Ablago unter Dateien umwandeln.

Lizenz

Apache-2.0 (siehe LICENSE). Im Modul stecken fremde Bibliotheken; ihre Lizenztexte liegen unter code/lizenzen/:

Diese Software beruht teilweise auf der Arbeit der Independent JPEG Group. – This software is based in part on the work of the Independent JPEG Group.