Sets a number of colors in the 3DO system's palette.

Err SetScreenColors (Item screenItem,uint32 *entries,int32 count)

This call sets a number of colors in the palette of the screen specified by the screenItem argument. The entries argument points to an array of packed color values, each containing an index and individual red, green, and blue components. The number of entries is specified by the count argument.

Each of the four components in each entry's argument consists of 1 byte of the 4-byte word. The index is the high-order byte, followed by bytes of red, green, and blue, with the blue value in the low-order byte. The entries argument can be constructed using the MakeCLUTColorEntry() macro.

• screenItem Item number of a screen structure.

• entries Pointer to an array of 32-bit color entries, each of which comprises an index, a red, a green, and a blue value.

• count Number of entries in the color array.

The call returns 0 if successful or an error code (a negative value) if an error occurs.

GRAFERR_INDEXRANGE is returned if one or more color entries has an index value greater than 32.

Folio call implemented in Graphics folio V20.

graphics.h, graphics.lib

MakeCLUTColorEntry()