UnityMirror/spine-runtimes
1
0
Fork 0
mirror of https://github.com/EsotericSoftware/spine-runtimes.git synced 2025-12-20 17:26:01 +08:00
Code Issues Packages Projects Releases Wiki Activity
spine-runtimes/spine-cocos2dx/3
History
NathanSweet c9aede1ffd Docs.
2016-04-03 14:58:01 +02:00
..
cocos2dx
Dropped support for cocos2d-x 3.0 and 3.1.
2014-08-31 16:50:51 +02:00
example
Cocos2dAttachmentLoader needs to be C++.
2016-04-03 12:58:36 +02:00
src/spine
Docs.
2016-04-03 14:58:01 +02:00
LICENSE
You get a license file, you get a license file, EVERYBODY GETS A LICENSE FILE!
2015-07-30 22:47:00 +02:00
README.md
Docs.
2016-03-05 18:56:13 +01:00

README.md

spine-cocos2dx v3.x

The spine-cocos2dx runtime provides functionality to load, manipulate and render Spine skeletal animation data using cocos2d-x. spine-cocos2dx is based on spine-c.

Licensing

This Spine Runtime may only be used for personal or internal use, typically to evaluate Spine before purchasing. If you would like to incorporate a Spine Runtime into your applications, distribute software containing a Spine Runtime, or modify a Spine Runtime, then you will need a valid Spine license. Please see the Spine Runtimes Software License for detailed information.

The Spine Runtimes are developed with the intent to be used with data exported from Spine. By purchasing Spine, Section 2 of the Spine Software License grants the right to create and distribute derivative works of the Spine Runtimes.

Setup

The setup for cocos2d-x differs from most other Spine Runtimes because the cocos2d-x distribution includes a copy of the Spine Runtime files. This is not ideal because these files may be old and fail to work with the latest Spine editor. Also it means if cocos2d-x is updated, you may get newer Spine Runtime files which can break your application if you are not using the latest Spine editor. For these reasons, we have requested cocos2d-x to cease distributing the Spine Runtime files, but they continue to do so.

To replace the Spine Runtime files distributed with cocos2d-x, please follow these directions:

  1. Download a cocos2d-x version 3.x distribution or get the latest from GitHub or as a zip.
  2. Run the cocos2dx/download-deps.py Python script to download dependencies required by cocos2d-x.
  3. Delete the .c, .cpp, and .h files in cocos2dx/cocos/editor-support/spine. These are the Spine Runtime files that cocos2d-x distributes.
  4. Download the Spine Runtimes source using git or by downloading it as a zip.
  5. Copy spine-c/src/spine, spine-c/include/spine, and spine-cocos2dx/3/src/spine to spine-cocos2dx/3/cocos2dx/cocos/editor-support/spine. If any files were added or removed, you may need to edit the appropriate cocos2d-x project files.

Alternatively, you may delete the Spine Runtime files out of cocos2d-x and directly use the contents of the spine-c/src, spine-c/include, and spine-cocos2dx/3/src directories in your projects. Be sure your header search path will find the contents of these directories. Note that the includes use spine/Xxx.h, so the spine directory cannot be omitted when copying the files.

To run the cocos2d-x Spine examples on Windows:

  1. Place cocos2d-x into spine-cocos2dx/3/cocos2dx and open spine-cocos2dx/3/example/proj.win32/spine-cocos2dx.sln. Alternatively, add spine-cocos2dx/3/example/proj.win32/spine-cocos2dx.vcxproj to your Visual Studio solution which contains cocos2d-x.
  2. Copy the contents of spine-cocos2dx/3/example/Resources to spine-cocos2dx/3/example/proj.win32/Debug.win32. This step is required because cocos2d-x insists on looking for resources in the directory containing the executable.
  3. Run the spine-cocos2dx project. Click to show debug bones, again for slow motion, and again to change scenes.

Notes

  • Images are premultiplied by cocos2d-x, so the Spine atlas images should not use premultiplied alpha.

Examples