テキスト画像化 — PixPipeline ノード解説

入力ポート

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

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

名前

型

説明

画像

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	24	4–256	ピクセル単位のフォントサイズ
字間 tracking	Int	0	-16–64	文字ごとに追加する字間
行送り line_height	Float	1	0.5–3 / step 0.05	フォントメトリクスに対する行送り倍率
余白 padding	Int	2	0–64	文字のまわりに追加する透明余白
塗りを表示 fill_enabled	Bool	true	—	文字本体の塗りを描画するか
揃え align	Enum	Left	—	自動計算された文字領域内での横方向揃え左寄せ`Left` 中央寄せ`Center` 右寄せ`Right`
アンチエイリアス antialias	Enum	Gray	—	文字のスムージング方法ピクセル`Pixel` アンチエイリアスを切って硬い輪郭で描画しますグレイ`Gray` グレースケールのアンチエイリアスをかけてからしきい値処理します
アウトラインを表示 outline_enabled	Bool	false	—	文字の外側にアウトラインを描画するか
線幅 outline_width	Int	1	0–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.15	0–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)

入力ポート

出力ポート

パラメータ

優先ルール

技術詳細

使用例