SwiftUI/Pencil Kit: Add Background Images That Synchronous with Canvas 2 Ways
Zusammenfassung
Kurz
Der Bericht vergleicht eine als Unteransicht eingebundene `UIImageView` mit einem SwiftUI-Hintergrund, der über Zoom- und Versatzwerte synchronisiert wird. UIKit sei einfacher, aber bei zusätzlichen interaktiven Bildern weniger flexibel; zudem beruhe es laut Autor auf einer undokumentierten Annahme über PencilKits Zoomansicht.
Mittel
Der Bericht erklärt zwei Wege, ein Hintergrundbild synchron mit einer verschiebbaren und zoombaren `PKCanvasView` zu bewegen. Beim UIKit-Ansatz fügt der Autor ein `UIImageView` in die erste Unteransicht der Canvas ein, setzt es nach hinten und dimensioniert es anhand der `contentSize`. Direkt an der Canvas angebracht, folge das Bild laut Bericht zwar der Verschiebung, aber nicht dem Zoom. Der SwiftUI-Ansatz nutzt den `background`-Modifier und überträgt Zoomfaktor und Inhaltsversatz über Bindings und Scroll- beziehungsweise Zoomereignisse. Für die Ausrichtung seien ein `GeometryReader`, der Skalierungsanker oben links und die Reihenfolge „erst skalieren, dann verschieben“ wichtig.
Der Autor hält UIKit für einfacher, sieht aber Schwierigkeiten, wenn weitere Bilder zwischen Hintergrund und Zeichnungen eingefügt und interaktiv bearbeitet werden sollen: Dann müssten Ansichten, Gesten und Bearbeitungszustände zwischen UIKit und SwiftUI vermittelt werden. Beim SwiftUI-Ansatz sei das einfacher. Als Unsicherheit nennt er die undokumentierte Annahme, PencilKit verwende dauerhaft seine erste Unteransicht als Zoomansicht. Diese interne Umsetzung konnte der Autor nicht überprüfen; eine Änderung könnte den UIKit-Weg beeinträchtigen. Systematische Leistungs- oder Kompatibilitätstests werden nicht berichtet.
Ausführlich lesen
Der Bericht zeigt zwei Möglichkeiten, in einer SwiftUI-App ein Hintergrundbild mit einer zoombaren und verschiebbaren PencilKit-Zeichenfläche (`PKCanvasView`) zu synchronisieren. Das Bild soll hinter den Zeichnungen liegen und beim Schwenken und Zoomen mit der Fläche mitwandern. Der Autor vergleicht die Ansätze vor allem nach ihrem Verhalten und ihren Einschränkungen.
Beim UIKit-Ansatz wird ein `UIImageView` in die erste Unteransicht der Canvas eingefügt, die der Autor als Teil der Scroll- und Zoomstruktur identifiziert. Das Bild erhält die Größe von `contentSize`, wird hinter die anderen Unteransichten verschoben und mit `clipsToBounds` begrenzt. Als `contentMode` empfiehlt der Bericht `.redraw`, damit die Ansicht bei geänderten Grenzen neu dargestellt wird. Ein Schalter kann das Bild über `isHidden` ein- und ausblenden; bei mehreren Bildansichten schlägt der Autor vor, sie anhand einer `restorationIdentifier` zu finden. Wird das Bild stattdessen direkt der `PKCanvasView` hinzugefügt, folgt es laut Bericht zwar der Verschiebung, aber nicht dem Zoom.
Der SwiftUI-Ansatz setzt das Bild mit dem `background`-Modifier hinter die Canvas. Zwei Bindings übertragen Zoomfaktor und Inhaltsversatz zwischen SwiftUI und `UIViewRepresentable`. Der Coordinator reagiert auf Scroll- und Zoomereignisse und aktualisiert diese Werte. Für die Ausrichtung wird das Bild mit dem gleichen Zoomfaktor skaliert, am Punkt oben links verankert und um den negativen Inhaltsversatz verschoben. Ein `GeometryReader` korrigiert außerdem laut Autor einen Versatz zwischen den Koordinatensystemen; die Reihenfolge der Modifier ist relevant: erst skalieren, dann verschieben.
Der Autor beschreibt den UIKit-Weg als kürzer und einfacher, sieht aber einen Nachteil, wenn Nutzer zusätzliche Bilder zwischen Hintergrund und Zeichnungen bearbeiten sollen. Bei UIKit müssten solche Bilder ebenfalls als `UIImageView` eingebunden werden; Gesten und Bearbeitungszustände müssten zwischen UIKit und SwiftUI übergeben werden. Mit SwiftUI-Hintergründen ließen sich zusätzliche Bilder und Gesten nach Darstellung des Autors einfacher integrieren.
Als weitere Einschränkung nennt der Bericht, dass nicht dokumentiert sei, ob PencilKit dauerhaft die erste Unteransicht als Zoomansicht verwendet. Der Autor vermutet, dass der UIKit-Ansatz derzeit deshalb funktioniert, kann diese interne Implementierung aber nicht prüfen und warnt, dass eine Änderung ihn brechen könnte. Der Text dokumentiert zwei Beispielimplementierungen und die Beobachtungen des Autors; er berichtet keine systematische Leistungs- oder Kompatibilitätsmessung.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Lunas Einordnung enthält weder Sammel- noch Teilfragen (jeweils „(keine)“), daher wurde keine Einordnung vorgenommen. Die Zusammenfassungen wurden inhaltlich geprüft; die kurze Fassung lässt den wichtigsten Punkt zur ersten Unteransicht aus, sonst sind die Angaben belegt.
Im Bericht, aber nicht in der Zusammenfassung
- Der Bericht nennt als wichtigsten Punkt des UIKit-Ansatzes, dass das UIImageView in die erste Unteransicht der PKCanvasView gehört; wird es direkt an der Canvas angebracht, folgt es dem Zoom nicht. Die kurze Fassung lässt dies aus.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.