Yotsuba Games

Text Rasterize

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

intermediate
Since P00

Input Ports

Layout

接続時は作成済みの glyph レイアウトを優先して画像化する

`TextLayout`
Text

未接続時は `text` パラメータを使う

`Text`
Color

未接続時は `color` パラメータを使う

`Color`
Outline Color

未接続時は `outline_color` パラメータを使う

`Color`

Output Ports

Image

ラスタライズされた文字画像

`Image`

Parameters

NameTypeDefaultDescription
Text`Text``PixPipeline``text` 入力未接続時の文字列
Source Mode`Enum``SystemFamily`システムフォント参照か、フォントファイル参照か
Family Name`Text``Segoe UI`システムフォント名。FontFile 時は任意 override としても使える
Font File`FilePath`空`FontFile` モード時のローカル TTF / OTF / TTC
Fallback Family`Text``Arial`指定フォントが解決できない時に使う fallback
Pixel Size`Int``24`ピクセル単位のフォントサイズ
Tracking`Int``0`文字間に追加するピクセル間隔
Line Height`Float``1.0`フォントメトリクスに対する行送り倍率
Padding`Int``2`文字画像の外側に足す透明余白
Fill Enabled`Bool``true`文字本体の塗りを描画するか
Align`Enum``Left`自動計算した文字領域内の横方向揃え
Antialias`Enum``Gray``Pixel` / `Gray`
Outline Enabled`Bool``false`文字の外側にアウトラインを描画するか
Outline Width`Int``1`ピクセル単位のアウトライン幅
Outline Color`Color`黒`outline_color` 入力未接続時の線色
Crisp Edges`Bool``true`硬いドット輪郭と角張ったアウトライン拡張を優先する
Pixel Perfect Cleanup`Bool``false`生成後のアウトラインから L 字の余分な角ピクセルを除去する
Cleanup Side`Enum``Outer``pp_cleanup = true` の時だけ表示。`Inner` / `Outer` を選ぶ
Threshold`Float``0.15`ラスタライズ後のアルファしきい値
Color`Color`白`color` 入力未接続時の文字色

優先ルール

  • layout 入力が接続されている時は、その TextLayout を優先してimage化します
  • この場合、次のレイアウト系パラメータは参照しません

- 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 入力時にそのまま有効です

Technical Details

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

Usage Examples

[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)

💡 Tips

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

Related Nodes

text-input
preview
color-rgb
text-layout
text-animate-by-glyph
Back to Node List
Text Rasterize — PixPipeline Node Reference