render op• 資料種類:voxel → rgb
• 呼叫: import fullseye as fs; fs.ledger.vol_render_transfer(vol, color=None, yaw: 'float' = 35.0, pitch: 'float' = 25.0, size: 'int' = 256, alpha_gain: 'float' = 1.0, static_alpha: 'float' = 0.0, background=(0.04, 0.04, 0.06), frame: 'bool' = True, depth_samples: 'int | None' = None, static_color=None) -> 'np.ndarray'(要直接呼叫實作,import videocube; videocube.vol_render_transfer(vol, color=None, yaw: 'float' = 35.0, pitch: 'float' = 25.0, size: 'int' = 256, alpha_gain: 'float' = 1.0, static_alpha: 'float' = 0.0, background=(0.04, 0.04, 0.06), frame: 'bool' = True, depth_samples: 'int | None' = None, static_color=None) -> 'np.ndarray';從台帳取用則 opsvideocube.get("vol_render_transfer"))
以由前到後的 α 合成從任意視點繪製立方體 (size, size, 3) float [0, 1] (rgb)。
vol (T, H, W) 是不透明度 [0, 1] (video_spacetime_cube(mode="motion"))。顏色:傳入 color 時為其值(同形狀,正規化到 [0, 1])的灰階;若是 (T, H, W, 3) 的 RGB 立方體([0, 1])則用其顏色; 不傳則為時刻的顏色(藍 = 開始 → 紅 = 結束)。傳入 static_color(同形狀的灰階)時, 靜止背景的亮度取它(2026-09-21,為了讓 live4d 的軌跡繪製以 1 次合成畫出「軌跡用時刻的顏色、背景用首影格的灰」)。用時刻替軌跡上色,「往哪邊移動了」在 1 張圖上就能讀出。static_alpha > 0 時,把靜止背景(color 的亮度,沒有則為灰)淡淡疊上 —— 該值是貫穿立方體最長邊長度時的總不透明度(0.15 表示沿最長邊看到底為 15 %,沿較短邊方向則更淡),與取樣數無關(Summagator 的「靜態內容」)。正射投影,沿視線以三線性內插取 depth_samples 個點(預設 = 立方體的最大邊),C = Σ α_i c_i Π_{j<i}(1 − α_j)。frame=True 時淡淡畫出立方體的 12 條邊(方向的線索)。
yaw 是在時間軸與 x 軸所成平面內的旋轉(0 = 把時間軸看作深度 = 直接看影片的朝向),pitch 是仰角。每 1 張的計算量為 size² × depth_samples(256² × 64 約 0.3 s)。
>>> rgb = vol_render_transfer(video_spacetime_cube(clip), yaw=40.0, pitch=20.0, static_alpha=0.02)
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
• poc_print_layer_inspection — py -3.11 examples/poc_print_layer_inspection.py
• poc_video_cube — py -3.11 examples/poc_video_cube.py
rgb 作為輸入)—
render)*Provenance: videocube.py — VIDEOCUBE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.