externalResourcesRequired

Scalable Vector Graphics等,不定期

text

2006-10-12 | 仕様
text要素は、文字列を描く際に使われます。

text要素によって、text要素内の文字列に対応したグリフが1本のまっすぐな線にそって描かれます。
途中で改行は行われません。
パラメータとして、文字列の位置と回転角を指定します。
文字列は、方向やフォント等の指定にしたがって描かれます。

文字列の位置のx座標を指定する属性がx、y座標を指定する属性がyです。
回転角を指定する属性がrotateです。

例えば、
<text x="100" y="100">テキスト</text>
のように書けば、(100,100)に"テ"に対応したグリフが描かれます。"キ"以降は、直前のグリフの位置にadvance値を加えた位置に描かれます。
指定した座標がグリフに対してどの位置になるかは、フォント等によります。横書き(左から右)の日本語の場合は、通常左下になります。

x属性、y属性の値がカンマ(",")あるいは、半角スペースで区切られた複数の数字の場合は、順に1文字目のx座標(y座標)、2文字目のx座標(y座標)・・・となります。

例えば、
<text x="100,120" y="100,110">テキスト</text>
のように書けば、(100,100)に"テ"に対応したグリフが、(120,110)に"キ"に対応したグリフが描かれます。"ス"以降は、直前のグリフの位置にadvance値を加えた位置に描かれます。

rotate属性の値は、カンマ(",")あるいは、半角スペースで区切られた複数の数字で、順に1文字目の回転角、2文字目の回転角・・・となります。

例えば、
<text x="100" y="100" rotate="10,20">テキスト</text>
のように書けば、"テ"に対応したグリフは10度、"キ"、"ス"および"ト"に対応したグリフは20度回転して描かれます。位置には影響を与えません。

x属性およびy属性は指定されない場合は0として扱われます。すなわち、文字列の位置のx座標(あるいはy座標)が0ということです。
rotate属性で指定された値の数が文字の数よりも少ない場合は、多い分の文字についてはrotate属性で指定された最後の値が適用されます。rotate属性で指定された値の数が文字の数よりも多い場合は、多い分の回転角の値については無視されます。複数の文字が1つのグリフに割り当てられる場合には、最初の文字に対応する回転角が適用され2文字目以降に対応する回転角の値は無視されます。