メガピクセル解像度変換

未知の単位名は誤った係数を黙って返す代わりに、明確な invalid_input で失敗します。ボディのメガピクセル表記を 4000×3000 の実フレームと照合する撮影者、画像パイプラインを見積もる製品チーム、SI のメガ係数を教える教育者、混在する解像度フィールドを正規化する API クライアントは、いずれも同じ決定論的経路を必要とします。

対応する解像度単位と変換の仕組み

幅は総数×aspect_w÷aspect_h の平方根、高さは総数÷幅で、aspect_w と aspect_h を省略すると既定で十六対九の枠になります。megapixels には mp・mpx・megapixel、pixels には px・pixel count・total pixels、kilopixels には kp・kpx、gigapixels には gp・gpx、dimensions には wxh・width x height・resolution です。一覧にない名前は invalid_input で拒否し、不正なフィールド名と対応単位を示すため、誤字が誤った数になったのかをクライアントが推測する必要はありません。絶対値は公開の一兆上限内に収め、Worker とブラウザの IEEE 倍精度で中間積が有限になるようにします。

API の呼び出し方と応答の読み方

カメラ比較ツール、メディア資産パイプライン、教材、すでに解像度値を持ち表示や保存用に第二の表現だけが必要なバッチに組み込み、アプリバイナリごとに換算表を配布する必要をなくせます。JSON 本体に目標単位 to（別名 to_unit・unit_to・target）と、スカラー値または幅×高さの組を送ります。スカラーモードでは value（別名 amount・quantity・n・mp）と任意の from（別名 from_unit・unit_from・source）を指定し、from を省略して value がある場合の既定元は megapixels です。寸法モードでは正の width と height（別名 width_px・w・w_px と height_px・h・h_px）を指定し、from は dimensions でも省略でも構いません。to が dimensions のとき、任意の aspect_w と aspect_h（既定は十六と九）が復元枠の形を決めます。value・width・height・アスペクト各部は、一兆の絶対上限内の有限正数または厳密な数値文字列でなければなりません。成功時の応答は、丸めた value、正規の from と to ラベル、主換算値 result、毎回の total_pixels・megapixels・kilopixels・gigapixels、目標ラベル unit、英語の logic 要約である formula と message、順序付き代入行 steps、五つの正規識別子 supported_units を返します。寸法が入出力のときは width・height・aspect_w・aspect_h も出ます。欠落フィールド・非有限数・非正値・絶対上限外・未知単位名などの検証失敗は invalid_input を返し、課金されません。料金は成功リクエストあたり定額 $0.002（単位 item）です。

実務上のヒント・上限・このランディングを使う場面

クライアントを制御できるときは value・width・height に素の数を送るのが望ましいです。表示ラベルの地域表記が必要ならクライアント側で正規化し、本 API は常に短い正規トークン megapixels・pixels・kilopixels・gigapixels・dimensions を返すため、自動テストが安定します。invalid_input を返す失敗タスクは前払い残高を消費しないため、未知単位名を意図的に試す探索スクリプトのコストを抑えられます。