画像変換機能

mod_chxjには、JPEG、GIF、PNG、BMPファイルを置いておくだけで、デバイス定義に従ってそれぞれのキャリア対応のフォーマットに変換する機能があります。 画像のサイズ（縦Ｘ横）も、端末の画面サイズに合わせて変換します。画像のサイズ（バイト数）については、デバイス定義中のキャッシュサイズを見て、その値よりも小さくなるように努力しますが、元の画像が大きすぎる場合や複雑な画像の場合には キャッシュサイズよりも小さくできずに表示できない場合があります。 また、本機能にはサムネイルモード、壁紙モード、EzGETモードの3つのモードが存在します。 ※デバイス定義を変更した場合は、キャッシュファイルを削除する必要があります。

HTMLファイル内での画像指定方法

imgタグ等で指定する場合には、ファイル名の拡張子（.jpgや.gif等）をはずした形で指定します。

<IMG SRC="/img/logo">

サムネイルモード

端末側画面サイズの約３分の１程度のサイズ（縦Ｘ横）に画像を縮小表示します。 指定方法は以下のとおりです。

<IMG SRC="/img/logo?Mode=Thumbnail">

パラメータとして、"Mode=Thumbnail"を指定します。

壁紙モード

端末側画面のサイズにマッチするサイズに拡大・縮小します。横長の画像の場合には、縦幅を合わせた後に左右をトリミングします。

 <IMG SRC="/img/logo?Mode=WP">

パラメータとして、"Mode=WP"を指定します。

EzGetモード

壁紙ダウンロードを行いたい場合に使用します。!EzGETモードは、壁紙モードで出力される画像サイズと同一サイズの画像が使用されます。

 <A HREF="/img/logo?Mode=EzGet">

パラメータとして"Mode=EzGet"を指定します。 aタグ等で指定しておけば、あとはmod_chxjが勝手にCRCをつけたりしてEzGETをはじめます。

その他の機能

モードの他に、画像サイズ（縦Ｘ横）を直接指定することも可能です。wパラメータ、hパラメータを使用して指定します。 また、画像変換機能用にUser-Agentを偽装することも可能です。

パラメータ名	説明
w	横幅を指定します。
h	縦幅を指定します。
ua	偽装するUser-Agentを指定します。IGNを指定した場合には、User-Agentを無視します。

 <IMG SRC="/img/logo?w=100&h=200">

Varyヘッダ(0.12.38以降)

画像変換処理は非常に重い処理であるため、外部キャッシュを利用できるよう

Vary: User-Agent

を付加しています。 ただし、動的画像変換の場合は今のところ付加していません。

注意事項

端末に画像を保存させる場合、NoCacheOnを有効にしていると、保存できなくなりますので、 NoCacheOnを有効にしないでください。 ChxjConvertRuleディレクティブの項もご参照ください。