Back to Node List

Tile Canvas Animation Render

tile_canvas_animation_render

Samples a tile canvas over time into frame images and one sprite sheet.

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
タイルマップ
canvas
TileCanvas
Required
解決・描画するタイルマップです。
タイルパレット
tile_palette
TilePalette
追加の素材テーブルを持つパレット(任意)です。

Output Ports

NameTypeDescription
フレーム一覧
frames
List<Image>
時刻順のフレーム画像一覧です。
スプライトシート
spritesheet
SpriteSheet
フレームを1枚に並べたシートです。
警告
warnings
Text
フレーム上限や解決の診断です。

Parameters

NameTypeDefaultRangeDescription / Options
長さ(ms)
duration_ms
Int
10001–3600000

サンプリングする長さです。フレームは [0, duration) を覆います。

FPS
fps
Int
101–120

出力FPSです(フレームnの時刻は n*1000/fps ms)。

最大フレーム数
max_frames
Int
641–1024

上限です。超える場合は黙って切らず警告を出します。

列数
columns
Int
00–64

シートの列数です。0で1行に並べます。

Overview

Samples a tile map over time and produces a list of frame images plus a sprite sheet. A map containing animated tiles (water, etc.) becomes an animation asset as-is.

Usage tips

  • Sampling is specified as duration (ms) + FPS + max frames (no LCM-of-periods). Frame n is taken at n×1000/FPS ms, covering [0, duration) as a half-open interval.
  • If the planned frame count exceeds the max, frames are not silently dropped — warnings reports the overflow. Adjust duration/FPS or raise the cap.
  • Rule resolution runs once; each frame only does frame selection and compositing.
  • The spritesheet output plugs directly into existing sprite-sheet nodes (Aseprite export, playback, …).

Common pitfalls

  • Too few / too many frames — check the duration × FPS combination: 10 FPS × 1000 ms yields 10 frames.

Related nodes

  • tile_canvas_render — a still image at one time
  • sprite_sheet_playback / aseprite_export — playing back / exporting the sheet
Back to Node List
Tile Canvas Animation Render — PixPipeline Node Reference