JpGraph の多くの設定は環境設定ファイル "jpg-config.inc.php"内の DEFINE文 によって変更することができます。 これらの設定の多くは一般的な設定で動作するようなデフォルト値が入力されています。
ここでは、すべての定数とそのデフォルトの値を記述しています。
| 定義、デフォルト値 | 解説 |
|---|---|
| "CACHE_DIR","/tmp/jpgraph_cache/" | キャッシュを保存するディレクトリの絶対パスです。このディレクトリは、PHPによる読み込み、書き込みが可能でなければなりません。最後に '/' の文字を付けるのは必須です。 |
| "TTF_DIR","/usr/local/fonts/ttf/" | JpGraphで使用する TTF フォントを格納するディレクトリを指定します'/' が終わりに必須です。格納するフォントはJpGraphが読み込めるような命名規則にしたがっている必要があります。 |
| "CSIMCACHE_DIR", "csimcache/" | CSIM を使用したグラフのキャッシュを保存するディレクトリです。 '/' が終わりに必須です。キャッシュを使用する設定の CSIM グラフがここにキャッシュされます。 ディレクトリはPHPが見ることができるようなファイルシステム名でなければなりません。 また、http バージョンは htdocs ディレクトリと関連するHTTPサーバーが見ることができるものを除いて同じディレクトリであるべきです。 相対パスが指定された場合、イメージ スクリプトが実行された場所からの相対パスとなります。注意: デフォルトの設定では、イメージ スクリプトが実行されたディレクトリにサブディレクトリを作り、すべてのファイルをそこに保存します。 もちろん、このディレクトリも PHP のプロセスによる書き込みが可能である必要があります。 |
| "CSIMCACHE_HTTP_DIR", "csimcache" | HTTP形式の CSIM を使用したグラフのキャッシュを保存するディレクトリです。 '/' が終わりに必須です。キャッシュを使用する設定の CSIM グラフがここにキャッシュされます。 ディレクトリはPHPが見ることができるようなファイルシステム名でなければなりません。 また、http バージョンは htdocs ディレクトリと関連するHTTPサーバーが見ることができるものを除いて同じディレクトリであるべきです。 相対パスが指定された場合、イメージ スクリプトが実行された場所からの相対パスとなります。注意: デフォルトの設定では、イメージ スクリプトが実行されたディレクトリにサブディレクトリを作り、すべてのファイルをそこに保存します。 もちろん、このディレクトリも PHP のプロセスによる書き込みが可能である必要があります。 |
| "CHINESE_TTF_FONT", "bkai00mp.ttf" | FF_CHINESE aka FF_BIG5 で使用される TTF ファイルのファイル名です。これは、フォント ファミリーが FF_CHINESE、またはFF_BIG5 のどちらかで指定される場合に使用されます。 |
| "LANGUAGE_CYRILLIC", false | キリル言語をサポートします。 |
| "CYRILLIC_FROM_WINDOWS", false | この設定を true に設定した場合、入力テキストは windows 1251 であると想定されて変換されます。false に設定した場合は koi8-r と仮定されます。 |
| 'MINCHO_TTF_FONT', 'ipam.ttf' | FF_MINCHO で使用される日本語の TrueType フォント名を設定します。 |
| 'PMINCHO_TTF_FONT', 'ipamp.ttf' | FF_PMINCHO で使用される日本語の TrueType フォント名を設定します。 |
| 'GOTHIC_TTF_FONT', 'ipag.ttf' | FF_GOTHIC で使用される日本語の TrueType フォント名を設定します。 |
| 'PGOTHIC_TTF_FONT', 'ipagp.ttf' | FF_PGOTHIC で使用される日本語の TrueType フォント名を設定します。 |
| "INSTALL_PHP_ERR_HANDLER", false | ライブラリがデフォルトのエラーハンドラにグラフィカルなエラーメッセージを生成させるかどうかを設定する。 画像が期待されるページでエラーが起きた際、赤い×印が表示される代わりにエラー メッセージを画像で表示するようになるので、開発中はとても便利な設定です。 |
| "CATCH_PHPERRMSG", true | ライブラリが global php_errmsg 文字列を調査し、いくつかのエラーをグラフィカルに表示するようにします。 たとえば、ヘッダー ファイルが見つからないためグラフが作成されず、赤い×印だけが表示されてしまうような場合にこれはとても便利です。 稼動中のサイトではこれは false に設定しておくべきです。 |
| "USE_LIBRARY_GD2",false | GD 2.x を使用するか GD 1.x を使用するかを指定します。もしGD 2.xをインストールしているのなら、曲線の描画が綺麗になるので true に設定しておくことをお勧めします。もし GD2 をインストールしていないのならば、false に設定しておかなければなりません。 |
| 'USE_TRUECOLOR',true | truecolor を使用するかどうかを設定します。注意 1.GD 2.0.2 以上の場合のみ使用することができます。注意 2.Win32 の GD 2.0.1 + PHP 4.0.6 の環境で truecolor を使用しようとするとクラッシュします。まだ GD 2.x が安定しているとは(特にWin32では)考えられないので、Truecolorサポートは、アルファ版だと考えてください。注意 3.背景画像の使用は GD2 を有効にしなければなりません。注意４:もし有効にしていたら、 truetypeフォントはとても見た目が悪くなるでしょう。⇒それらのバグが GD 2.01 で修正されるまで、同じ画像による背景画像と truetypeフォントを同時に表示させることはできません。 |
| "USE_CACHE",false | キャッシュファイルを使用するかどうかを設定します。これを false に設定すると、キャッシュディレクトリにファイルが作成されないようになります。READ_CACHE を false に設定しても、キャッシュファイルは作成されています。USE_CACHE=false を設定することで、キャッシュファイルは生成されないようになります。 |
| "READ_CACHE",true | 画像の生成前にキャッシュファイルを探すかどうかを設定します。これを false に設定すると、画像を再生成した際にキャッシュの読み込みをせずに画像を作成するようになります。キャッシュの読み込みをしないように設定していても、画像が生成されるたびにキャッシュファイルは更新されることに注意してください。"USE_CACHE" も設定するようにしてください。 |
| "DEFAULT_GFORMAT","auto" | これを "auto" に設定すると、画像の形式は png gif jpg の中から最適なものが選択されます。（サポートされる形式は、あなたのPHPの設定に依存します。） |
| "USE_IMAGE_ERROR_HANDLER",true | エラーハンドラが画像ベースかテキストベースかを設定します。画像ベースの場合、スクリプトは常に画像形式でエラーを返すのでとても作業がしやすくなります。 |
| "USE_APPROX_COLORS",true | もしカラーパレットがいっぱいだったら、似ている色は近似値を使用してまとめるようにします。もし画像背景やグラデーションを使う予定なら、これを使用するのは良い考えかもしれません。もしそうでなければ、カラーパレットが使い尽くされたとエラーが出るでしょう。近似値を使用する際の欠点は、指定した通りの色が表示されないかもしれないということです。注意１:色数の制限が無いので、これは、true color イメージではなくパレットイメージを適用させるだけです。 |
| "ERR_DEPRECATED",false | 反対する関数の使用とパラメーターは、致命的なエラーを与えるべきでしょうか？(コードが今後の証拠であるかどうかチェックするために、役に立ちます。) |
| "BRAND_TIMING",false | 各画像を作るのにかかる時間を、それぞれ作成された画像の左下に表示させます。これはグラフを作る際の性能の測定に役に立ちます。 |
| "BRAND_TIME_FORMAT","Generated in: %01.3fs" | "BRAND_TIMING" で表示される、画像の作成時間の表示フォーマットを設定します。 |
以下の定義は、多くの場合変更する必要はありません。
| 定義、デフォルト値 | 解説 |
|---|---|
| "CACHE_FILE_GROUP","wwwadmin" | キャッシュされたファイルがどのグループに属するかを設定します。( "" に設定すると、デフォルトグループの "PHP-user" が与えられます) Apacheユーザーは指定されたグループのメンバーでなくてはなりません。そうでなければ指定されたグループをApacheが設定することが不可能になります。 |
| "CACHE_FILE_MOD",0664 | キャッシュされたファイルのパーミッションを設定します。( "" を設定すると、"PHP-user" のデフォルトのパーミッションが与えられます。) |
| "USE_BRESENHAM",false | Bresenham円のアルゴリズムを使用するか、組み込まれている Arc() 関数を使用するかを決定します。Bresenham はより綺麗な円を描くことができますが、CPUに高い負荷をかけ、GDのArc() 関数よりも処理が遅くなります。速度を重視するために、デフォルトでは false に設定されています。 |
| "_CSIM_SPECIALFILE","_csim_special_" | GetHTMLCSIM() 関数に内部的に使用される Graph::Stroke() の呼び出しにおいて、イメージマップを計算だけを行うということを示す特別なファイル名です。 |
| "_CSIM_DISPLAY","_jpg_csimd" | イメージマップを使用する際、完全なCSIM HTMLページではなく、ただ画像の生成だけを行わせるということをスクリプトに知らせるための HTTP GET 引数です。 |