詳細設定

ScfにはFilter及びServletの動作を制御する初期パラメータが存在します。これらは web.xmlのinit-paramに指定します。

SCFilter初期パラメータ

パラメータ名説明デフォルト
puaPUA(外字)に対して処理を行うかを true/false で指定します。false
spimgタグ変換時に使用される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");
JSPWiki