Swiftpack.co -  maxgribov/Spine as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
maxgribov/Spine
Unofficial Spine runtime Swift library, allows you to play animations created in the Spine app (http://esotericsoftware.com).
.package(url: "https://github.com/maxgribov/Spine.git", from: "v2.1")

Build Status Pod Version

Spine

This Swift library allows you to upload characters and their animations from the Spine app (v3.8.x +) to SpriteKit for platforms:

iOS macOS tvOS watchOS

Implemented almost all the functionality of the essential version of Spine app: Animation of bones, skins, animation of slots, creation of physical bodies on the basis of bounding boxes and some other. See Implemented Features for more information.

Example of working with the library: Sample project
Learn more about working with the library: Spine Wiki

Hero

Installing

CocoaPods

Add the pod to your podfile

pod 'Spine'

run

pod install

Basic Usage

Assets

Files

  1. In assets catalog create folder. (Goblins folder in example below)
  2. Create sprite atlases. (default, goblin and goblingirl sprite atlases in example below)
  3. Put images into sprite atlaces.

Note that the images that are in the root folder of the Spine app project must be in the sprite atlas named default in the Xcode project.

Final result should looks something like this:

Assets

Namespace

Set Provides Namespace option enabled for the root folder and for all sprite atlases in the Xcode's attribute inspector:

Namespace

If you forget to set the namespace, later when you initialize your character images can be just not found.

JSON

Put the JSON exported from the Spine application somewhere in your project:

json

For more information about assets see Assets Wiki

Code

Somewhere at the beginning of your code, import the Spine library:

import Spine

The easiest way to load a character from a JSON file and apply skin to it is to use the appropriate Skeleton class constructor:

if let character = Skeleton(fromJSON: "goblins-ess", atlas: "Goblins", skin: "goblin") {

   //Do something with your character here
}

Skeleton is a subclass of SKNode, so you can do with it whatever you can do with SKNode itself

This way you can apply the animation created in Spine to the character:

if let walkAnimation = character.animation(named: "walk") {

    character.run(walkAnimation)
}

The animation(named:) method returns an object of the SKAction class so that you can use this animation as any other object of the SKAction class

This is an example of the simplest scene in which we load our Goblin character, add it to the scene and start walk animation in an endless loop:

import SpriteKit
import Spine

class GameScene: SKScene {
    
    override func didMove(to view: SKView) {
        
        if let character = Skeleton(fromJSON: "goblins-ess", atlas: "Goblins", skin: "goblin"){
            
            character.name = "goblin"
            character.position = CGPoint(x: self.size.width / 2, y: (self.size.height / 2))
            
            self.addChild(character)

            if let walkAnimation = character.animation(named: "walk") {
                
                character.run(SKAction.repeatForever(walkAnimation))
            }
        }
    }
}

Implemented Features

Name Model Feature Animation
Bones
- Rotation + + +
- Translation + + +
- Scale + + +
- Shear + - -
Bones extras:
- Reflect + -
- Rotation Inheritance + -
- Scale Inheritance + -
- Reflect Inheritance + -
Slots
- Attachment + + +
- Tint Color + + +/-
- Dark Tint Color + -
Skins + +
Attachments
- Region + +
- Mesh + - -
- Linked Mesh + - -
- Bounding Box + + -
- Path + - -
- Point + +
- Clipping + - -
Constraints
- IK Constraint + - -
- Transform Constraint + - -
- Path Constraint + - -
Events + + +
Draw Order + + +

System Requirements

Swift 5.0

  • iOS 8.0+
  • macOS 10.10+
  • tvOS 9.0+
  • watchOS 3.0+

License

This project is licensed under the MIT License - see the LICENSE file for details

Useful links

GitHub

link
Stars: 99
Last commit: 3 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Release Notes

SPM support, animation curves fix
45 weeks ago

Thanks to @dm-gmorning for this update.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API