mirror of
https://github.com/EsotericSoftware/spine-runtimes.git
synced 2025-12-21 01:36:02 +08:00
[spine-js] Deprecated, updated README.md
This commit is contained in:
badlogic
parent
4a657158ba
commit
6e4784232f
@ -1,28 +0,0 @@
|
|||||||
Spine Runtimes Software License
|
|
||||||
Version 2.3
|
|
||||||
|
|
||||||
Copyright (c) 2013-2015, Esoteric Software
|
|
||||||
All rights reserved.
|
|
||||||
|
|
||||||
You are granted a perpetual, non-exclusive, non-sublicensable and
|
|
||||||
non-transferable license to use, install, execute and perform the Spine
|
|
||||||
Runtimes Software (the "Software") and derivative works solely for personal
|
|
||||||
or internal use. Without the written permission of Esoteric Software (see
|
|
||||||
Section 2 of the Spine Software License Agreement), you may not (a) modify,
|
|
||||||
translate, adapt or otherwise create derivative works, improvements of the
|
|
||||||
Software or develop new applications using the Software or (b) remove,
|
|
||||||
delete, alter or obscure any trademarks or any copyright, trademark, patent
|
|
||||||
or other intellectual property or proprietary rights notices on or in the
|
|
||||||
Software, including any copy thereof. Redistributions in binary or source
|
|
||||||
form must include this license and terms.
|
|
||||||
|
|
||||||
THIS SOFTWARE IS PROVIDED BY ESOTERIC SOFTWARE "AS IS" AND ANY EXPRESS OR
|
|
||||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
||||||
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
|
||||||
EVENT SHALL ESOTERIC SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
||||||
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
||||||
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
||||||
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
||||||
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
||||||
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
|
||||||
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
@ -1,35 +1,3 @@
|
|||||||
# spine-js
|
# spine-js
|
||||||
|
|
||||||
The spine-js runtime provides functionality to load and manipulate [Spine](http://esotericsoftware.com) skeletal animation data using JavaScript. It does not perform rendering but can be extended to enable Spine animations for other JavaScript-based projects.
|
spine-js has been deprecated and is superseded by [spine-ts](https://github.com/EsotericSoftware/spine-runtimes/tree/master/spine-ts). The most recent version of spine-js can be found in the [spine-js branch](https://github.com/EsotericSoftware/spine-runtimes/tree/spine-js/spine-js)
|
||||||
|
|
||||||
# spine-canvas
|
|
||||||
|
|
||||||
The spine-canvas runtime extends spine-js and is a basic example of how to perform rendering using an HTML5 canvas. Because spine-canvas renders rectangular images, nonuniform scaling and mesh attachments are not supported.
|
|
||||||
|
|
||||||
## 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](https://esotericsoftware.com/spine-purchase). Please see the [Spine Runtimes Software License](https://github.com/EsotericSoftware/spine-runtimes/blob/master/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](https://esotericsoftware.com/files/license.txt) grants the right to create and distribute derivative works of the Spine Runtimes.
|
|
||||||
|
|
||||||
## Spine version
|
|
||||||
|
|
||||||
spine-js works with data exported from Spine 3.1.08. Updating spine-js to [v3.2](https://github.com/EsotericSoftware/spine-runtimes/issues/586) and [v3.3](https://github.com/EsotericSoftware/spine-runtimes/issues/613) is in progress.
|
|
||||||
|
|
||||||
spine-js supports all Spine features. spine-canvas does not support color tinting, mesh attachments, or nonuniform scaling.
|
|
||||||
|
|
||||||
spine-js does not yet support loading the binary format.
|
|
||||||
|
|
||||||
## Setup
|
|
||||||
|
|
||||||
1. Download the Spine Runtimes source using [git](https://help.github.com/articles/set-up-git) or by downloading it [as a zip](https://github.com/EsotericSoftware/spine-runtimes/archive/master.zip).
|
|
||||||
1. Include the `spine.js` file (and optionally the `spine-canvas.js` file) in your project.
|
|
||||||
|
|
||||||
## Demos
|
|
||||||
|
|
||||||
- [spine-canvas](http://esotericsoftware.com/files/runtimes/spine-js/example/)
|
|
||||||
|
|
||||||
## Runtimes Extending spine-js
|
|
||||||
|
|
||||||
- [spine-turbulenz](https://github.com/EsotericSoftware/spine-runtimes/blob/master/spine-turbulenz)
|
|
||||||
- [spine-threejs](https://github.com/EsotericSoftware/spine-runtimes/blob/master/spine-threejs)
|
|
||||||
|
|||||||
File diff suppressed because one or more lines are too long
@ -1,118 +0,0 @@
|
|||||||
/******************************************************************************
|
|
||||||
* Spine Runtimes Software License
|
|
||||||
* Version 2.3
|
|
||||||
*
|
|
||||||
* Copyright (c) 2013-2015, Esoteric Software
|
|
||||||
* All rights reserved.
|
|
||||||
*
|
|
||||||
* You are granted a perpetual, non-exclusive, non-sublicensable and
|
|
||||||
* non-transferable license to use, install, execute and perform the Spine
|
|
||||||
* Runtimes Software (the "Software") and derivative works solely for personal
|
|
||||||
* or internal use. Without the written permission of Esoteric Software (see
|
|
||||||
* Section 2 of the Spine Software License Agreement), you may not (a) modify,
|
|
||||||
* translate, adapt or otherwise create derivative works, improvements of the
|
|
||||||
* Software or develop new applications using the Software or (b) remove,
|
|
||||||
* delete, alter or obscure any trademarks or any copyright, trademark, patent
|
|
||||||
* or other intellectual property or proprietary rights notices on or in the
|
|
||||||
* Software, including any copy thereof. Redistributions in binary or source
|
|
||||||
* form must include this license and terms.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY ESOTERIC SOFTWARE "AS IS" AND ANY EXPRESS OR
|
|
||||||
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
||||||
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
|
|
||||||
* EVENT SHALL ESOTERIC SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
||||||
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
||||||
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
||||||
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
||||||
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
||||||
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
|
||||||
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*****************************************************************************/
|
|
||||||
|
|
||||||
spine.SkeletonRenderer = function (imagesPath) {
|
|
||||||
this.imagesPath = imagesPath;
|
|
||||||
this.lastTime = Date.now();
|
|
||||||
};
|
|
||||||
|
|
||||||
spine.SkeletonRenderer.prototype = {
|
|
||||||
skeletonData: null,
|
|
||||||
state: null,
|
|
||||||
scale: 1,
|
|
||||||
skeleton: null,
|
|
||||||
|
|
||||||
load: function(jsonText) {
|
|
||||||
var imagesPath = this.imagesPath;
|
|
||||||
var json = new spine.SkeletonJson({
|
|
||||||
newRegionAttachment: function (skin, name, path) {
|
|
||||||
var image = new Image();
|
|
||||||
image.src = imagesPath + path + ".png";
|
|
||||||
var attachment = new spine.RegionAttachment(name);
|
|
||||||
attachment.rendererObject = image;
|
|
||||||
return attachment;
|
|
||||||
},
|
|
||||||
newBoundingBoxAttachment: function (skin, name) {
|
|
||||||
return new spine.BoundingBoxAttachment(name);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
json.scale = this.scale;
|
|
||||||
this.skeletonData = json.readSkeletonData(JSON.parse(jsonText));
|
|
||||||
spine.Bone.yDown = true;
|
|
||||||
|
|
||||||
this.skeleton = new spine.Skeleton(this.skeletonData);
|
|
||||||
|
|
||||||
var stateData = new spine.AnimationStateData(this.skeletonData);
|
|
||||||
this.state = new spine.AnimationState(stateData);
|
|
||||||
},
|
|
||||||
|
|
||||||
update: function() {
|
|
||||||
var now = Date.now();
|
|
||||||
var delta = (now - this.lastTime) / 1000;
|
|
||||||
this.lastTime = now;
|
|
||||||
|
|
||||||
this.state.update(delta);
|
|
||||||
this.state.apply(this.skeleton);
|
|
||||||
this.skeleton.updateWorldTransform();
|
|
||||||
},
|
|
||||||
|
|
||||||
render: function(context) {
|
|
||||||
var skeleton = this.skeleton, drawOrder = skeleton.drawOrder;
|
|
||||||
context.translate(skeleton.x, skeleton.y);
|
|
||||||
|
|
||||||
for (var i = 0, n = drawOrder.length; i < n; i++) {
|
|
||||||
var slot = drawOrder[i];
|
|
||||||
var attachment = slot.attachment;
|
|
||||||
if (!(attachment instanceof spine.RegionAttachment)) continue;
|
|
||||||
var bone = slot.bone;
|
|
||||||
var x = attachment.x * bone.a + attachment.y * bone.b + bone.worldX;
|
|
||||||
var y = attachment.x * bone.c + attachment.y * bone.d + bone.worldY;
|
|
||||||
var rotation = (bone.getWorldRotationX() - attachment.rotation) * Math.PI / 180;
|
|
||||||
var w = attachment.width * bone.getWorldScaleX(), h = attachment.height * bone.getWorldScaleY();
|
|
||||||
context.translate(x, y);
|
|
||||||
context.rotate(rotation);
|
|
||||||
context.drawImage(attachment.rendererObject, -w / 2, -h / 2, w, h);
|
|
||||||
context.rotate(-rotation);
|
|
||||||
context.translate(-x, -y);
|
|
||||||
}
|
|
||||||
|
|
||||||
context.translate(-skeleton.x, -skeleton.y);
|
|
||||||
},
|
|
||||||
|
|
||||||
animate: function (id) {
|
|
||||||
var canvas = document.getElementById(id);
|
|
||||||
var context = canvas.getContext("2d");
|
|
||||||
var requestAnimationFrame = window.requestAnimationFrame ||
|
|
||||||
window.webkitRequestAnimationFrame ||
|
|
||||||
window.mozRequestAnimationFrame ||
|
|
||||||
function (callback) {
|
|
||||||
window.setTimeout(callback, 1000 / 60);
|
|
||||||
};
|
|
||||||
var self = this;
|
|
||||||
function renderFrame () {
|
|
||||||
context.clearRect(0, 0, canvas.width, canvas.height);
|
|
||||||
self.update();
|
|
||||||
self.render(context);
|
|
||||||
requestAnimationFrame(renderFrame);
|
|
||||||
};
|
|
||||||
renderFrame();
|
|
||||||
}
|
|
||||||
};
|
|
||||||
2862
spine-js/spine.js
2862
spine-js/spine.js
File diff suppressed because it is too large
Load Diff
Loading…
x
Reference in New Issue
Block a user