Yotsuba Games
Back to Node List

Text Rasterize

text_rasterize

Final text render node. Rasterizes text or a prebuilt text layout into an image, with optional outline rendering

Draft
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
レイアウト
layout
TextLayout
任意のテキストレイアウト入力。接続時はテキストやフォント配置パラメータより優先されます。
テキスト
text
Text
任意のテキスト入力。未接続時はテキストパラメータを使います。
色
color
Color
任意の文字色入力。未接続時は色パラメータを使います。
線色
outline_color
Color
任意の線色入力。未接続時は線色パラメータを使います。

Output Ports

NameTypeDescription
画像
output
Image
画像化されたテキスト

Parameters

NameTypeDefaultRangeDescription / Options
テキスト
text
Text
PixPipeline—

Text 入力が未接続の時に使う文字列

フォント参照
source_mode
Enum
SystemFamily—

文字画像化に使うフォントの参照方法

  • システムフォントSystemFamily
    この PC で使えるシステムフォントを使います
  • フォントファイルFontFile
    ローカルの TTF/OTF/TTC を一時読み込みしてすぐ画像化します
ファミリ名
family_name
Text
Segoe UI—

システムフォント名。フォントファイル使用時は任意のファミリ名上書きとしても使えます。

フォントファイル
font_path
FilePath
——

ローカルの TTF / OTF / TTC ファイルパス

フォールバック
fallback_family
Text
Arial—

指定フォントを正確に解決できない時に使うフォールバックファミリ

文字サイズ
pixel_size
Int
244–256

ピクセル単位のフォントサイズ

字間
tracking
Int
0-16–64

文字ごとに追加する字間

行送り
line_height
Float
10.5–3 / step 0.05

フォントメトリクスに対する行送り倍率

余白
padding
Int
20–64

文字のまわりに追加する透明余白

塗りを表示
fill_enabled
Bool
true—

文字本体の塗りを描画するか

揃え
align
Enum
Left—

自動計算された文字領域内での横方向揃え

  • 左寄せLeft
  • 中央寄せCenter
  • 右寄せRight
アンチエイリアス
antialias
Enum
Gray—

文字のスムージング方法

  • ピクセルPixel
    アンチエイリアスを切って硬い輪郭で描画します
  • グレイGray
    グレースケールのアンチエイリアスをかけてからしきい値処理します
アウトラインを表示
outline_enabled
Bool
false—

文字の外側にアウトラインを描画するか

線幅
outline_width
Int
10–16

ピクセル単位のアウトライン幅

線色
outline_color
Color
[0,0,0,1]—

線色入力が未接続の時に使うアウトライン色

硬い輪郭
crisp_edges
Bool
true—

より硬いドット輪郭と角張ったアウトライン拡張を優先します

ピクセルパーフェクト補正
pp_cleanup
Bool
false—

生成後のアウトラインから L 字の余分な角ピクセルを除去します

補正する側
pp_cleanup_side
Enum
Outer—

文字アウトラインのどちら側にピクセルパーフェクト補正をかけるか

  • 内側Inner
    内側エッジの L 字を除去
  • 外側Outer
    外側エッジの L 字を除去
しきい値
threshold
Float
0.150–1 / step 0.01

文字のラスタライズ後に適用するアルファしきい値

色
color
Color
[1,1,1,1]—

Color 入力が未接続の時に使う文字色

優先ルール

  • layout 入力が接続されている時は、その TextLayout を優先して画像化します
  • この場合、次のレイアウト系パラメータは参照しません
    • text
    • source_mode
    • family_name
    • font_path
    • fallback_family
    • pixel_size
    • tracking
    • line_height
    • align
  • padding / fill_enabled / antialias / threshold / color は、layout 入力時でも引き続き有効です
  • outline_enabled 以降のアウトライン系パラメータも、layout 入力時にそのまま有効です

技術詳細

  • フォントバイナリ自体は project / template / export に埋め込まない
  • 参照したローカルフォントをその場で Image に変換して返す
  • SystemFamily では PC 上のフォント一覧から選択可能
  • FontFile ではローカル TTF / OTF / TTC を一時読み込みして画像化する
  • 指定フォントを正確に解決できない場合は fallback_family を試す
  • TextLayout の reveal / animate 後の最終 glyph 配置に対して、塗りとアウトラインを一緒に描く
  • TextOutline は同じ render engine を使う互換ラッパーで、最終 bake の正本はこの Text Rasterize を想定する

使用例

[Text Input] -> [Text Rasterize] -> [Preview]

[Color RGB] -> [Text Rasterize]

[Text Input] -> [Text Layout] -> [Text Rasterize] -> [Preview]

[Text Input] -> [Text Layout] -> [Text Animate By Glyph] -> [Text Rasterize] -> [Preview]

[Text Input] -> [Text Layout] -> [Text Rasterize]
[Color RGB] ------------------------------^
[Color RGB] ------------------------------(outline_color)
Back to Node List
Text Rasterize — PixPipeline Node Reference