gd ライブラリで日本語文字列を使う上での注意事項

					山賀正人 (ma@yama-ga.com)


gd-1.7.0 からはそのままで gdImageStringTTF() に対して
SJIS encoding のフォントが使用できます。

	※ Unicode encoding のフォントに対しては日本語文字列を UTF-8 で
	   指定すれば日本語が表示できます。

つまり gdImageStringTTF() で SJIS encoding のフォントを指定すると
文字列は無条件に日本語であると解釈され、漢字コード (EUC, SJIS, 7bit JIS)
が自動判別されて適切に処理されます。

更に UNICODE encoding のフォントに対しても JIS 系の日本語 (EUC, SJIS, 7bit JIS)
を使用する場合は、コンパイル時に -DJISX0208 を付けてコンパイルしてください。
こうすると gdImageStringTTF() で指定された文字列に ASCII 以外の文字があると
無条件に日本語文字列であると解釈され、漢字コードを自動判別後に
適切に処理されます。

ただしこの場合は UTF-8 の日本語文字列を扱えなくなりますので、
ご利用の環境等に応じて -DJISX0208 を付けるか否かを決めてください。

漢字コードの変換に OS 付属の iconv() を使う場合は
CFLAGS に -DHAVE_ICONV を付けてコンパイルしてください。
この場合に -DHAVE_STDARG_H と -DHAVE_ERRNO_H も付けておくと
漢字コード変換の際にエラーが発生した場合に適切なメッセージを
表示するようになります。


☆ EUC か SJIS か判別できなかった場合の漢字コードの判別方法

	(1) 環境変数 LC_ALL, LC_CTYPE, LANG をこの順番でチェックする
	(2) 環境変数からも判別できなかった場合は UNIX ならば EUC、
	    Win32 ならば SJIS と見なす

コンパイル時に -DSJISPRE を付けてコンパイルすれば、UNIX であっても
SJIS を優先するようになります。