(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'.

See Also