ggiOvlTie, ggiOvlUntie : Activate an allocated graphics overlay resource
#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);
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.
ggiOvlTie returns a newly allocated ggiOvl_t object, or NULL on failure.
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);