doc.3 の履歴(No.2)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• doc.3 へ行く。
  • 1 (2023-04-12 (水) 00:11:06)
  • 2 (2023-04-12 (水) 00:22:56)
  • 3 (2023-04-12 (水) 08:37:00)
  • 4 (2023-04-12 (水) 08:37:00)
  • 5 (2023-05-23 (火) 23:54:07)
  • 6 (2023-05-24 (水) 15:14:07)
  • 7 (2023-05-25 (木) 13:23:38)
  • 8 (2023-05-29 (月) 23:45:33)

---

Doc.3 画像加工ツールgritの使い方†

grit†

gritとは、BMP,PNGなどの画像ファイルをGBA用のフォーマットに変換してくれるツールのことです。
実行ファイルは「C:\devkitPro\tools\bin」内にあります。

使用方法†

使い方はとても簡単です。
コンソール上でコマンドを入力して、いくつかの変換オプションを指定してあげます。
makefileに設定することや、バッチ処理として組むことも可能です。以下に簡単な例を表します。

• モード0に使用する画像の変換例
  

  grit.exe image.bmp -gt -gB4 -fts -gu16

  オプション	カテゴリー	指定内容
  -gt	フォーマット	タイル
  -gB4	色	16色
  -fts	出力タイプ	GNU asm
  -gu16	配列のサイズ	16bit

• モード3に使用する画像の変換例
  

  grit.exe image.bmp -gb -gB16 -fts -gu16

  オプション	カテゴリー	指定内容
  -gb	フォーマット	ビットマップ
  -gB16	色	15bitColor
  -fts	出力タイプ	GNU asm
  -gu16	配列のサイズ	16bit

出力例†

上記の例（モード3）での出力結果は次のとおりです。

• image.h

//======================================================================
//
//	image, 240x160@16, 
//	+ bitmap not compressed
//	Total size: 76800 = 76800
//
//	Time-stamp: 2007-09-07, 16:28:51
//	Exported by Cearn's GBA Image Transmogrifier
//	( http://www.coranac.com )
//
//======================================================================

#ifndef __IMAGE__
#define __IMAGE__

#define imageBitmapLen 76800
extern const unsigned short imageBitmap[38400];

#endif // __IMAGE__

• image.s

@=======================================================================
@
@	image, 240x160@16, 
@	+ bitmap not compressed
@	Total size: 76800 = 76800
@
@	Time-stamp: 2007-09-07, 16:28:51
@	Exported by Cearn's GBA Image Transmogrifier
@	( http://www.coranac.com )
@
@=======================================================================

	.section .rodata
	.align	2
	.global imageBitmap		@ 76800 unsigned chars
imageBitmap:
	.hword 0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F
	.hword 0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F,0x4A5F 

	...(以下略)

注意点として画像ファイルの名前がそのまま変数名に使われます。
image.bmpを変換するとimageBitmapLen、imageBitmapとなります。

奇数サイズの場合、gritがアライメントを考慮してサイズ変更します。
作る前から余計な苦労をしない為にも画像データは偶数サイズで統一してください。

grit-readme.txt†

コマンドオプションは一読する価値があります。暇なときにでも読んでおくことをオススメします。
https://www.coranac.com/files/grit-readme.txt

demo project†

公式サイトには使い方を説明したソースコードがあるのでダウンロードしてみることをおすすめします。
コンパイルが面倒という方はこちらをどうぞ。

履歴†

• 2023/04/11
• 2014/10/28
• 2007/09/07