# ppmconv*

## 説明

`ppmconv/ppmconv8/ppmconvbg` ツールは、フルカラーの ppm フォーマット画像を C ソース形式などに変更するためツールです。

## 使用方法

### 起動コマンド

#### ppmconv

`% ppmconv PPM_FILE`

`PPM_FILE` で指定されたフルカラーの `ppm` 形式の画像ファイルにを読み込み、16bit カラーのビットマップに変換し、プログラムで直接用いることのできる C 言語のソースファイルを標準出力に出力します。

#### ppmconv8

`% ppmconv8 PPM_FILE LABEL_NAME`

`PPM_FILE` で指定されたフルカラーの `ppm` 形式の画像ファイルにを読み込み、8 bit INDEX カラーのビットマップに変換し、プログラムで直接用いることのできる C 言語のソースファイルを標準出力に出力します。読み込ませる `ppm` 形式の画像ファイルはあらかじめ他のツールなどで 256 色以下に減色されている必要があります。パレットとピクセルデータ列の配列名称は `LABEL_NAME` を用いて生成されます。

#### ppmconvbg

`% ppmconvbg [-a LABEL_NAME] [-b] [-c 4|-c 8] [-p] [-i] PPM_FILE OUTPUT_FILE`

`PPM_FILE` で指定されたフルカラーの `ppm` 形式の画像ファイルにを読み込み、以下のオプションで指定された条件に応じて `OUTPUT_FILE` へデータを出力します。

> `-a LABEL_NAME`
>   C ソース形式で出力
>   コンパイル可能な形式で出力されます。パレットとピクセルデータ列の配列名称は `LABEL_NAME` を用いて生成されます。
> `-b`
>   バイナリ形式で出力
>   出力データに対し、さらに圧縮などの処理を行ないたいときに便利です。出力データはデフォルトでバイナリ形式になっています。
> `-c 4 または -c 8`
>   カラーパレットの bit 数
>   16 色のときは `-c 4` を 256 色のときは `-c 8` を指定します。デフォルトは 256 色です。
>   入力される ppm 形式のファイルはここで指定した色数以下に減色されている必要があります。
> `-p`
>   パレットデータのみを出力します。
> `-i`
>   ピクセルデータ(カラーインデックス値)のみを出力します。

## 場所

`$TwlSDK/tools/bin/ppmconv.exe`
`$TwlSDK/tools/bin/ppmconv8.exe
$TwlSDK/tools/bin/ppmconvbg.exe`

## 参照

`gx/UnitTours/2D_BmpBg_MainRam`
`gx/UnitTours/2D_CharBg_256BMP`

## 履歴

2004/08/26 初版