expire_image

declaration:

    function expire_image(vid, nticks);

After the non-negative nitcks number of logical timesteps have elapsed, the vid will be deleted. This will clear any MASK_LIVING, and can be cancelled by resetting that mask.

related functions:
[delete_image]

caveats:
same as [delete_image], an expire_image with 0 or NOW as nticks will be mapped to a [delete_image] call.