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.