image_transform_cycle(3)

✨ NAME ✨

okay so bestie, welcome to the image_transform_cycle(3) page — it’s part of the Arcan Lua API and lives in the image manual. 💖 This one is all about toggling transform cycles ON/OFF. slay.

🌸 SYNOPSIS 🌸

nil
image_transform_cycle( vid, toggle )

🎀 DESCRIPTION 🎀

So here’s the vibe: by default, when an object has one or several transforms queued up, all tracking of a transform state gets dropped after that transform has been completed. periodt.

This function changes that behavior — instead of dropping the state, it requeues the transform at the end of the chain, which loops the animation. 🔁✨

🦋 NOTES 🦋

1. Fair warning, bestie: since this makes a lot of the object state variable, this function has a severe impact on the ability to cache previous states — and because of that, it can be very expensive. 💀 like, expensive expensive.

💅 EXAMPLE 💅

function image_transform_cycle0()
      a = fill_surface(32, 32, 255, 0, 0);
      image_transform_cycle(a, 1);
      move_image(a, 100, 100, 100);
      rotate_image(a, 100, 100);
      move_image(a, 10, 10, 100);
      scale_image(a, 64, 64, 25);
      scale_image(a, 32, 32, 25);
end

---

that’s the whole page, bb 🫶 — source/version vibes are from the image manual, dated October 2026, and you’re reading image_transform_cycle(3). 💖✨🎀