Import

Spine project files and JSON or binary data can also be imported using the command line interface.

Spine can import data from other Spine projects, allowing projects to be combined. Spine can also import data in the same JSON and binary formats that Spine exports, allowing skeletons to be imported from other programs, such as image editor scripts.

Project

Spine can import a skeleton or animation from another Spine project. This can be used to move skeletons from other projects into a single project. Importing an animation can be used to have multiple people working on the same project, with some limitations.

To open the import project dialog, choose Import Project from the main menu.

Enter the path to the project file to import and choose to import a skeleton or animation.

Skeleton

After the skeleton is imported, some items can be dragged in the tree from one skeleton to another.

When importing a skeleton, choose which skeleton to import and the name to use for the imported skeleton.

Animation

An animation can be imported into a completely different skeleton, as long as it uses the same name for at least some bones and other items.

When importing an animation, choose which skeleton and animations to import, then the skeleton to which they will be imported.

The skeleton that the animations are imported into must have bones, slots, attachments, events, and constraints with the same names as the skeleton that is being imported from, but only for those items that are actually keyed in the animations being imported. Additionally, for deform keys, the mesh must have the same number of vertices in both skeletons.

If the skeleton is missing items keyed by an animation, the animation is imported without those keys and warnings are shown for the missing items.

Data

You can import data into Spine from an image editor script, continue working in your image editor, and later import newer data into the same skeleton.

Spine can import data in the JSON or binary formats that it exports. This provides a path to bring data from other programs into Spine, such as from image editor scripts.

To open the import data dialog, choose Import Data from the main menu.

Enter the path to the JSON or binary file to import, or the folder where they are located, and a name for the imported skeleton.

Scale

For example, if a Spine project is created with images that are 4 times larger than necessary, it can be exported to JSON with Nonessential checked, then imported to a new project with a scale of 0.25. The images used for the new project should be 25% the size of the original images.

The import data Scale changes the size of the skeleton without changing the scale of any bones. All the data is scaled: the position and length of bones, attachment offsets, bounding boxes, meshes, animations, etc.

If a Spine project was created with images that are the wrong size, the project can be exported to JSON with Nonessential checked and then imported again using Scale to change the size of the skeleton. The new project would then use images with a different size.

New project

When checked, the data will be imported into a new project.

When unchecked, the data will be imported into the current project and more options appear.

Create a new skeleton

When checked, the data is imported into the current project as a new skeleton.

Import into an existing skeleton

When checked, the data is imported into the chosen skeleton in the current project.

Existing attachments

If the skeleton already contains an item from the data:

  • When Ignore is checked, it is left as is. This preserves any changes that may have been made to the item.
  • When Replace is checked, it is replaced with the item from the data.

Next: Command line interface Previous: Texture packing