fill_surface

declaration:

    function fill_surface( width, height, r, g, b, [storewidth], [storeheight] ) => VID or BADID

Create a solid-colour vid with the visual dimensions of width, height (non-negative) and the values of r, g, b into the channels (alpha is always 1).

r, g, b should all be within the 0 .. 255 range.

storewidth, storeheight are useful for render- to- texture scenarios or round-robins of frameserver framesets.

Will only ever return BADID if out of memory or VIDs in the current context.

related functions:
[random_surface]