Yotsuba Games
Back to Node List

Text Animate By Glyph

text_animate_by_glyph

Applies staggered per-glyph translate, scale, opacity, wave, and bounce animation

Reviewed
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
Required
1ę–‡å­—å˜ä½ć§å¤‰å½¢ć™ć‚‹ TextLayout

Output Ports

NameTypeDescription
ćƒ¬ć‚¤ć‚¢ć‚¦ćƒˆ
layout
TextLayout
1ę–‡å­—ć”ćØć®å¤‰å½¢ēŠ¶ę…‹ć‚’ę›“ę–°ć—ćŸ TextLayout

Parameters

NameTypeDefaultRangeDescription / Options
é€²č”Œåŗ¦
progress
Float
10–1 / step 0.01

éøęŠžć—ćŸę–‡å­—ēÆ„å›²ć«åÆ¾ć™ć‚‹ę­£č¦åŒ–ć‚¢ćƒ‹ćƒ”ćƒ¼ć‚·ćƒ§ćƒ³é€²č”Œåŗ¦

å…ˆé ­ę–‡å­—
first_glyph
Int
00–4096

ć‚¢ćƒ‹ćƒ”ćƒ¼ć‚·ćƒ§ćƒ³åÆ¾č±”ć«å«ć‚ć‚‹å…ˆé ­ę–‡å­—ē•Ŗå·ļ¼ˆ0 = 1文字目)

ęœ«å°¾ę–‡å­—
last_glyph
Int
40960–4096

ć‚¢ćƒ‹ćƒ”ćƒ¼ć‚·ćƒ§ćƒ³åÆ¾č±”ć«å«ć‚ć‚‹ęœ«å°¾ę–‡å­—ē•Ŗå·

逆順
reverse
Bool
false—

éøęŠžć—ćŸę–‡å­—ēÆ„å›²ć‚’ęœ«å°¾ć‹ć‚‰å…ˆé ­ćøå‘ć‹ć£ć¦ć‚¢ćƒ‹ćƒ”ćƒ¼ć‚·ćƒ§ćƒ³ć—ć¾ć™

1文字遅延
stagger
Float
00–0.5 / step 0.01

åÆ¾č±”ę–‡å­—ć”ćØć®ę­£č¦åŒ–é…å»¶é‡ć€‚é€²č”Œåŗ¦1ć§å…Øę–‡å­—ćŒå®Œäŗ†ć™ć‚‹ć‚ˆć†ć€åæ…č¦ę™‚ćÆč‡Ŗå‹•åˆ¶é™ć—ć¾ć™ć€‚

開始Xć‚Ŗćƒ•ć‚»ćƒƒćƒˆ
translate_x
Float
0-128–128 / step 1

é–‹å§‹ę™‚ć«é©ē”Øć—ć€é€²č”Œć«åæœć˜ć¦ 0 ćøęˆ»ć‚‹ęØŖć‚Ŗćƒ•ć‚»ćƒƒćƒˆ

開始Yć‚Ŗćƒ•ć‚»ćƒƒćƒˆ
translate_y
Float
0-128–128 / step 1

é–‹å§‹ę™‚ć«é©ē”Øć—ć€é€²č”Œć«åæœć˜ć¦ 0 ćøęˆ»ć‚‹ēø¦ć‚Ŗćƒ•ć‚»ćƒƒćƒˆ

é–‹å§‹ć‚¹ć‚±ćƒ¼ćƒ«
start_scale
Float
10.05–4 / step 0.05

é€²č”Œåŗ¦ 0 ć§é©ē”Øć—ć€é€²č”Œć«åæœć˜ć¦ 1.0 ćøęˆ»ć‚‹ć‚¹ć‚±ćƒ¼ćƒ«

é–‹å§‹äøé€ę˜Žåŗ¦
start_opacity
Float
10–1 / step 0.01

