https://manael.org/ja/docs/usage/ Recent content in 使い方 on Manael Hugo -- gohugo.io ja https://manael.org/ja/docs/usage/supported-formats/ Mon, 01 Jan 0001 00:00:00 +0000 https://manael.org/ja/docs/usage/supported-formats/ このページでは、Manael が入力として受け付ける画像フォーマットと、出力するフォーマットについて説明します。 変換対応表 入力フォーマット 出力フォーマット 備考 JPEG WebP / AVIF（有効な場合） PNG WebP PNG から AVIF への変換は意図的に無効化されています APNG パススルー（元の APNG をそのまま返却） アニメーションデータの損失を防ぐため変換をスキップします アニメーション GIF パススルー（元の GIF をそのまま返却） アニメーションデータの損失を防ぐため変換をスキップします 静止画 GIF WebP v2.1.0 で追加 補足説明 JPEG のみ AVIF 変換に対応 AVIF への変換は JPEG ソース画像のみをサポートしています。PNG 画像は透明度の保持と幅広い互換性を確保するため、意図的に AVIF 変換の対象外となっています。PNG 画像はクライアントが対応している場合に引き続き WebP へ変換されます。 アニメーション画像はパススルー Manael はアニメーション PNG (APNG) およびアニメーション GIF を自動的に検出し、変換せずにそのままクライアントへ返します。アニメーション画像を WebP や AVIF の静止フレームに変換するとアニメーションデータが失われるため、この動作によりそれを防いでいます。クライアントが送信する Accept ヘッダーの内容に関わらず、元のファイルがそのまま返されます。 https://manael.org/ja/docs/usage/image-resizing/ Mon, 01 Jan 0001 00:00:00 +0000 https://manael.org/ja/docs/usage/image-resizing/ Manael は w、h、fit クエリパラメーターを使用して画像をオンザフライでリサイズできます。 リサイズを有効にする 画像リサイズはデフォルトで無効になっており、MANAEL_ENABLE_RESIZE 環境変数を true に設定することで明示的に有効にする必要があります。 MANAEL_ENABLE_RESIZE=true manael -http=:8080 -upstream_url=http://localhost:9000 MANAEL_ENABLE_RESIZE が true に設定されていない場合、w、h、fit クエリパラメーターは無視され、画像は元のサイズのまま変換されます。 使い方 リサイズが有効な場合、画像 URL に w や h クエリパラメーターを追加してターゲットの寸法を指定します。 curl -sI -H "Accept: image/webp" "http://localhost:8080/image.jpg?w=800&h=600" パラメーター 説明 w ターゲットの幅（ピクセル、正の整数）。 h ターゲットの高さ（ピクセル、正の整数）。 fit リサイズモード: cover、contain、または scale-down。デフォルトは contain。 アスペクト比 一方の寸法のみを指定した場合、Manael は元の画像のアスペクト比を維持します。 幅のみ（?w=300）: 幅が 300 px になるよう画像をスケールします。高さはアスペクト比を維持しながら自動的に調整されます。 高さのみ（?h=300）: 高さが 300 px になるよう画像をスケールします。幅はアスペクト比を維持しながら自動的に調整されます。 両方の寸法（?w=300&h=300）: 動作は fit パラメーターによって制御されます。 contain（デフォルト）: アスペクト比を維持しながら、ターゲットのボックス内に収まるよう画像をスケールします。結果として得られる画像は指定した寸法より小さくなる場合があります。 cover: アスペクト比を維持しながら、ターゲットのボックス全体を埋めるよう画像をスケールおよびクロップします。 scale-down: contain と同様ですが、元の寸法を超えて拡大されることはありません。 セキュリティ制限 過剰なリソース使用を防ぐため、クライアントがリクエストできる寸法を制限することができます。 最大寸法 MANAEL_MAX_RESIZE_WIDTH および MANAEL_MAX_RESIZE_HEIGHT を設定すると、w と h に受け付ける値の上限を設定できます。設定した上限を超えるリクエストは 400 Bad Request レスポンスで拒否されます。 https://manael.org/ja/docs/usage/quality-control/ Mon, 01 Jan 0001 00:00:00 +0000 https://manael.org/ja/docs/usage/quality-control/ Manael はクライアントが q クエリパラメーターを通じて変換後の画像のエンコード品質を制御できます。 使い方 画像 URL に q クエリパラメーターを追加して、目的のエンコード品質を指定します。値は 1 から 100 の整数で、値が高いほど品質が良くなりますがファイルサイズも大きくなります。 curl -sI -H "Accept: image/webp" "http://localhost:8080/image.jpg?q=80" 有効な範囲 q パラメーターは 1 から 100（両端含む）の整数値を受け付けます。範囲外の値は自動的にクランプされます。 1 未満の値は 1 として扱われます。 100 を超える値は 100 として扱われます。 フォーマット別の品質指定 フォーマット:値 構文を使用して特定の出力フォーマットを対象にすることができます。複数のフォーマット別の値はカンマ区切りリストで q パラメーターにまとめることができます。 # WebP のみ品質を指定する curl -sI -H "Accept: image/webp" "http://localhost:8080/image.jpg?q=webp:75" # WebP と AVIF それぞれの品質を個別に指定する curl -sI -H "Accept: image/avif,image/webp" "http://localhost:8080/image.jpg?q=webp:80,avif:50" # 汎用品質と WebP 固有のオーバーライドを組み合わせる curl -sI -H "Accept: image/webp" "http://localhost:8080/image.jpg?q=70,webp:85" 構文 説明 ?