Set or get the texture index of a BOB or other LibBlt data source
Name
ggiBltSetSourceIdx, ggiBltGetSourceIdx : Set or get the texture index of a BOB or other LibBlt data source
Synopsis
#include <ggi/blt.h> int ggiBltSetSourceIdx(ggiBlt_source_t bob, int idx); int ggiBltGetSourceIdx(ggiBlt_source_t bob, int idx);
Description
ggiBltSetSourceIdx and ggiBltGetSourceIdx set and read, respectively, the texture index of a BOB or other LibBlt data source, which is imparted to a blit operation when a BOB is placed into a Blt with one of the ggiBltPut* functions. Data is taken from the managed area with the given index when corresponding precompiled operation is sent to the target.
Note: an alternate form is planned which will use a linear address into the managed area, as well.
Once imparted through a ggiBltPut* function, calling these functions again on this BOB with a different value will not alter the the blit's precompiled operation, only the texture to be imparted to future operations.
Return value
All functions 0 for OK or a negative value on failure.