概要
Text TOPは、テキストの文字列を画像で表示します。複数のフォント、サイズ、色、境界線、文字の区切り、行の区切りが可能です。テキストは、ビットマップ、アンチエイリアス線、または塗りつぶされたポリゴン文字として表示することができます。Windowsに読み込まれているTrueTypeフォントは、Text TOPでレンダリングすることができます。Unicodeにも対応しています。
数値が埋め込まれた単純なテキスト文字列を表示できます。 また、テキストと数値の行を10進形式または浮動小数点形式でフォーマットし、特別なフォーマット文字を使用して、CHOPから数値を読み取ることもできます。
また、Specification DATパラメーターを介してTable DATからテキスト文字列をレンダリングすることもできます。列見出しは、テーブルのリーチ行のテキスト行をレンダリングするときに上書きされるパラメーター名です。
Windows に読み込まれた TrueType または OpenType フォントはすべて、Text TOPでレンダリングできます。新しいフォントを Windows システムにインポートするには、コントロールパネルの Fonts フォルダを開いてから、(.ttf/.otf ファイル形式)のフォントファイルをドラッグ&ドロップします。フォントは、Font Fileパラメータで .ttf/.otf ファイルパスとして設定することもできます。
テキストを python の文字列として読み込むことで Unicode テキストをレンダリングすることができます。Unicode を参照してください。
関連項:Field COMP、Text SOP、Unicode。
パラメータ – Text ページ
Field Component / field
テキストのソースとして使用するフィールドコンポーネントを指定します。フィールドコンポーネントに表示されるテキストのフォントやスタイルは、Text TOPのパラメータで設定します。
DAT / dat
テキストのソースに使用する DAT を設定します。DAT をこのフィールドにドラッグ&ドロップするか、DAT のパスを手動で入力します。
DAT Row / rowindex
DATがテーブルの場合、セルの行番号を設定します。(0から始まる)
DAT Col / colindex
DATがテーブルの場合、セルの列番号を設定します。
Specification DAT / specdat
Table DATで、テキストをピクセルごとに指定および配置することができます。左下隅は0、0です。ヘッダー列には、position1またはx、position2またはy、およびテキストを含める必要があります。 サンプルテーブルは次のとおりです。
x y text
0 0 lower left text
100 100 somewhere in the middle
Text / text
テキストの文字列を設定します。 オプションで、以下の Value と Post Text で設定されるように、数値と別の投稿文字列を続けることができます。 改行またはタブが必要な場合は、このパラメーターを式モードに変更し、改行とタブを示す\ nまたは\ tを含むPython文字列を指定することをお勧めします。 例:「最初の行\ n2番目の行」。
Legacy Parsing / legacyparsing
古いビルドでは、構文\ XXX(たとえば、\ 200は文字200になります)、\ t、\ n、および[]と{}(文字列を配置するため)が文字列で解析されていました。 これは現在非推奨です。 文字コードを指定するには、代わりに\ tおよび\ n Python構文を使用する必要があります。[]、{}の代わりに Specification DAT を使用して文字列を配置する必要があります。 ただし、このパラメーターを有効にして、レガシー解析をオンに戻すことができます。 これが有効で、文字\ [] {}を表示する場合は、それらの文字列の前に\を付ける必要があります。
Append Value / appendvalue
以下に定義されているValueフィールドを有効にします。この値は、Text文字列とPost Text文字列の間に挿入されます。
Value / valuetouse
表示する数値を設定します。
Total Digits / totaldigits
表示される値の合計桁数を設定します。
Decimal Digits / decimaldigits
小数点以下の桁数を設定します。
Post Text / posttext
TextとValue(存在する場合)の後に追加されるテキスト文字列を設定します。
CHOP Value %-Replace / chopvaluereplace
Cスタイルのprintf()/ sprintf()と同様の構文を使用して、文字列の一部をCHOP値に置き換えることができます。 構文の詳細は、次の CHOP パラメータに記載されています。
CHOP / chop
Text 文字列に挿入する値を含むCHOPを設定します。 Text TOPは、すべてのCHOPチャネルが表示されるまで、Text 文字列を繰り返します。 これらは、Text 文字列で特別な構文を使用して表示されます。これは、%で始まる文字列で定義されます(例:%4d)。
> `%\[flags\][width]\[.precision\][type]`
- flags (オプション) – 配置オプション
- – : 左揃え(デフォルトではテキストは右揃え)
- 0 : 左側にゼロを埋め込みます
- width (オプション) – 表示される数字の合計桁数。
- precision (オプション) – 小数点以下の桁数。
- type – 数値形式
- d : 整数
- f : 浮動小数
- g : ダブル。 指数形式は値の指数が ?4 未満の場合にのみ使用されます。
CHOPをこのフィールドにドラッグ&ドロップするか、CHOPのパスを手動で入力します。
Comp Over Input / compoverinput
Text TOPに入力がある場合は、入力画像の上にオーバーでテキストを合成します。
Word Wrap / wordwrap
チェックが入っている場合、テキストは自動的に改行され、TOPの境界からはみ出さないようになります。Word WrapとAuto-Sizeを併用すると、最初に指定されたフォントサイズに基づいてテキストがワードラップされ、その後にテキストブロックがオートサイズされます。
パラメータ – Font ページ
Font / font
ドロップダウンメニューからテキストのフォントを選択します。すべてのフォントは Windows によって提供されており、Windows に読み込まれている TrueType フォントを使用することができます。
Font File / fontfile
テキストに使用する任意の TrueType フォントファイル (.ttf ファイル) を指定します。Font Fileを使用する場合、上記の Font メニューは無効になっています。
Character Set / charset
使用する文字セットを設定します。
- Unicode / unicode
- Symbol / symbol
Display Method / dispmethod
使用する表示方法を設定します。
- Automatic / automatic
フォントサイズや設定に応じて、使用する表示モードを自動的に選択します。
- Polygon / polygon
ポリゴンを使用してテキストを表示します。ポリゴンは大きなフォントサイズを使用した方が見栄えが良くなります。また、アンチエイリアスもサポートしています (下記のアンチエイリアス参照)。
- Stroke / stroke
Polygonと同じですが、テキストのアウトラインのみが表示されます。
- Bitmap / bitmap
テキストにビットマップ画像を使用します。 ビットマップフォントは、高精度が要求される非常に小さいフォントサイズに適しています。
- Texture / texture
ポリゴンを使用して、各フォントサイズに適したテクスチャにレンダリングします。その結果、滑らかなアンチエイリアス処理されたテキストが得られます。
Anti-Alias / antialias
テキストのエッジを滑らかにします。Texture Display Modeでは使用できません。
- 1x (Off) / aa1
- 2x / aa2
- 4x / aa4
- 8x (Medium) / aa8mid
- 8x (High) / aa8high\
- 16x (Low) / aa16low
- 16x (Medium) / aa16mid
- 16x (High) / aa16high
- 32x / aa32
Stroke Width / strokewidth
Stroke Display Methodを使用する場合のアウトラインの幅を制御します。
Bold / bold
テキストを太字で表示します。
Italic / italic
テキストをイタリック体で表示します。
Auto-Size Font / fontautosize
以下の3つのオプションのいずれかを使用して、フォントサイズを自動的に設定します。この機能をWord Wrapと一緒に使用する場合、最初に指定されたフォントサイズに基づいてテキストがワードラップされ、その後にテキストブロックがオートサイズされます。
- No Auto-Fit / nofit
自動フィッティングを使用しません。 フォントサイズXおよびフォントサイズYパラメーターで指定されたフォントサイズを設定します。
- Auto-Fit Always / alwaysfit
フォントサイズは、テキストがText TOP全体に端から端まで収まるように拡大または縮小されます。
- Auto-Fit if Too Large / fitiffat
テキストが大きすぎて、テキストTOPの縁からはみ出してしまう場合にのみ、テキストのサイズを自動で調整します。この場合、文字サイズはTOPの枠内に収まるように小さくなります。
Font Size X / fontsizex
フォントサイズをX(水平)で設定します。
注意:
Polygon、Outline Display Methodsを使用する場合は、浮動小数点のフォントサイズを使用することができます。
Font Size X Unit / fontsizexunit
Font Size Xパラメータの単位を、ピクセル、分数、分数アスペクト、ポイント(フォントのポイントサイズ)から選択します。
Font Size Y / fontsizey
フォントサイズをY(垂直)で設定します。
注意:
Polygon、Outline Display Methodsを使用する場合は、浮動小数点のフォントサイズを使用することができます。
Font Size Y Unit / fontsizeyunit
Font Size Yパラメータの単位を、ピクセル、分数、分数アスペクト、ポイント(フォントのポイントサイズ)から選択します。
Keep Font Ratio / keepfontratio
フォントサイズのY値を無視します。XとYの両方のサイズをont Size Xで設定します。
Language / language
グリフを正しくフォーマットするのに役立つ言語タイプのヒント。これは、Text TOP / SOP Unicode LanguageAbbreviationsテーブルの略語である必要があります。
Reading Direction / readingdirection
言語を左から右に読むか、右から左に読むかを設定します。
- Left To Right / lefttoright
- Right To Left / righttoleft
Kerning / kerning
カーニングは文字間に任意のオフセットを追加する方法です。各フォントにはすでにデフォルトのオフセットが設定されているので、文字は互いに同一平面上に配置されています。この Kerning パラメータはそれに追加して Y オフセットを可能にします。
Position / position
テキストの開始位置をXとYで指定します。
ヒント: TextとPost Textフィールドは、括弧を使用して位置を上書きすることができます。
- [x,y]
“bleh[x,y]newtext”で、画面上の位置 (x,y) newtextを配置します。
- {X,Y}
“bleh{(+/-)x,(+/-)y}newtext” で、newtext の x,y を現在の位置からオフセットします。
- \n
“\n”を使うと、テキストが次の行に移動して位置がリセットされます。(改行とキャリッジリターン)
- position1
- position2
Position Unit / positionunit
Positionパラメータの単位を Pixels、Fraction(0-1)、Fraction Aspect(アスペクト比を考慮した0-1)から設定します。
Line Spacing / linespacing
テキストの行間のスペース量を設定します。
Line Spacing Unit / linespacingunit
Line Spacingパラメータの単位を Pixels、Fraction(0-1)、Fraction Aspect(アスペクト比を考慮した0-1)から設定します。
Horizontal Align / alignx
水平方向の配置を設定します。
- Left / left
テキストを左揃えにします。
- Center / center
テキストをセンター揃えにします。
- Right / right
テキストを右揃えにします。
Vertical Align / aligny
垂直方向の配置を設定します。
- Bottom / bottom
テキストを下揃えにします。
- Center / center
テキストをセンター揃えにします。
Border Space / borderspace
オートサイズフォントを使用している場合は、テキストをさらに縮小して枠線をつけます。
– borderspace1
– borderspace2
パラメータ – Color ページ
Multiply RGB by Alpha / multrgbbyalpha
RGBチャンネルにアルファチャンネルを乗算します。
Font Color / fontcolor
表示されるテキストのRGBA値を設定します。(デフォルト: 白 (1,1,1,1,1)
- Red / fontcolorr
- Green / fontcolorg
- Blue / fontcolorb
Font Alpha / fontalpha
フォントのアルファ値を設定します。
Background Color / bgcolor
背景のRGBA値を設定します。(デフォルト: 黒 (0,0,0,0,0)
- Red / bgcolorr
- Green / bgcolorg
- Blue / bgcolorb
Background Alpha / bgalpha
背景のアルファ値を設定します。
Border A / bordera
枠線AのRGBA値を設定します。
- Red / borderar
- Green / borderag
- Blue / borderab
Border A Alpha / borderaalpha
枠線Aのアルファ値を設定します。
Border B / borderb
枠線BのRGBA値を設定します。
- Red / borderbr
- Green / borderbg
- Blue / borderbb
Border B Alpha / borderbalpha
枠線Bのアルファ値を設定します。
Left Border / leftborder
左端の2つの枠線の色を設定します。オプションは off (枠線なし)、Border A (Border A で定義された色を使用)、Border B (Border B で定義された色を使用) です。
Left Border Inside / leftborderi
Left Borderパラメータと同じですが、内側の枠線の色を設定します。
Right Border / rightborder
右端の2つの枠線の色を設定します。オプションは off (枠線なし)、Border A (Border A で定義された色を使用)、Border B (Border B で定義された色を使用) です。
Right Border Inside / rightborderi
Right Borderパラメータと同じですが、内側の枠線の色を設定します。
Bottom Border / bottomborder
下端の2つの枠線の色を設定します。オプションは off (枠線なし)、Border A (Border A で定義された色を使用)、Border B (Border B で定義された色を使用) です。
Bottom Border Inside / bottomborderi
Bottom Borderパラメータと同じですが、内側の枠線の色を設定します。
Top Border / topborder
上端の2つの枠線の色を設定します。オプションは off (枠線なし)、Border A (Border A で定義された色を使用)、Border B (Border B で定義された色を使用) です。
Top Border Inside / topborderi
Top Borderパラメータと同じですが、内側の枠線の色を設定します。
パラメータ – Common ページ
参照:共通 Common ページ