ノード一覧に戻る

テキスト画像化

text_rasterize

最終的な文字レンダーノード。ローカルのフォント参照や作成済みレイアウトを画像化し、必要に応じてアウトラインも描画します

確認済み
解説あり

入力ポート

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

出力ポート

名前説明
画像
output
Image
画像化されたテキスト

パラメータ

名前既定値範囲説明・選択肢
テキスト
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 入力が未接続の時に使う文字色

概要

文字をドット絵画像に描き起こす、テキスト系の本命レンダーノードです。 フォント選択・サイズ・塗り・アウトラインまでこれ1つで完結します。 スコア表示・タイトルロゴ・セリフ枠など、文字が要るものすべての出口です。

使い方のポイント

  • 最小構成は text_input → text_rasterize。ドット絵なら antialias を オフ(または threshold で2値化)し、ビットマップ系フォントの font_path 指定が最もきれい
  • 文字単位の演出を挟むときだけ text_layout 経由: text_layout → text_reveal_by_glyph 等 → text_rasterize(layout入力)
  • layout 入力時はフォント系パラメータが無視される(レイアウト側で確定済み) ことを覚えておくと混乱しない

関連ノード

  • text_input — 文言の供給
  • text_layout / text_reveal_by_glyph / text_animate_by_glyph — 文字単位演出
  • text_outline — 縁取り既定値付きの互換ラッパー
  • pixel_cleanup — ラスタライズ後のゴミ掃除

優先ルール

  • 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)
ノード一覧に戻る
テキスト画像化 — PixPipeline ノード解説