SwiftUI: Add, Erase and Save Custom Drawing Annotations to PDF
Zusammenfassung
Kurz
Der Bericht erläutert eine SwiftUI-/PDFKit-Methode, die Zeichnungen zunächst als Punkte in einer Overlay-Ansicht sammelt und erst beim Abschließen als benutzerdefinierte PDF-Annotation speichert. Zum Radieren werden eigene Annotationen in Punkte zurückverwandelt und Punkte innerhalb eines kreisförmigen Bereichs entfernt. Laut Autor ist die Bearbeitung auf diese eigene Annotationsart begrenzt; systematische Tests werden nicht berichtet.
Mittel
Der Bericht zeigt eine SwiftUI- und PDFKit-Lösung, mit der Nutzende auf PDF-Seiten zeichnen und eigene Zeichnungen teilweise löschen können. Während einer Geste sammelt eine SwiftUI-Overlay-Ansicht Punkte in PDF-Koordinaten. Der Code ergänzt Zwischenpunkte, um Lücken bei schnellen Bewegungen zu verringern. Erst nach „Finish“ werden die Punkte als benutzerdefinierte `PDFAnnotation` auf der Seite gespeichert. Die PDF-Datei wird außerdem in eine temporäre Datei geschrieben, damit sie geteilt werden kann.
Zum Radieren lädt die App die Punkte ihrer eigenen Annotationen von der aktuellen Seite, entfernt diese Annotationen vorübergehend und löscht Punkte innerhalb eines kreisförmigen Radierbereichs. Beim Abschluss werden die übrig gebliebenen Punkte erneut als Annotation eingefügt. Laut Autor ist ein Beobachter für Seitenwechsel nötig, damit die Seitengrenzen bei unterschiedlich großen PDF-Seiten aktuell bleiben.
Die Bearbeitung ist auf Annotationen beschränkt, die mit der eigenen Annotationsart erstellt wurden. Zeichnungen anderer Apps und die Bearbeitung dieser Annotationen in anderen Apps werden nicht allgemein unterstützt. Der Bericht präsentiert Code und Erklärungen, aber keine systematischen Testergebnisse.
Ausführlich lesen
Der Bericht beschreibt, wie sich in einer SwiftUI-Anwendung mit PDFKit eigene Zeichnungen als PDF-Annotationen hinzufügen, teilweise löschen und speichern lassen. Der Autor geht davon aus, dass PDFKit dafür keine passende eingebaute Funktion bietet, und schlägt eine eigene Implementierung vor. Die Beispiele beziehen sich auf eine einzelne, selbst definierte Annotationsart namens `DrawingAnnotation`.
Die zentrale Idee beim Zeichnen ist, die PDF-Datei nicht bei jeder Berührung zu verändern. Stattdessen legt die App während des Zeichnens Punkte in einer SwiftUI-Ansicht über der PDF-Seite ab. Ein `DragGesture` erfasst die Eingabe; die Positionen werden anhand des Skalierungsfaktors der PDF-Ansicht in PDF-Koordinaten umgerechnet. Weil schnelle Gesten Zwischenpositionen auslassen können, berechnet der Beispielcode zusätzliche Punkte zwischen den gemeldeten Positionen. Erst wenn die Person auf „Finish“ tippt, werden die gesammelten Punkte in eine eigene `PDFAnnotation` übernommen und der PDF-Seite hinzugefügt.
Die Annotation zeichnet jeden gespeicherten Punkt als gefüllten Kreis. Dafür passt der Code das Koordinatensystem des Zeichenkontexts an. Die App speichert das PDF nach dem Hinzufügen in einer temporären Datei, damit es über `ShareLink` geteilt werden kann; laut Autor ist diese Speicherung für die Annotation selbst nicht erforderlich. Außerdem erklärt der Bericht, dass ein Beobachter für Seitenwechsel nötig sei, damit sich die berechneten Seitengrenzen beim Wechsel zu einer Seite anderer Größe aktualisieren.
Zum Löschen werden die Punkte der eigenen Annotationen der aktuellen Seite zurück in die SwiftUI-Ansicht geladen und diese Annotationen vorübergehend von der Seite entfernt. Ein kreisförmiger Radierer löscht dann gespeicherte Punkte innerhalb seines Radius. Beim Beenden werden die verbliebenen Punkte wieder als Annotation hinzugefügt und das PDF gespeichert. Der Autor weist darauf hin, dass auch nach dem Radieren dieser Schritt nötig ist.
Als wesentliche Einschränkung nennt der Bericht die Kompatibilität: Die App kann laut Autor nur Annotationen bearbeiten, die mit ihrer eigenen Kennzeichnung erstellt wurden. Zeichnungen anderer Apps lassen sich damit nicht ohne Weiteres verändern; umgekehrt können andere Apps die benutzerdefinierte Annotationsart möglicherweise nicht bearbeiten. Der Autor erwähnt gängige PDF-Annotationstypen als mögliche Alternative, garantiert dadurch aber keine universelle Bearbeitbarkeit. Der Artikel liefert Code und eine konzeptionelle Anleitung, berichtet jedoch keine systematischen Tests oder Messwerte. Erweiterungen wie auswählbare Strichbreite, Farbe und Radierergröße werden nur vorgeschlagen.
Gegengeprüft von Claude Haiku 5.5: ok
Es wurden keine Fragen zur Einordnung angegeben (Lunas Einordnung ist leer), daher ist die Liste leer. Die Bewertung bezieht sich auf die mittlere Zusammenfassung. Die kurze Zusammenfassung ist im Kern treu, lässt aber aus: Zwischenpunkte bei schnellen Gesten, die Notwendigkeit des Seitenwechsel-Observers für die Seitengrenzen und das Speichern in eine temporäre Datei zum Teilen. Insofern hat sie kleine Mängel.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.