project op• 데이터 종류: mesh × points → table
• 호출: import cadmap; cadmap.cad_surface_to_pixel(mesh, points, K=None, R=None, t=None, image_size=None, cull_backfaces=True, depth_tol=1e-06, strict=False)(또는 opscadmap.get("cad_surface_to_pixel"))
3-D 점 (N,3) → 화소 + 가시성(가려짐·뒷면·화면 밖을 구분해 돌려줍니다).
> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.
`camera.project_points` で投影したうえで、同じ画素へ光線を撃ち直して
手前に別の面が無いかを確かめる。これをやらないと、隠れている点の画素座標を
「そこに見えている」かのように返してしまう。返りは dict:
• `uv (N,2) — 画素 (u=列, v=行)。depth <= 0` の点でも
投影値は返るが `in_front = False` が立つ。
• `depth` (N,) — カメラ座標 Z。
• `in_front (N,) bool — depth > 0`。
• `in_image (N,) bool — 画枠内(0 <= u <= width-1` かつ
`0 <= v <= height-1`)。
• `occluded` (N,) bool — 同じ視線上で、その点より手前に面がある。
• `occluder_face (N,) int64 — 遮っている面。無ければ -1`。
• `visible (N,) bool — in_front & in_image & ~occluded`。
• `camera` 実際に使われたカメラ。
• `winding_fixed` bool — 内向きに巻かれた閉メッシュを検出して直したか。
`depth_tol` は「自分自身の面に遮られた」と誤判定しないための相対許容で、
遮蔽と判定するのは `z_hit < depth * (1 - depth_tol) - depth_tol` のとき。
閉じた mesh の裏側にある点は、手前の壁に遮られて `occluded = True` に
なる — これは仕様であって取りこぼしではない。
遮蔽判定は巻き方向に依存する(手前の壁が裏面としてカリングされると、
裏側の点まで `visible になる)。そのため cull_backfaces=True` では
内向きに巻かれた閉メッシュを検出し、既定では巻きを直して
`winding_fixed=True を返す。strict=True で ValueError`、
`cull_backfaces=False` では検査そのものをしない
(詳細は :func:_orient_for_culling)。
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• defect_to_cad — py -3.11 examples/defect_to_cad.py
table 를 입력으로 받는 것)—
project)—
*Provenance: cadmap.py — CADMAP 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.