vol_label_volume_render — VOLCOLOR render op

• 資料種類:labels → rgbimage

• 呼叫: import fullseye as fs; fs.ledger.vol_label_volume_render(labels, axis='z', mode: 'str' = 'front', seed: 'int' = 0, alpha: 'float' = 0.35, background=(0.0, 0.0, 0.0))(要直接呼叫實作,import volcolor; volcolor.vol_label_volume_render(labels, axis='z', mode: 'str' = 'front', seed: 'int' = 0, alpha: 'float' = 0.35, background=(0.0, 0.0, 0.0));從台帳取用則 opsvolcolor.get("vol_label_volume_render"))

用法

彩色標籤的合成投影 (H, W, 3),僅用 numpy 生成。

*mode*:

• "front" —— 沿視線方向最先命中的非背景體素的顏色(不透明顯示)。

• "back" —— 最後命中的那個(從背面看到的形狀)。

• "alpha" —— front-to-back 的 over 合成(Porter & Duff 1984)。設非背景體素具有不透明度 *alpha*,從近處向遠處疊加。能表現深度方向的重疊,另一方面近處的顏色必定比後面的更濃。

拒絕 mode="max"(ValueError)。對 RGB 逐通道取 max 時,會得到紅色分量來自零件 A、綠色分量來自零件 B 的不屬於任何零件的顏色。實測(在 z 方向錯開重疊的 3 塊板、(16, 16, 16),

seed=0,axis="z"): 逐通道 max 的投影 (16, 16) 在前景 168 像素中有 90 像素產生了與調色盤任何一列都不一致的顏色。對同一輸入, "front" 的 256 像素全部是調色盤的顏色(tests/test_volcolor.py::test_channelwise_max_would_invent_colours)。

*axis* 為 "z"/0(回傳 (H, W, 3))、"y"/1((D, W, 3))、"x"/2((D, H, 3))。

對未知的 *mode* / *axis*、在 [0, 1] 之外的 *alpha*, 或不正確的標籤體資料,拋出 ValueError。

參考(範例資料、文獻)

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

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

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

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

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

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

—

同類別(render)

vol_labels_to_meshes

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

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