src/main/java/com/hbm/render/anim/BusAnimation.java - master - Belyash5/Flu

src/main/java/com/hbm/render/anim/BusAnimation.java
95 строк3 KB
Bob
trenchie: the return
17 апр 2025, 22:11
17 апр 2025, 22:11eeefb0e
package com.hbm.render.anim;

import java.util.HashMap;
import java.util.Map.Entry;

//a """simple""" implementation of an animation system
//it's the first thing i came up with and i suppose it's relatively simple but
//it's probably not since i suck at everything
//i could have just used collada XML animations but where's the fun in that?
public class BusAnimation {
	
	//"buses" with one S since it's not a vehicle
	private final HashMap<String, BusAnimationSequence> animationBuses = new HashMap<String, BusAnimationSequence>();
	//multiples buses exist simultaneously and start with 0.
	//a bus has one authority, i.e. the translation of a single part of a model or the rotation of the entire thing.
	//imagine the busses being film strips that hang from the ceiling, with the tape player
	//rolling down, picking up images from all tapes and combining them into a movie.
	
	//0 by default, will always equal the duration of the longest BusAnimationSequence
	private int totalTime = 0;
	
	/**
	 * Adds a bus to the animation
	 * If an object has several moving parts, each transformation type of each seperat bus should have its own bus
	 * Unless you use one bus for several things because the animation is identical, that's ok too
	 * @param name of the bus being added
	 * @param bus the bus in question
	 * @return
	 */
	public BusAnimation addBus(String name, BusAnimationSequence bus) {
		
		animationBuses.put(name, bus);
		
		int duration = bus.getTotalTime();
		
		if(duration > totalTime)
			totalTime = duration;
		
		return this;
	}
	
	/**
	 * In case there is keyframes being added to sequences in post, this method allows the totalTime
	 * to be updated.
	 */
	public void updateTime() {
		
		for(Entry<String, BusAnimationSequence> sequence : animationBuses.entrySet()) {
			
			int time = sequence.getValue().getTotalTime();
			
			if(time > totalTime)
				totalTime = time;
		}
	}
	
	/**
	 * Gets a bus from the specified name. Usually not something you want to do
	 * @param name
	 * @param bus
	 * @return
	 */
	public BusAnimationSequence getBus(String name) {
		return animationBuses.get(name);
	}
	
	/**
	 * Multiplies all keyframe durations by the supplied double. Numbers below 1 make the animation play faster.
	 * @param mult
	 */
	public void setTimeMult(double mult) {
		for(Entry<String, BusAnimationSequence> sequence : animationBuses.entrySet()) {
			sequence.getValue().multiplyTime(mult);
		}
	}
	
	/**
	 * Gets the state of a bus at a specified time
	 * @param name the name of the bus in question
	 * @param millis the elapsed time since the animation started in milliseconds
	 * @return
	 */
	public double[] getTimedTransformation(String name, int millis) {
		
		if(this.animationBuses.containsKey(name))
			return animationBuses.get(name).getTransformation(millis);
		
		return null;
	}
	
	public int getDuration() {
		return totalTime;
	}

}