ggiOvlTie

Name

ggiOvlTie -- Activate an allocated graphics overlay resource

Synopsis

#include <ggi/ovl.h>

ggiOvl_t ggiOvlTie(ggi_visual vis ggiGA_resource_handle handle_motor ggiGA_resource_handle handle_tank ggiGA_resource_handle handle_carb);

Description

ggiOvlTie creates a ggiOvl_t object from approved resource handles.

Return value

ggiOvlTie returns a newly allocated ggiOvl_t object, or NULL on failure.

Examples

Example 1. 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);

See Also

ggiOvlAdd(3ggi)