Add animation offset

Author: bitbrain

Diff for: 2d/src/main/java/de/bitbrain/braingdx/graphics/animation/AnimationFrames.java

@@ -15,15 +15,21 @@ public enum Direction {
    private int frames;
    private float duration;
    private int resetIndex;
+   private float offset;
 
-   private AnimationFrames(int originX, int originY, Direction direction, Animation.PlayMode playMode, int frames, float duration, int resetIndex) {
+   private AnimationFrames(int originX, int originY, Direction direction, Animation.PlayMode playMode, int frames, float duration, int resetIndex, float offset) {
       this.originX = originX;
       this.originY = originY;
       this.direction = direction;
       this.playMode = playMode;
       this.frames = frames;
       this.duration = duration;
       this.resetIndex = resetIndex;
+      this.offset = offset;
+   }
+
+   public float getOffset() {
+      return offset;
    }
 
    public void setOriginX(int originX) {
@@ -94,6 +100,7 @@ public static class AnimationFramesBuilder {
       private int frames = 1;
       private float duration = 1f;
       private int resetIndex = 0;
+      private float offset = 0;
 
       private AnimationFramesBuilder() {
 
@@ -130,6 +137,19 @@ public AnimationFramesBuilder resetIndex(int resetIndex) {
          return this;
       }
 
+      public AnimationFramesBuilder offset(float offsetInMilliseconds) {
+         this.offset = offsetInMilliseconds;
+         return this;
+      }
+
+      public AnimationFramesBuilder randomOffset() {
+         if (frames > 0) {
+            return this.offset((float) (Math.random() * (this.duration * this.frames)));
+         } else {
+            return this.offset((float) (Math.random() * (this.duration * 8f)));
+         }
+      }
+
       public AnimationFrames build() {
          return new AnimationFrames(
                originX,
@@ -138,7 +158,8 @@ public AnimationFrames build() {
                playMode,
                frames,
                duration,
-               resetIndex
+               resetIndex,
+               offset
          );
       }
 

Diff for: 2d/src/main/java/de/bitbrain/braingdx/graphics/animation/AnimationRenderer.java

@@ -112,10 +112,16 @@ public AnimationRenderer enabled(boolean enabled) {
    private TextureRegion retrieveRegionFor(GameObject object, float delta) {
       Object currentAnimationType = animationTypeResolver.getAnimationType(object);
       AnimationState state = object.getOrSetAttribute(AnimationState.class, animationStateFactory);
-      state.stateTime += delta;
       Animation<TextureRegion> animation = animationCache.getAnimation(currentAnimationType);
-      boolean animationEnabled = animationEnabler.isEnabledFor(object);
       AnimationFrames frames = config.getFrames(currentAnimationType);
+      if (state.stateTime == 0f) {
+         state.stateTime = frames.getOffset();
+      }
+      state.stateTime += delta;
+      boolean animationEnabled = animationEnabler.isEnabledFor(object);
+      if (!animationEnabled) {
+         state.stateTime = frames.getOffset();
+      }
       return animation.getKeyFrame(animationEnabled ? state.stateTime : frames.getDuration() * frames.getResetIndex());
    }
 

Diff for: CHANGELOG.md

@@ -1,3 +1,7 @@
+# Version 0.6.27
+
+* improve animation rendering and add offset option
+
 # Version 0.6.26
 
 * add fps and particle count metrics