Import

import filename

Imports a PNG image file as sprite data.

filename

The .png graphics file to import.

This command imports a specially formatted PNG image file to be the sprite sheet for the current cartridge. The file must be 128 pixels wide, 128 pixels tall, and use the PICO-8 palette (otherwise the file will be clipped, and the colors will be set to the closest PICO-8 color).

To edit the sprite sheet in an external graphics editing program, use the export command to make a PNG image file with the correct properties, edit it in the external editor, then use the import command to update the cartridge. You can set up the palette in your editor by placing some of each color on the sprite sheet within PICO-8, then sampling the exported file.

To transfer a sprite sheet from one cartridge to another, export it from the first cartridge, then import it into the second cartridge.

Examples

> import sprites.png

See also

• Graphics
• export