Text TOP

概要

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 オフセットを可能にします。

  • kerning1
  • kerning2
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
    テキストをセンター揃えにします。
  • Top / top
    テキストを上揃えにします。
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 ページ