Import Tiled maps and tilesets (.tmx / .tsx)

Import supported Tiled TMX maps and TSX tilesets into Pixscape Studio and export them as Pixscape scene data for LibGDX.

Pixscape Studio imports a supported Tiled .tmx map as a new Pixscape scene. The Tiled files are authoring inputs, not Runtime dependencies: source layers, tiles and objects are converted to native Pixscape scene content.

After import, you continue working with Pixscape scene data. Later changes to the original TMX file are not synchronized automatically.

Import a TMX map

1. Open or create a Pixscape project.
2. Choose File > Import > Tiled map (.tmx)....
3. Select the .tmx file.
4. Review the preflight results.
5. Confirm or change the scene name.
6. Click Import.

Pixscape checks the TMX and referenced resources before changing the project. Blocking problems stop the import; warnings explain content that will be adapted or ignored.

Supported Tiled content

After import

The imported map opens as a native Pixscape scene rather than a frozen TMX preview. Source tile content becomes first-class Tiled Maps inside Universal Layers, while imported object and image content becomes ordinary editable scene content where applicable. A Scene can contain multiple Tiled Maps, and each Universal Layer can mix them with other entities. All imported content participates in the normal Canvas and Items & Properties workflows.

Imported Image Layer content becomes normal editable Pixscape visual content inside the imported scene structure.

Edit Tiled Maps

Select a Tiled Map to activate the Tiled editing context; the top-center indicator changes to Mode: Tiled. You can then paint compatible tiles from Project Assets into the selected Map.

A Tiled Map owns its projection, dimensions, tile size, chunk configuration, collision state and Spatial Depth. General parallax remains a property of the owning Universal Layer.

The Tiled toolbar provides Brush, Fill, Erase and Rectangle. Tile transform controls let you flip horizontally or vertically, rotate left or right, and reset the transform before painting. These tools work within the normal Canvas workflow rather than a separate Tiled editor.

Imported tile animations become Pixscape tiled-animation assets and can be used in Tiled Maps like other compatible tiles.

Edit imported objects

Imported Object Layer content is selectable as normal Pixscape scene content. Use Items & Properties to select an imported object and edit its supported metadata, typed custom properties and authored geometry where applicable.

Because the result is a native scene, you can continue with related authoring such as Physics or Spatial V3 for 2.5D depth when the project needs it.

Object Layers

Object Layers are imported into Pixscape for both orthogonal and isometric maps. Their object content becomes ordinary Pixscape scene entities placed in the imported scene structure rather than a separate Runtime object model. Rectangle, point, tile, polygon and polyline objects can be selected as Pixscape scene content; animated tile objects use the imported Tiled tile animation, and supported authored geometry remains editable where applicable.

Pixscape preserves Tiled object class/type metadata and custom properties on Object Layers and objects. Supported property values are String, Boolean, Integer, Float, Color, Object references and nested Class values.

After import, use Items & Properties to inspect and edit those properties on the resulting entities.

For tile objects, properties declared on the source tile are inherited. Properties set directly on the object override the inherited values. This inheritance also applies to compatible nested Class properties.

Tilesets and animations

TMX import supports embedded tilesets and external .tsx files, including single-image atlases and image collections. Standalone .tsx files can also be imported through File > Import > Assets...; see Import assets and tilesets for profile and alignment controls.

Tile dimensions, atlas margin and spacing, referenced images and supported tile animations are imported. Relative image paths are resolved from the TMX or TSX file that declares them.

See Tiled animations in Studio for editing imported animations.

Current limitations

• Infinite, hexagonal and staggered maps are not supported.
• Ellipse and text objects are reported but not materialized. Tiled templates are not supported.
• Custom properties on source TMX maps, tilesets, Group Layers, Tile Layers and Image Layers are ignored. Property import is limited to Object Layers, objects and tile metadata used by tile objects.
• Object-reference properties in tile metadata are not supported.
• Map parallax origin has no Pixscape equivalent and is ignored.
• Non-zero tileset <tileoffset> is not supported for source Tile Layer cells.

See also

• Import assets and tilesets
• Tiled Maps in the Runtime
• Tiled animations in the Runtime