Function SetAdvancedSpriteSequence

TombEngine/Game/effects/effects.cpp:197–274

}

void SetAdvancedSpriteSequence(Particle& particle, GAME_OBJECT_ID objectID,	ParticleAnimType animationType, float frameRate)
{
	// Ensure valid lifespan
	if (particle.life <= 0)
	{
		particle.on = false;
		ParticleDynamics[particle.dynamic].On = false;
		return;
	}

	// Calculate particle's age and normalized progress
	float particleAge = particle.sLife - particle.life;  // Elapsed time since spawn
	float normalizedAge = particleAge / particle.sLife;  // Progress as a fraction [0.0, 1.0]

	// Retrieve sprite sequence information
	//int firstFrame = Objects[objectID].meshIndex;          // Starting sprite index
	int totalFrames = -Objects[objectID].nmeshes;          // Total frames (assuming nmeshes is negative)
	if (totalFrames <= 0)
	{
		particle.SpriteSeqID = objectID;
		particle.SpriteID = 0;  // Default to the first frame if no valid frames exist
		return;
	}

	particle.SpriteSeqID = objectID;

	// Handle animation modes
	switch (animationType)
	{
	case ParticleAnimType::Loop:  // Frames loop sequentially
	{
		float frameDuration = frameRate > 0 ? 1.0f / frameRate : 1.0f / totalFrames;  // Duration per frame
		int currentFrame = (int)(particleAge / frameDuration) % totalFrames;  // Wrap frames
		particle.SpriteID = currentFrame;
		break;
	}

	case ParticleAnimType::OneShot:  // Frames play once, then freeze on the last frame
	{
		float totalDuration = frameRate > 0 ? totalFrames / frameRate : particle.sLife;
		int currentFrame = (int)(particleAge / (totalDuration / totalFrames));
		if (currentFrame >= totalFrames)
			currentFrame = totalFrames - 1;  // Clamp to the last frame
		particle.SpriteID = currentFrame;
		break;
	}

	case ParticleAnimType::BackAndForth:  // Frames go forward and then backward
	{
		float frameDuration = frameRate > 0 ? 1.0f / frameRate : 1.0f / totalFrames;
		int totalFrameSteps = totalFrames * 2 - 2;  // Forward and backward frames (avoiding double-count of last frame)
		int step = (int)(particleAge / frameDuration) % totalFrameSteps;
		int currentFrame = step < totalFrames ? step : totalFrames - (step - totalFrames) - 1;
		particle.SpriteID = currentFrame;
		break;
	}

	case ParticleAnimType::LifetimeSpread:  // Distribute all frames evenly over lifetime