render_lambertian — 3D photometric op

資料種類:normalmapimage2d

呼叫: import fullseye as fs; fs.ledger.render_lambertian(normals, albedo, light, ambient=0.0)(要直接呼叫實作,import photometric; photometric.render_lambertian(normals, albedo, light, ambient=0.0);從台帳取用則 ops3d.get("render_lambertian"))

用法

法線 + 反照率 + 光源方向 → Lambert 影像(檢測樣本生成 / GT 驗證 / 逆算繪的正向)。→ HxW。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

`I = albedo * (max(n·L, 0) + ambient)light` は (3,) の光源方向ベクトルで内部で

単位長に正規化する(長さは強度として効かない)。`n·L < 0` の画素は 0 にクリップ

される(付着影)。`ambient` は法線に依らず一様に足す定数で、アルベドは掛かる

(既定 0)。`normals(H,W,3) の法線(単位長を仮定し正規化しない)、albedo`

は `(H,W) またはブロードキャスト可能な配列・スカラ。返り値は float32 の (H,W)`。

上限は `albedo * (1 + ambient)` で、[0,1] へのクリップはしない。入力検証は無い。

`photometric_stereo の順方向モデルそのもの(光源正規化の規約は normalize=True`

に対応)なので、復元した法線・アルベドから再合成して元画像と比べる往復検証に使える。

鏡面・相互反射・投影影(cast shadow)は含まない。

參考(範例資料・文獻)

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

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

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

photometric_stereopy -3.11 examples_3d/photometric_stereo.py

render_shadepy -3.11 examples_3d/render_shade.py

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

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

同類別(photometric)

photometric_stereo · surface_normals · integrate_normals


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

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.