é€²č”Œåŗ¦ 0 ć§é©ē”Øć—ć€é€²č”Œć«åæœć˜ć¦ 1.0 ćøęˆ»ć‚‹äøé€ę˜Žåŗ¦

ę³¢ć®é«˜ć•
wave_y
Float
0-64–64 / step 1

ć‚¢ćƒ‹ćƒ”ćƒ¼ć‚·ćƒ§ćƒ³äø­ć«čæ½åŠ ć™ć‚‹ć‚µć‚¤ćƒ³ę³¢ć®ēø¦ęŗć‚Œé‡

ę³¢ć®å‘ØęœŸę•°
wave_cycles
Float
10–8 / step 0.25

0..1 ć®é€²č”Œåŗ¦å…Øä½“ć§ä½•å‘ØęœŸć¶ć‚“ę³¢ć‚’é€²ć‚ć‚‹ć‹

ćƒć‚¦ćƒ³ć‚¹é«˜ć•
bounce_y
Float
00–128 / step 1

å„ę–‡å­—ć®ćƒ­ćƒ¼ć‚«ćƒ«é€²č”Œåŗ¦ć«ę²æć£ć¦ 1 å›žć ć‘äøŠćøč·³ć­ć‚‹é‡

Overview

Animates text by moving individual characters. Apply fly-in, soft appearance, waves, or bounce with stagger delays between characters to create lively motion such as an animated title logo.

Usage tips

  • The go-to chain is text_layout → text_animate_by_glyph (drive progress with time_source) → text_rasterize → animation_render.
  • stagger is the heart of this node. At 0, all characters animate together like one whole block. Increasing it strengthens the sense of sequential motion.
  • If stagger is too large for the selected glyph count, its effective value is limited to 0.95 / (selected count - 1) and a non-fatal warning is shown. This guarantees that every selected glyph reaches its completed state at progress = 1.
  • Use text_reveal_by_glyph for show/hide effects; this node controls motion. They can be chained to make characters bounce as they appear.
  • This node does not expand the original layout bounds. If a large translation, scale, or bounce is clipped, increase downstream text_rasterize padding.

Related nodes

  • text_reveal_by_glyph — controls visibility and can be combined with this node
  • text_layout — required upstream
  • text_rasterize / text_outline — render to an image
  • ease_in_out — eases progress

How to think about it

  • TextLayout stores where characters are placed.
  • TextAnimateByGlyph overrides how each character moves.
  • Finally, TextRasterize v2 or TextOutline bakes the result to an image.

Per-character model

  • In v1, a glyph effectively means one character.
  • First Glyph = 0 means the first character.
  • The upper limit of Last Glyph adjusts automatically to the character count of the input TextLayout.

Progress

  • progress ranges from 0..1.
  • With 11 target characters, one character step is 1 / 11.
  • Setting stagger above 0 delays each character in sequence.
  • progress = 1 always means every selected glyph is complete; a warning indicates when the requested stagger had to be limited.

Technical details

  • This node returns a new TextLayout with updated TextLayoutGlyph.visible / opacity / translate / scale values.
  • translate_x / translate_y interpolate from the starting position back to the original position.
  • start_scale / start_opacity similarly interpolate from the starting state back to the normal state.
  • wave_y adds a sine-wave offset during progress.
  • bounce_y adds one arcing vertical bounce per character.
  • TextRasterize v2 / TextOutline read translate / scale / opacity when drawing.
  • Transforms do not expand TextLayout.bounds; reserve raster padding downstream.
  • Inspect glyph index / bbox for the output TextLayout under Text Layout (Debug) in the Inspector.

Examples

[Text Input] -> [Text Layout] -> [Text Animate By Glyph] -> [Text Rasterize] -> [Preview]
[Text Input] -> [Text Layout] -> [Text Animate By Glyph] -> [Text Outline] -> [Preview]
Back to Node List
Text Animate By Glyph — PixPipeline Node Reference