詳細設定
ScfにはFilter及びServletの動作を制御する初期パラメータが存在します。これらは web.xmlのinit-paramに指定します。
SCFilter初期パラメータ
| パラメータ名 | 説明 | デフォルト |
| pua | PUA(外字)に対して処理を行うかを true/false で指定します。 | false |
| sp | imgタグ変換時に使用されるServletのURLを指定します。この値とSupCharServletのurl-patternは一致している必要があります。 | |
SupCharServlet初期パラメータ
| パラメータ名 | 説明 | デフォルト |
| antiAlias | 画像作成時、アンチエイリアスを有効にするかをtrue/false指定します。 | true |
| dither | 画像作成時、ディザリングを有効にするかをtrue/false指定します。 | true |
| allowPUA | 指定されたコードがPUA(外字)の場合にリクエストを受け入れるかを true/false で指定します。 | true |
| fontPath | 補助文字フォント(TrueType)のパスを指定します。 | |
| puaFontPath | 外字フォント(TrueType)のパスを指定します。省略されるとfontPathが使用されます。 | |
| fg | 文字色を #xxxxxx の形式で指定します。 | #000000 |
| bg | 背景色を #xxxxxx の形式で指定します。 | #ffffff |
| size | フォントサイズ(ポイントサイズ)を指定します。 | 12 |
| style | フォントのスタイル指定します。PLAIN,BOLD,ITALICが指定可能で、BOLD|ITALICのように '|'で組み合わせることができます。 | PLAIN |
| minSize | 指定可能なフォントサイズの最小値を指定します。 | 8 |
| maxSize | 指定可能なフォントサイズの最大値を指定します。 | 64 |
| padding | 画像のパディングを top,right,bottom,left で指定します。 | 2,2,2,2 |
| cacheSize | 作成した画像をキャッシュする最大文字数を指定します。キャッシュはメモリ上に作成されますので、大きな値を指定しないように注意してください。 | 32 |
動的な設定変更
一部の設定値はページ単位で動的に変更可能です。HttpServletRequestのsetAttributeを使用して制御します。以下は例です。
1 2 3 4 5 6 7 8 9 10 11
|
request.setAttribute(SCFilter.ATTR_FG, "#ffff00");
request.setAttribute(SCFilter.ATTR_BG, "#e0e0e0");
request.setAttribute(SCFilter.ATTR_SIZE, "24");
request.setAttribute(SCFilter.ATTR_STYLE, "BOLD");
request.setAttribute(SCFilter.ATTR_NOP, "true");
|