NAME

force_image_blend - Control image blend behaviour

SYNOPSIS

nil
force_image_blend( vid:dst )
force_image_blend( vid:dst, int:mode )

DESCRIPTION

There are a number of controls for adjusting how overlapping objects that are translucent or has transparent contents described by an alpha color channel are supposed to combine. This function can be used to change that behavior. If no mode is set, the system default will be set. Other blend-modes are: BLEND_NORMAL (disable blending if object opacity is marked as opaque) BLEND_ADD (one, one: additive blending, rgb channels will be combined) BLEND_SUB (one: dst will be subtracted based on one-src alpha), BLEND_MUL (dst-color, one-src alpha), BLEND_PREMULTIPLIED (one, one-src alpha: the source object has its alpha values pre-multiplied into the color channels)

NOTES

1: The default can be changed by calling switch_default_blendmode .

EXAMPLE

function force_image_blend0()
      a = fill_surface(32, 32, 255, 0, 0);
      blend_image(a, 0.5);
      force_image_blend(a, BLEND_ADD);
end

MISUSE

function force_image_blend0()
      force_image_blend(BADID, BLEND_NORMAL);
end

MISUSE

function force_image_blend1()
      a = fill_surface(32, 32, 255, 0, 0);
      force_image_blend(a, -10);
end