Camera Commands

Camera manipulation commands follow the same concept as @setenv where a single object can exclusively lock control of the camera.

Important: while existing camera commands that don't fit the setcam_XXX family will currently (silently) translate to their new counterparts this is only a courtesy and these synonyms will be removed in a future release. Please use only @setcam_XXX in any of your products.

While we don't anticipate major changes the final implementation and behaviour of these commands isn't set in stone and subject to your feedback.

@setcam=<n|y>

Only one object can hold this behaviour at a given time (debug output will show "locked" as the failure message on subsequent attempts). When an object holds the lock, all camera commands from all other objects will be ignored; when the object releases the lock all other camera behaviours will be restored.