There is a big list of macros defined in raptor that help when it comes to positioning (especially with camera movements), active viewports, and different sprite offsets, scales, etc.

They are grouped in three major sections: VIEW macros, SELF macros and CAM macros (for the camera).

Let's take a closer look at each of those groups.

These can be used inside objects (self must be an object instance).
NOTE: All SELF macros respect the sprite x/y offset and deliver ready-to-use values!

These can be used inside objects (self must be an object instance).
NOTE: These macros behave identically to the SELF_* macros above, but they deliver their values from the GUI layer coordinates and also take UI_SCALE into account.

If you looked closely at the code of the macros above, you might have recognized the CAM_INDEX and VIEWPORT_INDEX macros used in some of them, but those are never declared here.
This is because they are not macros -- they are global variables which you can modify.

There are two functions available that help, if you have more than one camera and/or viewport active.
You do not need to remember the old values when switching the camera or the viewport.

This function activates another camera and/or viewport index. After calling this, all the macros above deliver the values of the now active camera/viewport.
Both parameters are optional and default to 0.

After you are finished with your calculations for another camera/viewport, simply call this function to restore the index values that have been active before.