NAME

image_mask_set - Set a status flag on the specified object

SYNOPSIS

nil
image_mask_set( vid, maskval )

DESCRIPTION

Images that are linked to eachother via link_image gets a number of its attributes redefined to be relative the the parent it is linked again. At times, not all attributes are relevant to inherit, and these can be controlled through the image_mask_ set of functions.

The currently valid maskvals are:

MASK_UNPICKABLE : if set, the image will be ignored for picking operations

MASK_LIVING : (default) if set, the image will be deleted when the parent expires.

MASK_POSITION : (default) image coordinate system origo

MASK_OPACITY : (default) image opacity

MASK_ROTATION : (default) image rotation angle

MASK_SCALE : (default) reserved, no-op

MASK_MAPPING : if set, the image will use the texture coordinate set of its (non-world) parent

NOTES

1: an invalid maskval is considered a terminal state transition.

EXAMPLE

function image_mask_set0()
      a = fill_surface(32, 32, 255, 0, 0);
      b = instance_image(a);
      show_image({a, b});
      move_image(a, 32, 32);
      rotate_image(a, 120);
      image_mask_clearall(b);
      image_mask_set(b, MASK_ORIENTATION);
end

MISUSE