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.