ggiBltTie

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_source_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.

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 LibBlt 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.

Return value

ggiBltTie returns a newly allocated ggiBlt_t object. ggiBltTieBob returns a newly allocated ggiBlt_source_t object with a private LibBlt 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.

See Also

ggiBltCreate(3ggi), ggiBltCreateBob(3ggi), ggiBltAdd(3ggi)