NAME

expire_image - Schedule the image for deletion

SYNOPSIS

nil
expire_image( vid, timetolive )

DESCRIPTION

For some images, we want to specify not only that it should be deleted but when (often in conjunction with how the transformation chain is currently running) without tracking time in other means. This function allows you to specify how many ticks the image has left to live.

NOTES

1: for n : 0 <= n < 1, n will be forced to one tick. the timer to the new value.

EXAMPLE

function expire_image0()
      a = fill_surface(32, 32, 255, 0, 0);
      expire_image(a, 100);
end

MISUSE

function expire_image0()
      expire_image(WORLDID, 10);
end

MISUSE

function expire_image1()
      a = fill_surface(32, 32, 0, 255, 0);
      expire_image(a, -1);
end

MISUSE

function expire_image2()
      a = fill_surface(32, 32, 0, 0, 255);
      expire_image(a, "deadline");
end