NAME

SYNOPSIS

DESCRIPTION

rendertarget specifies the attachment point, source refers to the object that should be attached or detached and detach_state determines if the primary attachment should be reassigned ( RENDERTARGET_DETACH ) or kept ( RENDERTARGET_NODETACH ). Only WORLDID or a vid that has been previously flagged as a rendertarget (using define_rendertarget or define_calctarget or define_recordtarget ) are valid values for rendertraget .

NOTES

1

Relative properties (scale, position etc.) are all defined against the current primary rendertarget and are not recalculated on attach/detach operations. The common pattern to handle objects that should have the same storage but live inside different rendertargets is to use null_surface to create a new container, image_sharestorage to make sure source and new object has the same backing store and then finally

rendertarget_attach the new object with RENDERTARGET_DETACH .

2

3

Deleting an object also implies detaching it from all rendertargets.

4

A rendertarget cannot be attached to itself.

5

Objects that have been flagged as persistant cannot be part of other rendertargets.

EXAMPLE

function rendertarget_attach0()
      local rtgt = alloc_surface(VRESW, VRESH);
      resize_image(rtgt, 200, 200);
      local obj_a = color_surface(32, 32, 0, 255, 0);
      show_image({rtgt, obj_a});
      define_rendertarget(rtgt, {obj_a});
      local new_obj = color_surface(64, 64, 255, 0, 0);
      show_image(new_obj);
      move_image(new_obj, VRESW * 0.5, VRESH * 0.5);
      rendertarget_attach(rtgt, new_obj, RENDERTARGET_NODETACH);
end

SEE ALSO: