max_current_image_order

declaration:

max_current_image_order() => orderv

Sweeps through the current VID context, looking for the highest order value. This function is primarily used to push an object to the front in situations where you don't have predefined layers (e.g. background has order 0, sprites order 1, etc.)

The included support scripts use this function frequently.

related functions:
[order_image]

caveats:
There is a finite upper-lower limit to order (0 <= order < INTMAX_t).
The reason for it being signed is that internally, 3D objects use an inverse negative order.