よつばゲームズ

Text Rasterize(テキスト画像化)

テキストまたは `TextLayout` を、塗りとアウトラインを含めて最終画像へ焼き付ける正本 render ノード

中級
Since P00

入力ポート

Layout(レイアウト)

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

`TextLayout`
Text(テキスト)

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

`Text`
Color(色)

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

`Color`
Outline Color(線色)

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

`Color`

出力ポート

Image(画像)

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

`Image`

パラメータ

名前型デフォルト説明
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 を優先して画像化します
  • この場合、次のレイアウト系パラメータは参照しません

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

💡 ヒント

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

関連ノード

text-input
preview
color-rgb
text-layout
text-animate-by-glyph
ノード一覧に戻る
Text Rasterize (テキスト画像化) — PixPipeline ノード解説