volseq_render_orbit — LIVE4D render op

• 資料種類:volseq → rgbvideo

• 呼叫: import fullseye as fs; fs.ledger.volseq_render_orbit(volseq, n_frames: 'int' = 36, pitch: 'float' = 25.0, yaw_start: 'float' = 0.0, yaw_span: 'float' = 360.0, size: 'int' = 256, mode: 'str' = 'intensity', loops: 'int' = 1, percentile: 'float' = 99.5, floor: 'float' = 0.0, opacity_gain: 'float' = 1.0, depth_samples: 'int | None' = None, win: 'int' = 3, pyr_levels: 'int' = 3, iters: 'int' = 5, reg: 'float' = 0.001) -> 'np.ndarray'(要直接呼叫實作,import live4d; live4d.volseq_render_orbit(volseq, n_frames: 'int' = 36, pitch: 'float' = 25.0, yaw_start: 'float' = 0.0, yaw_span: 'float' = 360.0, size: 'int' = 256, mode: 'str' = 'intensity', loops: 'int' = 1, percentile: 'float' = 99.5, floor: 'float' = 0.0, opacity_gain: 'float' = 1.0, depth_samples: 'int | None' = None, win: 'int' = 3, pyr_levels: 'int' = 3, iters: 'int' = 5, reg: 'float' = 0.001) -> 'np.ndarray';從台帳取用則 opslive4d.get("volseq_render_orbit"))

用法

一邊推進時間一邊旋轉視點來繪製體積時間序列 (n_frames, size, size, 3)(rgbvideo)。

第 i 影格把時刻 t = (i / n_frames) · T · loops mod T(相鄰體積的線性內插)的體積, 從 yaw yaw_start + yaw_span · i / n_frames 用 vol_render_transfer 合成。不透明度為亮度(以整個序列的 percentile 正規化,低於 floor 為透明)。mode="intensity" 依灰階亮度上色, mode="speed" 依相鄰影格之間的速度(volseq_speed,藍 = 慢 → 紅 = 快)上色。把時間轉 loops 圈,就能在 1 圈軌道中多次看到搏動。可用 video_write_gif 直接做成 GIF。

詳細使用指南

• live4d 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

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

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_live4d — py -3.11 examples/poc_live4d.py

型別可銜接的下一個運算子(可接受 rgbvideo 作為輸入)

—

同類別(render)

focus_sweep_height_video · focus_sweep_surface_video


*Provenance: live4d.py — LIVE4D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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