Image file

Takes: — · Gives: frames

Input: a picture from outside, as a sprite list of its own: a PNG — one frame, or a strip or grid cut into frames Frame width by Frame height, each held Each frame — or a GIF, with its frames, their delays and whether it loops. Called is its row's name. The picture takes the sheet's palette (each pixel its nearest colour; what is more than half transparent is empty) and is centred on a cell; a frame bigger than a cell is refused, with both sizes. It goes on the sheets its node is wired to and on no other.

Settings

Setting	What it does	Range	Default
Called `name`	The name its rows carry, which a Layer takes.	text	`picture`
File	The picture: a PNG strip or grid, or a GIF.	text	—
Frame width `cell_w`	How wide one frame of the strip or grid is (0: the whole picture).	0 to 4096	`0`
Frame height `cell_h`	How tall one frame is (0: the whole picture).	0 to 4096	`0`
Each frame `hold_ms`	How long each frame lasts, in ms.	1 to 10000	`100`
Loops `looped`	Whether the frames loop.	on or off	`true`
Its own colours `own_colours`	Keep the picture's own colours rather than the palette's.	on or off	`false`

Every setting is also an input: wire a value into it to change it per frame or per file. On the command line: pxr graph set game.pixor --which asset --node image-file --set KEY=VALUE.

What it wires to

Its name input takes a text, which these give: Words.

What it gives, frames, goes into: Animation file, Arrange, Flip, Frame range, Hold, Layer, Merge, Tag.

In the app, drag a wire from one of its dots: every dot the wire fits is ringed.

How it fits with the rest: the Asset graph in the manual.

In the same group

Sprites · Merge · Layer · Frame range · Hold · Flip · Tag · Arrange · Place · Stack · Overlay · Sheet · File · JSON · Aseprite file · Godot SpriteFrames · Normal map · Depth map · Emission map · Line and flat layers · Palette · GIF per clip · APNG per clip · Video per clip · Light kit · PICO-8 cart · Report · Shadow layer · Palette variants · Paper-doll layers · Parallax layers · Text file · ZIP archive · Tile set · Icons · Animation file · Tile set JSON · Godot TileSet · Tiled tileset · Dual-grid sheet · GameMaker autotiles · RPG Maker autotiles · Unity RuleTile · LDtk project · Tile palette variants · Map preview · Number value · On/Off · Angle · Words · Add values · Subtract values · Multiply values · Divide values · Smaller value · Larger value · Is above · Opposite · Both on · Either on · Pick a value