Activate an allocated graphics overlay resource
Name
ggiOvlTie, ggiOvlUntie : Activate an allocated graphics overlay resource
Synopsis
#include <ggi/ovl.h> ggiOvl_t ggiOvlTie(ggi_visual_t vis, ggiGA_resource_handle handle_motor, ggiGA_resource_handle handle_carb, ggiGA_resource_handle handle_tank); int ggiOvlUntie(ggiOvl_t *ovl);
Description
ggiOvlTie creates a ggiOvl_t object from approved resource handles.
After creation, the resource will be hidden, any color lookup tables in the object will have all colors set to black, it will be moved to the lowest slot in any priority group in which it may be a member, and any pixel data which the object may contain will be in an undefined state.
Return value
ggiOvlTie returns a newly allocated ggiOvl_t object, or NULL on failure.
Examples
Tie a resource using the return values of ggiOvlAdd:
ggiGASet(vis, reqlist, &reslist); /* get resources from LibGAlloc */ m = ggiGAHandle(vis, reslist, reqlist, m); c = ggiGAHandle(vis, reslist, reqlist, c); t1 = ggiGAHandle(vis, reslist, reqlist, t1); overlay = ggiOvlTie(vis, m, c, t1);