com.brashmonkey.spriter.player.SpriterAbstractPlayer Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of Spriter Show documentation
Show all versions of Spriter Show documentation
A generic Java library for Spriter animation files.
/**************************************************************************
* Copyright 2013 by Trixt0r
* (https://github.com/Trixt0r, Heinrich Reich, e-mail: [email protected])
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
***************************************************************************/
package com.brashmonkey.spriter.player;
import java.util.List;
import java.util.LinkedList;
import com.brashmonkey.spriter.SpriterPoint;
import com.brashmonkey.spriter.SpriterCalculator;
import com.brashmonkey.spriter.SpriterKeyFrameProvider;
import com.brashmonkey.spriter.SpriterRectangle;
import com.brashmonkey.spriter.animation.SpriterAnimation;
import com.brashmonkey.spriter.animation.SpriterKeyFrame;
import com.brashmonkey.spriter.draw.DrawInstruction;
import com.brashmonkey.spriter.file.FileLoader;
import com.brashmonkey.spriter.objects.SpriterAbstractObject;
import com.brashmonkey.spriter.objects.SpriterBone;
import com.brashmonkey.spriter.objects.SpriterModObject;
import com.brashmonkey.spriter.objects.SpriterObject;
import com.discobeard.spriter.dom.CharacterMap;
import com.discobeard.spriter.dom.SpriterData;
/**
* SpriterAbstractPlayer is meant to be a base for SpriterPlayer.
* This abstract class has been created, to have the ability to interpolate
* other running players at runtime. See #SpriterPlayerInterpolator.
*
* @author Trixt0r
*/
public abstract class SpriterAbstractPlayer {
public final SpriterKeyFrame lastFrame,lastTempFrame;
public boolean transitionFixed = true, drawn = false;
protected int currenObjectsToDraw, flipX = 1, flipY = 1, frameSpeed = 10, zIndex = 0, currentBonesToAnimate;
protected DrawInstruction[] instructions;
protected SpriterModObject[] moddedObjects,moddedBones;
protected SpriterObject[] tempObjects, tempObjects2, nonTransformedTempObjects;
protected SpriterBone[] tempBones, tempBones2, nonTransformedTempBones;
protected List animations;
protected SpriterAbstractObject rootParent, tempParent;
protected float angle = 0f, scale = 1f, pivotX = 0f, pivotY = 0f;
protected long frame;
protected List players;
private boolean generated = false;
SpriterRectangle rect;
public final FileLoader loader;
public boolean updateObjects = true, updateBones = true;
public CharacterMap characterMap = null;
/**
* Constructs a new SpriterAbstractPlayer object which is able to animate SpriterBone instances and SpriterObject instances.
* @param loader {@link FileLoader} which you have to implement on your own.
* @param keyframes A list of SpriterKeyFrame arrays. See {@link SpriterKeyFrameProvider#generateKeyFramePool(SpriterData)} to get the list.
* Generate these keyframes once to save memory.
*/
public SpriterAbstractPlayer(FileLoader loader, List animations){
this.loader = loader;
this.animations = animations;
this.rootParent = new SpriterBone();
this.tempParent = new SpriterBone();
this.rootParent.setName("playerRoot");
this.tempParent.setName("playerRoot");
this.lastFrame = new SpriterKeyFrame();
this.lastTempFrame = new SpriterKeyFrame();
this.players = new LinkedList();
rect = new SpriterRectangle(0,0,0,0);
}
/**
* Generates data which is necessary to animate all animations as intended.
* This method has to called inside the specific constructor.
*/
protected final void generateData(){
int maxObjects = 0, maxBones = 0;
int maxBonesFrameIndex = 0, maxObjectsFrameIndex=0, maxBonesAnimationIndex = 0, maxObjectsAnimationIndex = 0;
for(SpriterAnimation animation: this.animations){
for(SpriterKeyFrame frame: animation.frames){
maxBones = Math.max(frame.getBones().length, maxBones);
if(maxBones == frame.getBones().length){
maxBonesFrameIndex = frame.getId();
maxBonesAnimationIndex = animation.id;
}
maxObjects = Math.max(frame.getObjects().length, maxObjects);
if(maxObjects == frame.getObjects().length){
maxObjectsFrameIndex = frame.getId();
maxObjectsAnimationIndex = animation.id;
}
for(SpriterObject o: frame.getObjects())
o.setRef(this.loader.findReference(o.getRef()));
}
}
this.instructions = new DrawInstruction[maxObjects];
this.moddedObjects = new SpriterModObject[this.instructions.length];
this.tempObjects = new SpriterObject[this.instructions.length];
this.tempObjects2 = new SpriterObject[this.instructions.length];
this.nonTransformedTempObjects = new SpriterObject[this.instructions.length];
for(int i = 0; i < this.instructions.length; i++){
this.instructions[i] = new DrawInstruction(null,0,0,0,0,0,0,0,0);
this.tempObjects[i] = new SpriterObject();
this.tempObjects2[i] = new SpriterObject();
this.nonTransformedTempObjects[i] = new SpriterObject();
this.nonTransformedTempObjects[i].setId(i);
this.moddedObjects[i] = new SpriterModObject();
this.moddedObjects[i].setId(i);
}
this.tempBones = new SpriterBone[maxBones];
this.tempBones2 = new SpriterBone[tempBones.length];
this.nonTransformedTempBones = new SpriterBone[tempBones.length];
this.moddedBones = new SpriterModObject[this.tempBones.length];
for(int i = 0; i < this.tempBones.length; i++){
this.tempBones[i] = new SpriterBone();
this.tempBones2[i] = new SpriterBone();
this.nonTransformedTempBones[i] = new SpriterBone();
this.nonTransformedTempBones[i].setId(i);
this.moddedBones[i] = new SpriterModObject();
this.moddedBones[i].setId(i);
}
SpriterBone[] tmpBones1 = new SpriterBone[this.tempBones.length], tmpBones2 = new SpriterBone[this.tempBones.length];
SpriterObject[] tmpObjs1 = new SpriterObject[this.instructions.length], tmpObjs2 = new SpriterObject[this.instructions.length];
for(int i = 0; i < tmpObjs1.length; i++){
tmpObjs1[i] = new SpriterObject();
tmpObjs2[i] = new SpriterObject();
}
for(int i = 0; i < tmpBones1.length; i++){
tmpBones1[i] = new SpriterBone();
tmpBones2[i] = new SpriterBone();
}
this.lastFrame.setBones(tmpBones1);
this.lastFrame.setObjects(tmpObjs1);
this.lastTempFrame.setBones(tmpBones2);
this.lastTempFrame.setObjects(tmpObjs2);
for(SpriterObject object: this.animations.get(maxObjectsAnimationIndex).frames.get(maxObjectsFrameIndex).getObjects()){
for(int i = 0; i< this.nonTransformedTempObjects.length; i++)
if(this.nonTransformedTempObjects[i].getId() == object.getId()) object.copyValuesTo(this.nonTransformedTempObjects[i]);
}
for(SpriterBone bone: this.animations.get(maxBonesAnimationIndex).frames.get(maxBonesFrameIndex).getBones()){
for(int i = 0; i< this.nonTransformedTempBones.length; i++)
if(this.nonTransformedTempBones[i].getId() == bone.getId()) bone.copyValuesTo(this.nonTransformedTempBones[i]);
}
this.generated = true;
}
/**
* Updates this player and translates the animation to xOffset and yOffset.
* Frame is updated by previous set frame speed (See {@link #setFrameSpeed(long)} ).
* This method makes sure that the keyframes get played back.
* @param xOffset
* @param yOffset
*/
public final void update(float xOffset, float yOffset){
if(!this.generated)
System.out.println("Warning! You can not update this player, since necessary data has not been initialized!");
else this.step(xOffset, yOffset);
}
/**
* Has to be implemented by the specific player.
* @param xOffset
* @param yOffset
*/
protected abstract void step(float xOffset, float yOffset);
/**
* Interpolates the objects of firstFrame and secondFrame.
* @param currentFrame
* @param nextFrame
* @param xOffset
* @param yOffset
*/
protected void transformObjects(SpriterKeyFrame currentFrame, SpriterKeyFrame nextFrame, float xOffset, float yOffset) {
this.rect.set(xOffset, yOffset, xOffset, yOffset);
if(!this.updateObjects) return;
this.updateTransformedTempObjects(nextFrame.getObjects(), this.tempObjects2);
this.updateTempObjects(currentFrame.getObjects(), this.nonTransformedTempObjects);
float t = SpriterCalculator.getNormalizedTime(currentFrame.getTime(), nextFrame.getTime(), this.frame);
for (int i = 0; i < this.currenObjectsToDraw; i++)
if(this.tempObjects[i].active) this.tweenObject(this.nonTransformedTempObjects[i], nextFrame.getObjectFor(this.nonTransformedTempObjects[i]), i, t);
//else this.tweenObject(this.animations.get(0).frames.get(0).getObjectFor(this.nonTransformedTempObjects[i]), nextFrame.getObjectFor(this.nonTransformedTempObjects[i]), i, currentFrame.getTime(), nextFrame.getTime());
}
protected void setInstructionRef(DrawInstruction dI, SpriterObject obj1, SpriterObject obj2){
if(this.characterMap != null) dI.ref = characterMap.get(obj1.getRef());
else dI.ref = obj1.getRef();
dI.obj = obj1;
}
/**
* Interpolates the bones for this animation.
* @param currentFrame first keyframe
* @param nextFrame second keyframe
* @param currentAnimationTime
* @param key2StartTime
* @return interpolated SpriterBone array
*/
protected void transformBones(SpriterKeyFrame currentFrame, SpriterKeyFrame nextFrame, float xOffset, float yOffset){
if(this.rootParent.getParent() != null) this.translateRoot();
else{
this.tempParent.setX(xOffset); this.tempParent.setY(yOffset);
this.tempParent.setAngle(this.angle);
this.tempParent.setScaleX(this.flipX);
this.tempParent.setScaleY(this.flipY);
}
this.setScale(this.scale);
if(!this.updateBones) return;
this.updateTransformedTempObjects(nextFrame.getBones(), this.tempBones2);
this.updateTempObjects(currentFrame.getBones(), this.nonTransformedTempBones);
float t = SpriterCalculator.getNormalizedTime(currentFrame.getTime(), nextFrame.getTime(), this.frame);
for (int i = 0; i < this.nonTransformedTempBones.length; i++) {
if(this.tempBones[i].active) this.tweenBone(this.nonTransformedTempBones[i], nextFrame.getBoneFor(this.nonTransformedTempBones[i]), i, t);
//else this.tweenBone(this.nonTransformedTempBones[i], this.animations.get(0).frames.get(0).getBoneFor(this.nonTransformedTempBones[i]), i, currentFrame.getTime(), nextFrame.getTime());
}
}
private void tweenObject(SpriterObject currentObject, SpriterObject nextObject, int i, float t){
DrawInstruction dI = this.instructions[i];
currentObject.copyValuesTo(this.tempObjects[i]);
SpriterAbstractObject parent = null;
if(!currentObject.isTransientObject()) {
this.tempObjects[i].setTimeline((nextObject != null) ? currentObject.getTimeline() : -1);
parent = (currentObject.hasParent()) ? this.tempBones[currentObject.getParentId()] : this.tempParent;
if(nextObject != null){
if(parent != this.tempParent){
if(!currentObject.getParent().equals(nextObject.getParent())){
nextObject = (SpriterObject) this.getTimelineObject(currentObject, this.tempObjects2);
SpriterCalculator.reTranslateRelative(parent, nextObject);
nextObject.setAngle(nextObject.getAngle()*this.flipX*this.flipY);
}
} else if(nextObject.hasParent()){
nextObject = (SpriterObject) this.getTimelineObject(currentObject, this.tempObjects2);
SpriterCalculator.reTranslateRelative(parent, nextObject);
nextObject.setAngle(nextObject.getAngle()*this.flipX*this.flipY);
}
if(this.tempObjects[i].active) this.interpolateSpriterObject(this.tempObjects[i], currentObject, nextObject, t);
}
this.moddedObjects[currentObject.getId()].modSpriterObject(this.tempObjects[i]);
if(this.transitionFixed) this.tempObjects[i].copyValuesTo(this.lastFrame.getObjects()[i]);
else this.tempObjects[i].copyValuesTo(this.lastTempFrame.getObjects()[i]);
}
else parent = this.tempParent;
if(!this.tempObjects[i].hasParent()){
this.tempObjects[i].setX(this.tempObjects[i].getX()+this.pivotX);
this.tempObjects[i].setY(this.tempObjects[i].getY()+this.pivotY);
}
this.translateRelative(this.tempObjects[i], parent);
if(this.moddedObjects[currentObject.getId()].getRef() != null) this.tempObjects[i].setRef(this.moddedObjects[currentObject.getId()].getRef());
this.tempObjects[i].copyValuesTo(dI);
this.setInstructionRef(dI, this.tempObjects[i], nextObject);
}
private void tweenBone(SpriterBone currentBone, SpriterBone nextBone, int i, float t){
currentBone.copyValuesTo(this.tempBones[i]);
this.tempBones[i].setTimeline((nextBone != null) ? currentBone.getTimeline() : -1);
SpriterAbstractObject parent = (this.tempBones[i].hasParent()) ? this.tempBones[this.tempBones[i].getParentId()]: this.tempParent;
if(nextBone != null){
if(parent != this.tempParent){
if(!currentBone.getParent().equals(nextBone.getParent())){
nextBone = (SpriterBone) this.getTimelineObject(currentBone, this.tempBones2);
SpriterCalculator.reTranslateRelative(parent, nextBone);
nextBone.setAngle(nextBone.getAngle()*this.flipX*this.flipY);
}
} else if(nextBone.hasParent()){
nextBone = (SpriterBone) this.getTimelineObject(currentBone, this.tempBones2);
SpriterCalculator.reTranslateRelative(parent, nextBone);
nextBone.setAngle(nextBone.getAngle()*this.flipX*this.flipY);
}
if(this.tempBones[i].active) this.interpolateAbstractObject(this.tempBones[i], currentBone, nextBone, t);
}
this.moddedBones[currentBone.getId()].modSpriterBone(this.tempBones[i]);
if(this.transitionFixed) this.tempBones[i].copyValuesTo(this.lastFrame.getBones()[i]);
else this.tempBones[i].copyValuesTo(this.lastTempFrame.getBones()[i]);
if(!this.tempBones[i].hasParent() || !this.moddedBones[currentBone.getId()].isActive()){
this.tempBones[i].setX(this.tempBones[i].getX()+this.pivotX);
this.tempBones[i].setY(this.tempBones[i].getY()+this.pivotY);
}
this.translateRelative(this.tempBones[i], parent);
}
private void updateTransformedTempObjects(SpriterAbstractObject[] source, SpriterAbstractObject[] target){
for(int i = 0; i< source.length; i++)
this.updateTransformedTempObject(source[i], target[i]);
}
private void updateTransformedTempObject(SpriterAbstractObject source, SpriterAbstractObject target){
source.copyValuesTo(target);
if(!target.hasParent()){
target.setX(target.getX()+this.pivotX);
target.setY(target.getY()+this.pivotY);
}
this.translateRelative(target, (target.hasParent()) ? this.tempBones2[target.getParentId()]: this.tempParent);
}
private void updateTempObjects(SpriterAbstractObject[] source, SpriterAbstractObject[] target){
for (int i = 0; i < source.length; i++) {
this.updateTempObject(source[i], target);
}
}
private void updateTempObject(SpriterAbstractObject source, SpriterAbstractObject[] target){
boolean found = false;
for(int j = 0; j < target.length && !found; j++){
if(source.getId() == target[j].getId()){
source.copyValuesTo(target[j]);
found = true;
}
}
}
private void translateRoot(){
this.rootParent.copyValuesTo(tempParent);
this.tempParent.setAngle(this.tempParent.getAngle()*this.flipX*this.flipY + this.rootParent.getParent().getAngle());
this.tempParent.setScaleX(this.tempParent.getScaleX() * this.rootParent.getParent().getScaleX());
this.tempParent.setScaleY(this.tempParent.getScaleY() * this.rootParent.getParent().getScaleY());
SpriterCalculator.translateRelative(this.rootParent.getParent(), this.tempParent);
}
protected SpriterAbstractObject getTimelineObject(SpriterAbstractObject object, SpriterAbstractObject[] objects){
for(int i = 0; i < objects.length; i++)
if(objects[i].getTimeline().equals(object.getTimeline())) return objects[i];
return null;
}
protected void interpolateAbstractObject(SpriterAbstractObject target, SpriterAbstractObject obj1, SpriterAbstractObject obj2, float t){
if(obj2 == null) return;
target.setX(obj1.curve.tween(obj1.getX(), obj2.getX(), t));
target.setY(obj1.curve.tween(obj1.getY(), obj2.getY(), t));
target.setScaleX(obj1.curve.tween(obj1.getScaleX(), obj2.getScaleX(), t));
target.setScaleY(obj1.curve.tween(obj1.getScaleY(), obj2.getScaleY(), t));
target.setAngle(obj1.curve.tweenAngle(obj1.getAngle(), obj2.getAngle(), t, obj1.getSpin()));
}
protected void interpolateSpriterObject(SpriterObject target, SpriterObject obj1, SpriterObject obj2, float t){
if(obj2 == null) return;
this.interpolateAbstractObject(target, obj1, obj2, t);
target.setPivotX((obj1.curve.tween(obj1.getPivotX(), obj2.getPivotX(), t)));
target.setPivotY((obj1.curve.tween(obj1.getPivotY(), obj2.getPivotY(), t)));
target.setAlpha((obj1.curve.tween(obj1.getAlpha(), obj2.getAlpha(), t)));
}
private void translateRelative(SpriterAbstractObject object, SpriterAbstractObject parent){
object.setAngle(object.getAngle()*this.flipX*this.flipY + parent.getAngle());
object.setScaleX(object.getScaleX() * parent.getScaleX());
object.setScaleY(object.getScaleY() * parent.getScaleY());
SpriterCalculator.translateRelative(parent, object);
}
/**
* Calculates the bounding box for the current running animation.
* Call this method after updating the spriter player.
* @param bone root to start at. Set null, to iterate through all objects.
*/
public void calcBoundingBox(SpriterBone bone){
if(bone == null) this.calcBoundingBoxForAll();
else{
bone.boundingBox.set(this.rect);
for(SpriterObject object: bone.getChildObjects()){
SpriterPoint[] points = this.tempObjects[object.getId()].getBoundingBox();
bone.boundingBox.left = Math.min(Math.min(Math.min(Math.min(points[0].x, points[1].x),points[2].x),points[3].x), bone.boundingBox.left);
bone.boundingBox.right = Math.max(Math.max(Math.max(Math.max(points[0].x, points[1].x),points[2].x),points[3].x), bone.boundingBox.right);
bone.boundingBox.top = Math.max(Math.max(Math.max(Math.max(points[0].y, points[1].y),points[2].y),points[3].y), bone.boundingBox.top);
bone.boundingBox.bottom = Math.min(Math.min(Math.min(Math.min(points[0].y, points[1].y),points[2].y),points[3].y), bone.boundingBox.bottom);
}
this.rect.set(bone.boundingBox);
for(SpriterBone child: bone.getChildBones()){
calcBoundingBox(child);
bone.boundingBox.set(child.boundingBox);
}
this.rect.set(bone.boundingBox);
}
this.rect.calculateSize();
}
private void calcBoundingBoxForAll(){
for(int i = 0; i < this.currenObjectsToDraw; i++){
SpriterPoint[] points = this.tempObjects[i].getBoundingBox();
this.rect.left = Math.min(Math.min(Math.min(Math.min(points[0].x, points[1].x),points[2].x),points[3].x), this.rect.left);
this.rect.right = Math.max(Math.max(Math.max(Math.max(points[0].x, points[1].x),points[2].x),points[3].x), this.rect.right);
this.rect.top = Math.max(Math.max(Math.max(Math.max(points[0].y, points[1].y),points[2].y),points[3].y), this.rect.top);
this.rect.bottom = Math.min(Math.min(Math.min(Math.min(points[0].y, points[1].y),points[2].y),points[3].y), this.rect.bottom);
}
}
/**
* @return array of moddable objects.
*/
public SpriterModObject[] getModdedObjects() {
return moddedObjects;
}
/**
* @return array of moddable bones.
*/
public SpriterModObject[] getModdedBones() {
return moddedBones;
}
/**
* Searches for the right index for a given object.
* @param object object to search at.
* @return right index for the mod object you want access to. -1 if not found.
*/
public int getModObjectIndexForObject(SpriterObject object){
for(int i = 0; i < this.tempObjects.length; i++)
if(this.tempObjects[i].equals(object))
return i;
return -1;
}
/**
* Searches for the right mod object for the given object.
* @param object object to search at.
* @return right mod object you want access to. Null if not found.
*/
public SpriterModObject getModObjectForObject(SpriterObject object){
try{
return this.moddedObjects[this.getModObjectIndexForObject(object)];
} catch(ArrayIndexOutOfBoundsException e){
return null;
}
}
/**
* Searches for the right mod object for the given name.
* @param name name to search for.
* @return right mod object you want access to. Null if not found.
*/
public SpriterModObject getModObjectByName(String name){
try{
return getModObjectForObject(this.getObjectByName(name));
} catch (Exception e){
System.err.println("Could not find object \""+name+"\"");
return null;
}
}
/**
* Searches for the right index for a given bone.
* @param bone bone to search at.
* @return right index for the mod bone you want access to. -1 if not found.
*/
public int getModBoneIndexForBone(SpriterBone bone){
for(int i = 0; i < this.tempObjects.length; i++)
if(this.tempBones[i].equals(bone))
return i;
return -1;
}
/**
* Searches for the right mod bone for the given bone.
* @param bone bone to search at.
* @return right mod bone you want access to. Null if not found.
*/
public SpriterModObject getModBoneForBone(SpriterBone bone){
try{
return this.moddedBones[this.getModBoneIndexForBone(bone)];
} catch(ArrayIndexOutOfBoundsException e){
return null;
}
}
/**
* Searches for the right mod bone for the given name.
* @param name name to search for.
* @return right mod bone you want access to. Null if not found.
*/
public SpriterModObject getModBoneByName(String name){
try{
return getModBoneForBone(this.getBoneByName(name));
} catch (Exception e){
System.err.println("Could not find bone \""+name+"\"");
return null;
}
}
/**
* Changes the current frame to the given one.
* @param frame the frame to set
*/
public void setFrame(long frame) {
this.frame = frame;
}
/**
* @return the current frame
*/
public long getFrame() {
return frame;
}
/**
* @param frameSpeed the frameSpeed to set. Higher value meens playback speed. frameSpeed == 0 means no playback speed.
*/
public void setFrameSpeed(int frameSpeed) {
this.frameSpeed = frameSpeed;
}
/**
* @return the current frameSpeed
*/
public int getFrameSpeed() {
return frameSpeed;
}
/**
* Flips this around the x-axis.
*/
public void flipX(){
this.flipX *=-1;
for(SpriterAbstractPlayer player: this.players)
player.flipX = this.flipX;
}
/**
* @return Indicates whether this is flipped around the x-axis or not. 1 means is not flipped, -1 is flipped.
*/
public int getFlipX(){
return this.flipX;
}
/**
* Flips this around the y-axis.
*/
public void flipY(){
this.flipY *=-1;
for(SpriterAbstractPlayer player: this.players)
player.flipY = this.flipY;
}
/**
* @return Indicates whether this is flipped around the y-axis or not. 1 means is not flipped, -1 is flipped.
*/
public float getFlipY() {
return this.flipY;
}
/**
* Changes the angle of this.
* @param angle in degrees to rotate all objects , angle = 0 means no rotation.
*/
public void setAngle(float angle){
this.angle = angle;
this.rootParent.setAngle(this.angle);
}
/**
* @return The current angle in degrees.
*/
public float getAngle(){
return this.angle;
}
/**
* @return the scale. 1 means not scale. 0.5 means half scale.
*/
public float getScale() {
return scale;
}
/**
* Scales this to the given value.
* @param scale the scale to set, scale = 1.0 normal scale.
*/
public void setScale(float scale) {
this.scale = scale;
this.rootParent.setScaleX(this.scale*this.flipX);
this.rootParent.setScaleY(this.scale*this.flipY);
this.tempParent.setScaleX(this.scale*this.flipX);
this.tempParent.setScaleY(this.scale*this.flipY);
}
/**
* Sets the center point of this. pivotX = 0, pivotY = 0 means the same rotation point as in the Spriter editor.
* @param pivotX
* @param pivotY
*/
public void setPivot(float pivotX, float pivotY){
this.pivotX = pivotX;
this.pivotY = pivotY;
}
/**
* Returns the x center coordinate of this.
* @return pivot x
*/
public float getPivotX(){
return this.pivotX;
}
/**
* Returns the y center coordinate of this.
* @return pivot y
*/
public float getPivotY(){
return this.pivotY;
}
/**
* @return Returns the current DrawInstruction array
*/
public DrawInstruction[] getDrawInstructions(){
return this.instructions;
}
/**
* Searches for the bone index with the given name and returns the right one
* @param name name of the bone.
* @return index of the bone if the given name was found, otherwise it returns -1
*/
public int getBoneIndexByName(String name){
for(int i = 0; i < this.tempBones.length; i++)
if(name.equals(this.tempBones[i].getName())) return i;
return -1;
}
/**
* Searches for the object index with the given name and returns the right one
* @param name name of the object.
* @return index of the object if the given name was found, otherwise it returns -1
*/
public int getObjectIndexByName(String name){
for(int i = 0; i < this.tempObjects.length; i++)
if(name.equals(this.tempObjects[i].getName())) return i;
return -1;
}
/**
* Searches for the bone index with the given name and returns the right one
* @param name name of the bone.
* @return index of the bone if the given name was found, otherwise it returns null
*/
public SpriterBone getBoneByName(String name){
int i = this.getBoneIndexByName(name);
if(i != -1) return this.getRuntimeBones()[i];
else return null;
}
/**
* Searches for the object index with the given name and returns the right one
* @param name name of the object.
* @return index of the object if the given name was found, otherwise it returns null
*/
public SpriterObject getObjectByName(String name){
int i = this.getObjectIndexByName(name);
if(i != -1) return this.getRuntimeObjects()[i];
else return null;
}
/**
* @return the current bones which where interpolated for the current animation. Bones are not flipped.
*/
public SpriterBone[] getRuntimeBones(){
return this.tempBones;
}
/**
* @return the current objects which where interpolated for the current animation. Objects are flipped.
*/
public SpriterObject[] getRuntimeObjects(){
return this.tempObjects;
}
/**
* @return the rootParent
*/
public SpriterAbstractObject getRootParent() {
return rootParent;
}
/**
* @param rootParent the rootParent to set
*/
void setRootParent(SpriterAbstractObject rootParent) {
this.rootParent = rootParent;
}
/**
* @param rootParent the rootParent to set
*/
void changeRootParent(SpriterAbstractObject rootParent) {
this.rootParent.setParent(rootParent);
}
/**
* @return the current z-index. This gets relevant if you attach a #SpriterAbstractPlayer to another.
*/
public int getZIndex(){
return this.zIndex;
}
/**
* Meant to change the drawing order if this player is held by another #SpriterAbstractPlayer.
* @param zIndex Higher means that the object will be drawn later.
*/
public void setZIndex(int zIndex){
this.zIndex = zIndex;
}
/**
* Attaches a given player to this.
* @param player indicates the player which has to be attached.
* @param root indicates the object the attached player has to follow.
* Set to {@link #getRootParent()} to attach the player to the same position as this player.
*/
public void attachPlayer(SpriterAbstractPlayer player, SpriterAbstractObject root){
this.players.add(player);
player.changeRootParent(root);
}
/**
* Removes the given player from this one.
* @param player indicates the player which has to be removed.
*/
public void removePlayer(SpriterAbstractPlayer player){
this.players.remove(player);
player.changeRootParent(null);
}
public List getAttachedPlayers(){
return this.players;
}
/**
* Indicates whether the given player is attached to this or not.
* @param player the player to ask after.
* @return true if player is attached or not.
*/
public boolean containsPlayer(SpriterAbstractPlayer player){
return this.players.contains(player);
}
public void updateAbstractObject(SpriterAbstractObject object){
if(object.hasParent()){
SpriterAbstractObject obj = (object instanceof SpriterBone) ? this.lastFrame.getBones()[object.getId()] : this.lastFrame.getObjects()[object.getId()];
SpriterCalculator.translateRelative(this.tempBones[object.getParentId()], obj.getX(), obj.getY(), object);
}
}
/**
* Transforms the given bone with relative information to its parent
* @param bone
*/
/*public void updateRecursively(SpriterBone bone){
this.updateBone(bone);
for(SpriterBone child: bone.getChildBones())
this.updateRecursively(this.tempBones[child.getId()]);
}*/
public SpriterRectangle getBoundingBox(){
return this.rect;
}
public int getObjectsToDraw(){
return this.currenObjectsToDraw;
}
public int getBonesToAnimate(){
return this.currentBonesToAnimate;
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy