NAME

valid_vid - Check if vid matches a valid object or not, also accepts NULL/BADID arguments.

SYNOPSIS

true or false
valid_vid(

vid, type )

DESCRIPTION

Due to the design decision to use a numerical type to reference the internal engine type most visible entities, a number of situations arise where one might need to test if a specific numeric value maps to a corresponding engine object before calling some functions that require a valid VID or even a valid VID that is also connected to a frameserver or other secondary processing types.

NOTES

1: Possible values for type are TYPE_FRAMESERVER and TYPE_ 3 DOBJECT . requirement

EXAMPLE

function valid_vid0()
      a = fill_surface(32, 32, 255, 0, 0, 0);
      print(valid_vid(a));
      print(valid_vid(NULL));
      print(valid_vid(BADID));
end