morph_sequence — SHAPE2D morph op

• 数据种类:image2d × image2d × pairs × pairs → images

• 调用: import fullseye as fs; fs.ledger.morph_sequence(imgA, imgB, ptsA, ptsB, n=7, method='affine', lam=0.0, with_corners=True)(要直接调用实现,import imagemorph; imagemorph.morph_sequence(imgA, imgB, ptsA, ptsB, n=7, method='affine', lam=0.0, with_corners=True);从台账取用则 opsshape2d.get("morph_sequence"))

用法

将 alpha 以 n 步从 0→1 变化得到的变形序列(从 A 平滑变化到 B 的各帧)。

返回值: 长度为 n 的 list。首个与 A 一致,末个与 B 一致。

只是对 alpha = linspace(0, 1, n) 的各值调用 morph(imgA, imgB, ptsA, ptsB, alpha, method, lam, with_corners)。每帧分 3 步:(1) 构造中间点 (1-α) ptsA + α ptsB,(2) 把 A 和 B 分别变形到那里,

(3) 用 α 做交叉溶解。每帧变形 2 次,因此

成本与 n 成正比(n=7 时 14 次)。

• imgA, imgB: (H, W[, C]),形状相同,[0, 1]。NaN/Inf 被静默替换为 0 / 1。

• ptsA, ptsB: (K, 2) 的 (x, y),数量相同、顺序相同的对应点。

• n: 2 以上(1 以下抛出 ValueError)。截断为 int。

• method: "affine"(Delaunay 分段仿射,快)/ "tps"(薄板样条,平滑)。其他值抛出 ValueError。lam 为 TPS 的平滑系数(0 为严格插值)。

• with_corners: 为 True 时对两组点集加上 add_frame_corners,防止框外侧的空洞。

• 返回值: n 个 float64 数组的 list(images 类型)。已裁剪到 [0, 1]。

若只要 1 幅(例: α = 0.5 的中间脸),直接用 morph。

详细使用指南

• shape_description_2d 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• image_morph — py -3.11 examples/image_morph.py

类型可衔接的下一个算子(可接受 images 作为输入)

—

同类别(morph)

add_frame_corners · warp_tps_image · warp_piecewise_affine · blend · morph


*Provenance: imagemorph.py — SHAPE2D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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