delete_image

declaration:

function delete_image(vid); => nil

Deletes a VID and all its associated resources. VIDs in Framesets and linked VIDs will be deleted unless MASK_LIVING has been cleared.

caveats:

Calling delete_image on WORLDID, BADID or a number that isn't mapped to a VID, will forcible fail and shut down the engine, writing out the erronous file:line as the shutdown message. This is on purpose in accordance with the fail early debugging principle.

Calling delete_image on an image that is loaded asynchronously will turn it into an asynchronous load then a delete, as a measure to avoid file-descriptor leaks.

related functions:

[expire_image]