Import assets and tilesets

Import images, sprite sheets, particle effects, PNG tilesets and standalone TSX tilesets.

Open the asset importer with File > Import > Assets... or the Import button in the Project Assets panel.

The screenshot shows the base import list. Tileset rows expose additional profile controls in Studio Free 0.2.2.

Add individual files

Click Add files..., inspect the detected type for every row, then use the X button to remove an unwanted file or Clear to empty the list.

A PNG can be imported as an IMAGE, a SPRITESHEET or a tileset. For a sprite sheet, choose SPRITESHEET and set Frame W and Frame H to the dimensions of one frame.

Particle effects normally use a .p file. Also import the PNG texture referenced by the effect when it is not already in the project.

Import a standalone TSX tileset

Use Add files... and choose the .tsx file. Studio detects it as a TSX tile set and reads:

• the relative source image;
• tile width and height;
• margin and spacing;
• supported tile animations and their frame durations.

Direct TSX import in 0.2.2 supports single-image tilesets. It creates Pixscape tile assets and, when declared, their tile-animation definitions. Studio takes the atlas dimensions, margin, spacing and animation metadata from the TSX instead of asking for the manual PNG profile fields. This workflow is useful when a tileset is shared independently of a complete map.

An image-collection TSX must be referenced by a .tmx map and imported through File > Import > Tiled map (.tmx)....

If the TSX image cannot be found, verify its path relative to the TSX file. See Import Tiled maps and tilesets for the full TMX compatibility matrix.

Import a PNG atlas as a tileset

Add the PNG, select the tileset type, then open Profile.... The Tileset profile dialog defines both slicing and placement:

• Tile width and Tile height: size of a tile inside the atlas;
• Margin and Spacing: border and gap used when slicing the atlas;
• Cell width and Cell height: logical placement cell in the scene;
• Projection: Orthogonal or Isometric;
• Anchor: Top center, Bottom center, Bottom left, Center or Top left;
• Offset X and Offset Y: adjustment from the selected anchor;
• Render size: the source image’s Native dimensions.

The default manual profile uses 32 × 32 tiles and cells, orthogonal projection, Top center, zero offsets and native render size. Change these values to match the source art before importing.

Import a folder tileset

Choose Add tileset directory... to import a directory of individual tile images. Review its profile before import. Folder profiles provide cell size, projection, anchor and offsets; each tile keeps its native image size.

Profiles apply to the tileset as a whole. Studio does not provide per-tile profile overrides. For tall isometric walls and props, use the logical cell size plus anchor and offset to align their footprint while preserving the full native image.

Complete and verify the import

Click Import after checking the file list, types and profiles. Imported assets appear under the appropriate sections of Project Assets.

Before building a large scene:

1. place representative tiles at the edges and center of a small test layer;
2. check atlas spacing and margin for bleeding or shifted regions;
3. preview tall tiles to verify their anchor and offset;
4. verify imported tile animations;
5. only then author Spatial V3 walls against the tiled layer.

For a first project and export workflow, continue with Try Pixscape in 10 minutes.