[ prev :: next :: up ] libggiblt-current (3)

(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 :p:`handles` in array form. The parameter :p:`numhandles` designates the number of handles in the array.

System Message: ERROR/3 (../lowlevel/libblt/doc/libggiblt.txt, line 386); backlink

Unknown interpreted text role "p".

System Message: ERROR/3 (../lowlevel/libblt/doc/libggiblt.txt, line 386); backlink

Unknown interpreted text role "p".

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 :p:`carb` and :p:`tank`. The structure returned contains a private LibGGIBlt structure stored in the src1 member, which must not be altered.

System Message: ERROR/3 (../lowlevel/libblt/doc/libggiblt.txt, line 396); backlink

Unknown interpreted text role "p".

System Message: ERROR/3 (../lowlevel/libblt/doc/libggiblt.txt, line 396); backlink

Unknown interpreted text role "p".

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

:man:`ggiBltCreate(3)`, :man:`ggiBltCreateBob(3)`, :man:`ggiBltAdd(3)`

System Message: ERROR/3 (../lowlevel/libblt/doc/libggiblt.txt, line 427); backlink

Unknown interpreted text role "man".

System Message: ERROR/3 (../lowlevel/libblt/doc/libggiblt.txt, line 427); backlink

Unknown interpreted text role "man".

System Message: ERROR/3 (../lowlevel/libblt/doc/libggiblt.txt, line 427); backlink

Unknown interpreted text role "man".
 
[ prev :: next :: up ] libggiblt-current (3)
2006/11/09 16:51:06