NAME

null_surface - Create a minimalistic video object.

SYNOPSIS

vid
null_surface( startw, starth )

DESCRIPTION

Null surfaces creates a normal textured video object that lacks a backing store and will therefore not be rendered in the normal draw pass, although it can be used for clipping operations. It is primarily used as an intermediate stage before using image_sharestorage to share the backing storage between two objects. The null_sueface is also useful as a property anchor for creating object hierarchies.

NOTES

1

intial starting dimensions still need to be specified in order for other lookup functions e.g. image_surface_initial_properties to work properly. dependencies

EXAMPLE

function null_surface0()


      a = null_surface(32, 32);


      b = fill_surface(32, 32, 255, 0, 0);


      show_image(b);


      link_image(b, a);


      moev_image(a, 100, 100, 100);


      blend_image(a, 1.0, 100);
end

MISUSE

function null_surface0()


      a = null_surface();


      a = null_surface(-1, -1);
end

SEE ALSO:

fill_surface(3) image_sharestorage(3)