warp_piecewise_affine — SHAPE2D morph op

• Datenarten: image2d × pairs × pairs → image2d

• Aufruf: import fullseye as fs; fs.ledger.warp_piecewise_affine(img, src_pts, dst_pts, order=1) (die Implementierung direkt: import imagemorph; imagemorph.warp_piecewise_affine(img, src_pts, dst_pts, order=1); aus dem Register: opsshape2d.get("warp_piecewise_affine"))

Verwendung

Stückweise affine Verzerrung, die den Inhalt an src_pts von img nach dst_pts bewegt.

Trianguliert dst_pts nach Delaunay, bestimmt für jedes Ausgabepixel die baryzentrischen Koordinaten im zugehörigen Dreieck, bildet sie mit denselben baryzentrischen Koordinaten auf das entsprechende Dreieck auf der src_pts-Seite ab und tastet per inverser Abbildung ab. Außerhalb der konvexen Hülle (Pixel, die zu keinem Dreieck gehören) wird mit der Identität (ursprüngliche Position) abgetastet; nimmt man daher die vier Ecken in die Korrespondenzpunkte auf (add_frame_corners), wird das ganze Bild lückenlos abgedeckt.

Argumente:

img: (H,W) oder (H,W,C), [0,1].

src_pts, dst_pts: (K,2) als (x,y). Korrespondenzpunkte gleicher Anzahl und Reihenfolge.

order: Interpolationsordnung (1=bilinear).

Rückgabewert: float64 in derselben shape wie img, [0,1].

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie shape_description_2d

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• shape2d_morph_descriptor_tour — py -3.11 examples/shape2d_morph_descriptor_tour.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

warp_tps_image · blend · morph · morph_sequence

Gleiche Kategorie (morph)

add_frame_corners · warp_tps_image · blend · morph · morph_sequence


*Provenance: imagemorph.py — SHAPE2D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.