volseq_pathline_render — LIVE4D flow op

• 数据种类:volseq → rgb

• 调用: import fullseye as fs; fs.ledger.volseq_pathline_render(volseq, n_seeds: 'int' = 200, yaw: 'float' = 35.0, pitch: 'float' = 25.0, size: 'int' = 256, static_alpha: 'float' = 0.03, win: 'int' = 3, pyr_levels: 'int' = 3, iters: 'int' = 5, reg: 'float' = 0.001, seed: 'int' = 0, trail_sigma: 'float' = 0.7, min_speed: 'float' = 0.1, min_intensity: 'float' = 0.3) -> 'np.ndarray'(要直接调用实现,import live4d; live4d.volseq_pathline_render(volseq, n_seeds: 'int' = 200, yaw: 'float' = 35.0, pitch: 'float' = 25.0, size: 'int' = 256, static_alpha: 'float' = 0.03, win: 'int' = 3, pyr_levels: 'int' = 3, iters: 'int' = 5, reg: 'float' = 0.001, seed: 'int' = 0, trail_sigma: 'float' = 0.7, min_speed: 'float' = 0.1, min_intensity: 'float' = 0.3) -> 'np.ndarray';从台账取用则 opslive4d.get("volseq_pathline_render"))

用法

让粒子随流动而绘出的轨迹立体 (size, size, 3)(rgb)——用一张静止图像展示运动。

用相邻帧之间的位移场(vol_flow_3d),把从运动中(速度 >= min_speed)且明亮(不低于首帧值域的 min_intensity = 有结构)的地方撒下的 n_seeds 个粒子按位移场的映射平流, 把轨迹以时刻的颜色(蓝 = 开始 → 红 = 结束)画进立方体,再用 vol_render_transfer 从任意视点合成。static_alpha > 0 时以浅灰叠上首帧的亮度(流经何处的线索)。trail_sigma 是轨迹的粗细(voxel)。没有纹理的地方流无法确定(孔径问题),所以种子只限于明亮处 —— 只按速度选的话,种子也会落到漆黑的角落,立方体被轨迹填满(实测)。

详细使用指南

• live4d 族使用指南

参考(示例数据、文献)

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

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

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

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

• poc_live4d — py -3.11 examples/poc_live4d.py

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

—

同类别(flow)

vol_flow_3d · volseq_speed · volseq_pathline_orbit


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

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