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)。
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• 算法的正典(作者・年份)与用途见上面的族使用指南。
• defect_to_cad — py -3.11 examples/defect_to_cad.py
table 作为输入)—
project)—
*Provenance: cadmap.py — CADMAP 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.