supersample_mesh — 3D `render` op

• 資料種類:mesh → image2d

• 呼叫: import fullseye as fs; fs.ledger.supersample_mesh(V, F, pose=None, intrinsics=None, size=256, ss: 'int' = 3, light=(0.0, 0.0, 1.0), ambient: 'float' = 0.1, shade: 'Optional[Callable[[dict], np.ndarray]]' = None, filter: 'str' = 'box') -> 'np.ndarray'(要直接呼叫實作,import render_ssaa; render_ssaa.supersample_mesh(V, F, pose=None, intrinsics=None, size=256, ss: 'int' = 3, light=(0.0, 0.0, 1.0), ambient: 'float' = 0.1, shade: 'Optional[Callable[[dict], np.ndarray]]' = None, filter: 'str' = 'box') -> 'np.ndarray';從台帳取用則 ops3d.get("supersample_mesh"))

用法

用 SSAA 抗鋸齒算繪網格 -> float 影像 (H, W)(或 (H, W, C))。

以目標尺寸的 ss 倍呼叫 render_mesh,著色後以 ss×ss 面積平均縮小到目標 size。ss=1 表示不縮小 = render_mesh 原始的(有混疊的) 基線。

*pose* 為 4x4 object->camera 矩陣(與解析度無關,原樣使用)。*intrinsics* K 為 針對目標 size 的 3x3 針孔矩陣,為進行高解析度算繪,在內部將 fx, fy, cx, cy 縮放 ss 倍(輸出為目標 size,因此 K 的含義以目標為基準)。兩者均為 None 時,render_mesh 以 auto_view 自動取景(auto_view 的取景與解析度無關,因此改變 ss 構圖也相同)。

*shade* 為 shade(view_dict) -> (H*ss, W*ss[, C]) 的 callable,將高解析度 render_mesh 的輸出(depth / silhouette / normals)映射為著色影像。為 None 時使用預設的 Lambertian(以 *light* 為相機空間的光源、*ambient* 為環境光,由法線著色,背景 0)。*filter* 為縮小權重("box" / "gauss",參見 antialias)。

Fail-closed: ss 為 1 以上的整數,size 為正,size*ss 的總像素不超過 render3d.MAX_PIXELS。網格、相機的有效性由 render_mesh 檢查。

背景知識指南(該運算子背後的物理與規範)

• blender_interop — 與 Blender 搭配使用 —— 在 Blender 中建形、用 fullseye 量測(座標軸、單位、真值資料的陷阱)

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• render_ssaa — py -3.11 examples_3d/render_ssaa.py

型別可銜接的下一個運算子(可接受 `image2d` 作為輸入)

fuse_to_voxel · fit_poly_surface · eval_poly_surface · surface_form_error · background_flatten · polar_unwrap · fit_zernike · matcap_shade

同類別(`render`)

project_points · render_point_depth · render_volume_projection · render_shaded · ambient_occlusion · cast_shadow · phong_shade · matcap_shade

*Provenance: render_ssaa.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

supersample_mesh — 3D render op

用法