Debian Codegraph @

docs/README.JPN

raw
1 gd ライブラリで日本語文字列を使う上での注意事項
2
3 山賀正人 ([email protected])
4
5
6 gd-1.7.0 からはそのままで gdImageStringTTF() に対して
7 SJIS encoding のフォントが使用できます。
8
9 ※ Unicode encoding のフォントに対しては日本語文字列を UTF-8 で
10 指定すれば日本語が表示できます。
11
12 つまり gdImageStringTTF() で SJIS encoding のフォントを指定すると
13 文字列は無条件に日本語であると解釈され、漢字コード (EUC, SJIS, 7bit JIS)
14 が自動判別されて適切に処理されます。
15
16 更に UNICODE encoding のフォントに対しても JIS 系の日本語 (EUC, SJIS, 7bit JIS)
17 を使用する場合は、コンパイル時に -DJISX0208 を付けてコンパイルしてください。
18 こうすると gdImageStringTTF() で指定された文字列に ASCII 以外の文字があると
19 無条件に日本語文字列であると解釈され、漢字コードを自動判別後に
20 適切に処理されます。
21
22 ただしこの場合は UTF-8 の日本語文字列を扱えなくなりますので、
23 ご利用の環境等に応じて -DJISX0208 を付けるか否かを決めてください。
24
25 漢字コードの変換に OS 付属の iconv() を使う場合は
26 CFLAGS に -DHAVE_ICONV を付けてコンパイルしてください。
27 漢字コード変換の際にエラーが発生した場合に適切なメッセージを
28 表示するようになります。
29
30
31 ☆ EUC か SJIS か判別できなかった場合の漢字コードの判別方法
32
33 (1) 環境変数 LC_ALL, LC_CTYPE, LANG をこの順番でチェックする
34 (2) 環境変数からも判別できなかった場合は UNIX ならば EUC、
35 Win32 ならば SJIS と見なす
36
37 コンパイル時に -DSJISPRE を付けてコンパイルすれば、UNIX であっても
38 SJIS を優先するようになります。