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 를 낸다.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• voxel_labels_color — py -3.11 examples/voxel_labels_color.py
rgbimage 를 입력으로 받는 것)—
render)*Provenance: volcolor.py — VOLCOLOR 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.