(Un)wrap an approved LibGAlloc resource handle in blit or bob object
Name
ggiBltTie, ggiBltUnTie, ggiBltTieBob, ggiBltUnTieBob : (Un)wrap an approved LibGAlloc resource handle in blit or bob object
Synopsis
#include <ggi/blt.h> ggiBlt_t ggiBltTie(ggiGA_resource_handle *handles, int numhandles); int ggiBltUntie(ggiBlt_t *blt); ggiBlt_t ggiBltTieBob(ggiGA_resource_handle *carb, ggiGA_resource_handle *tank); int ggiBltUntieBob(ggiBlt_source_t *bob);
Description
ggiBltTie creates a ggiBlt_t object from a set of approved LibGAlloc resource handles, passed via the parameter handles in array form. The parameter numhandles designates the number of handles in the array.
ggiBltUnTie destroys a ggiBlt_t object, but does not release resources allocated via LibGAlloc. To entirely release all resources, use the function ggiBltDestroy(3).
ggiBltTieBob creates a ggiBlt_source_t object from a set of approved LibGAlloc resource handles, passed via the parameters carb and tank. The structure returned contains a private LibGGIBlt structure stored in the src1 member, which must not be altered.
ggiBltUnTieBob destroys a ggiBlt_source_t object, but does not release resources allocated via LibGAlloc. To entirely release all resources, use the function ggiBltDestroyBob(3).
Return value
ggiBltTie returns a newly allocated ggiBlt_t object.
ggiBltTieBob returns a newly allocated ggiBlt_source_t object with a private LibGGIBlt data structure stored in the src1 member, which must not be altered.
ggiBltTie and ggiBltTieBob return NULL on failure.
Functions ggiBltUntie and ggiBltUntieBob return 0 (GGI_OK) if successful, or a negative error code on failure, and set the proferred handle to 'NULL'.