SetScreenColors

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

Synopsis

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

Description

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.

Arguments

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.

Return Value

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.

Implementation

Folio call implemented in Graphics folio V20.

Associated Files

graphics.h, graphics.lib