NAME

SYNOPSIS

DESCRIPTION

This function covers two use-cases.

The first use case is to force an out-of-loop update of the specified target in 'manual' update mode (rate=0). By default this will always trigger a render pass. If the second argument is set to false, then the update will only be forced if the pipeline is actually dirty.

The second use case is to change the refresh and readback rates for the specified rendertarget. This can be used as an optimization to temporarily disable rendertargets without going through the process of rebuilding and migrating between rendertargets.

Any pending counters/timers for frame or tick/based automatic updates will be reset, and the update includes synchronizing with readback in the case of calctargets and recordtargets.

NOTES

1

Trying to call this function on a VID that references an object that is not flagged as a rendertarget is a terminal state transition.

2

If a newrate is set, the rendertarget will not be updated directly. If that behaviour is desired, call the function again without the newrate argument.

3

EXAMPLE

function rendertarget_forceupdate0()
      local dst = alloc_surface(320, 200);
      local a = color_surface(64, 64, 0, 255, 0);
      show_image(a);
      rotate_image(a, 45);
      define_rendertarget(dst, {a});
      rendertarget_forceupdate(dst);
      save_screenshot("test.png", FORMAT_PNG, dst);
      delete_image(dst);
end

MISUSE

function rendertarget_forceupdate0()
      local a = fill_surface(32, 32, 255, 0, 0, 0);
      rendertarget_forceupdate(a);
end

SEE ALSO: