get_graphics_batch_limit


unsigned get_graphics_batch_limit()

This function obtains the number of calls that may be accumulated in the graphics batch of the calling thread.

Return

unsigned

The batch limit of the thread.

Notes

Only graphics function calls that return a boolean value (bool) may be accumulated. When a function is batched in this manner, the call returns true. Calls other than one that returns a boolean value cause the batch to be immediately flushed. The actual return code for batched functions that fail is only reported when the function flush_graphics is called. When the batch limit is reached, the accumulated graphics calls are flushed to the device. Setting a batch limit of 1 disables graphics batching. graphics batching applies to each thread separately.