@camera pushes or pulls the whole framing to a new position, zoom level, and focal point in one move. Reach for it whenever you want to punch in on a face, pull back to reveal a room, or drift the frame to follow the emotional weight of a line - x and y reposition the frame, scale controls how tight or wide it reads, and focus_x/focus_y let you bias where the eye settles within that framing.

Because pan, zoom, and focal point all ride the same clock and curve, the move reads as one continuous gesture rather than three separate adjustments fighting each other. Set duration to 0 when you need an instant hard cut to a new framing, such as snapping into a flashback or reacting to a jump scare.

Pick curve to match the emotional register of the move: decel for a settling push-in that lands on a line, overshoot or bounce for something more playful or jarring, elastic for a comedic wobble, and plain linear or slide when you just need a clean, unremarkable reposition. Leaving target empty moves the whole frame, which is what you want for establishing shots or scene-wide reveals; setting target to a sprite tag instead keeps the camera locked onto that character as they move, which is the better choice for following someone across the stage without hand-tuning x and y yourself.

Use wait=false when you want the camera drift to run underneath dialogue or another effect instead of blocking the script - stacking a slow @camera with wait=false alongside a @shake or a line of say gives you layered motion without extra bookkeeping. Keep in mind repeated @camera calls don't reset to center automatically; each new call moves relative to the current framing, so if you've zoomed and panned in, a later call meant to return to the establishing shot needs its own explicit x=0, y=0, scale=1 rather than assuming a clean slate.