cad_surface_to_pixel — CADMAP `project` op

• Datenarten: mesh × points → table

• Aufruf: 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) (oder opscadmap.get("cad_surface_to_pixel"))

Verwendung

3-D-Punkte (N,3) → Pixel plus Sichtbarkeit (verdeckt, rückseitig und außerhalb des Bildes werden unterschieden).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

`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)。

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• defect_to_cad — py -3.11 examples/defect_to_cad.py

Typkompatible Folge-Operatoren (nehmen `table` als Eingabe)

—

Gleiche Kategorie (`project`)

—

*Provenance: cadmap.py — CADMAP Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

cad_surface_to_pixel — CADMAP project op