Represent the data inside an overlay with a LibBuf object
Name
ggiOvl2Buf : Represent the data inside an overlay with a LibBuf object
Synopsis
#include <ggi/ovl.h> #include <ggi/buf.h> void *ggiOvl2Buf(ggiOvl_t ovl);
Description
ggiOvl2Buf creates a LibBuf object corresponding to the LibGGIOvl object ovl. In order to keep the libraries separate on the API level, you must cast the returned void* pointer to a LibGGIBuf ggiBuf_t yourself. For resources with data buffers, such as sprite bitmaps, the LibBuf_t object can be used as a lightweight mechanism (vs. opening a new visual with ggiOvl2Vis(3)) to load data to/from the data buffer, or to create ancillary buffers for the overlay. For certain other resources, a LibGGIBuf object may be useful for use-time (vs resource creation-time) configuration of Alpha blending rules, and other such features not accessible through ggiOvlSetFlags(3).
Return value
ggiOvl2Buf returns a void* pointer which must be cast to type ggiBuf_t, or NULL if an error occured.