グラデーションNDフィルター計算

無効 な 測光 、 空 と 地面 の 逆転 、 範囲 外 の 地平線 は invalid_input で 失敗 し 、 課金 され ません 。

空と前景の EV が GND 強度になる仕組み

グラデーション ND は写真の段で指定され、露出値と同じ単位です。半段未満は 0 と no filter ラベルに落ちます。ほぼ均衡した場面を 1 段の板で暗くし過ぎるためです。5 を超える値は 5 段推奨にクランプし、単板よりスタックや露出合成が良いという短い注記を付けます。測光値は捏造しません。 空が地面より実際に暗い場合は要求を拒否します。空側を暗くするグラデーションは不均衡を直すどころか悪化させるからです。スポットメーター（またはカメラのスポット測光）が明るい空に sky_ev 15、暗い地面に foreground_ev 12 を返すと、場面は 3 段のコントラストを持ち、delta_stops は sky_ev から foreground_ev を引いた値です。この 3 段の差こそ、0.9 の hard または soft の GND が取り除くために売られている量です。任意の keep_stops を使うと、空が芝生と同じ暗さに見えないよう自然な差を残せます。needed_stops はそのとき delta_stops から keep_stops を引いた値です。エンジンは needed_stops を 0 から 5 の閉じた集合の最も近い整数へ丸め、市販の ND2、ND4、ND8、ND16、ND32（光学密度 0.3、0.6、0.9、1.2、1.5）に合わせます。暗い部分の透過は 2 の recommended_stops 乗分の 1 なので、3 段 GND は空の光の 12.5 パーセントを通します。remaining_contrast_stops はその推奨板のあとに残る場面コントラストです。

地平線上のハード・ソフト・リバース遷移

直線の海・湖・草原なら horizon_type を flat にします。山・森・折れ線のスカイラインなら horizon_type を irregular にします。太陽が地平線にあり最明部が天頂ではなく帯なら horizon_type を sunset にします。horizon_percent はフレーム下端から測り（下端が 0、上が 100）、既定は 50 です。任意の filter_height_mm は既定 100 ミリを上書きし、75 ミリや 150 ミリのホルダーでも開始・終了・幅をその単位で返します。

入力契約、失敗、数値が使われる場面

失敗はプリペイド残高を消費しません。5 段以内のときのスタック注記など、当てはまらない任意出力キーは null にせず省略します。図が必要ならホルダー目盛りやライブビュー重ね合わせと組み合わせてください。本能力は段と配置だけを計算し、画像バイトには触れません。必須の有限 sky_ev と foreground_ev（区間は −20 から 30）と、horizon_type を文字列 flat、irregular、sunset のいずれかにした JSON を POST します。任意の horizon_percent は 0 以上 100 以下、任意の keep_stops は 0 以上 10 以下、任意の filter_height_mm は 20 以上 200 以下です。ev_sky、fg_ev、style、filter_mm などの別名も受け付け、表計算や型付きフォームが同じ契約を再利用できます。成功時は入力をエコーし、delta_stops、needed_stops、recommended_stops、optical_density、nd_factor、nd_label、gnd_label、transition_style、フェードの開始・終了・中心・幅（パーセントとミリ）、remaining_contrast_stops、暗部の transmission と transmission_percent、filter_needed フラグを返します。formula 文字列とメソッドタグ graduated_nd_transition で API クライアントは自己説明的になります。測光欠落、非有限数、地面より暗い逆転した空、未知の horizon_type、範囲外パーセントは invalid_input でフィールド名を示します。実装は純粋 parse の tier A のため、成功呼び出しは公開の基本価格 $0.002 で、モデルトークンも外向き通信もありません。