vol_label_volume_render — VOLCOLOR render op

• Data kinds: labels → rgbimage

• Call: 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)) (implementation को सीधे call करना हो तो 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)), registry से लेना हो तो opsvolcolor.get("vol_label_volume_render"))

उपयोग

रंगीन label का composited projection (H, W, 3) केवल numpy से बनाता है।

*mode*:

• "front" -- देखने की दिशा में सबसे पहले टकराने वाले non-background voxel का रंग (opaque display)।

• "back" -- सबसे आख़िर में टकराने वाला (पीछे की ओर से दिखने वाला shape)।

• "alpha" -- front-to-back over compositing (Porter & Duff 1984)। non-background voxel की opacity *alpha* मानकर आगे से परतें जमाई जाती हैं। depth में overlap दिखता है, पर आगे का रंग हमेशा पीछे वाले से गहरा आता है।

mode="max" अस्वीकार किया जाता है (ValueError)। RGB का हर channel पर max लेने से, लाल component part A से और हरा component part B से आकर, किसी भी part का न होने वाला रंग बनता है। measured (z दिशा में खिसककर overlap होने वाली 3 plate, (16, 16, 16), seed=0, axis="z"): channel-wise max का projection (16, 16) 168 foreground pixel में से 90 pixel में palette की किसी भी row से मेल न खाने वाला रंग बना। उसी input के लिए "front" के सभी 256 pixel palette के रंग हैं (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*, या ग़लत label volume पर ValueError देता है।

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

वे अगले ops जिनसे type जुड़ता है (rgbimage को input के रूप में लेते हैं)

—

इसी category के (render)

vol_labels_to_meshes

*Provenance: volcolor.py — VOLCOLOR operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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