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.