tonemap_reinhard — 3D render op

데이터 종류: image2dimage2d

호출: import fullseye as fs; fs.ledger.tonemap_reinhard(hdr, exposure: 'float' = 1.0, white: 'float | None' = None) -> 'np.ndarray'(구현을 직접 호출하려면 import render_tonemap; render_tonemap.tonemap_reinhard(hdr, exposure: 'float' = 1.0, white: 'float | None' = None) -> 'np.ndarray', 원장에서 가져오려면 ops3d.get("tonemap_reinhard"))

사용법

Reinhard 톤 매핑으로 HDR 을 `[0, 1]` 의 LDR 로 압축. → float64, 입력과 같은 형상.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

露出を掛けた `x = hdr * exposure` に対し:

• `white is None … 基本形 x / (1 + x)[0, ∞)` を狭義単調増加

`[0, 1)` へ写し、決してクリップしない(全域で階調順序を厳密保存)。

• `white 指定 … 拡張形 x (1 + x/white²) / (1 + x)white` を正確に 1.0 へ

写し、`white 未満に多くのレンジを割く(white` を超える入力は 1 を超えるので

`[0, 1]` にクリップする)。

カラー `(H, W, C) はチャンネル独立に写像する。素朴クリップ min(x, 1)` と違い、

値 > 1 のハイライト域でも単調な階調を保つ。

Args:

hdr: HDR 画像。`(H, W) グレースケール or (H, W, C)` カラー、放射輝度 >= 0。

exposure: 写像前に掛ける露出スケール(正)。

white: 任意の white-point(正)。None なら基本 Reinhard(推奨・全域単調)。

Returns:

`[0, 1]` の float64 LDR 画像(入力と同形状)。

Raises:

ValueError: 空/非有限/負の放射輝度、非正の exposition/white(fail-closed)。

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

blender_interop — Blender との併用 — 形を作って fullseye で測る(軸・単位・正解データの罠)

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

render_beautypy -3.11 examples_3d/render_beauty.py

render_tonemappy -3.11 examples_3d/render_tonemap.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_tonemap.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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