SetScreenColor

Sets a color in the 3DO system's palette.

Synopsis

Err SetScreenColor (Item screenItem,int32 colorEntry)

Description

This call sets a color in the palette of the screen specified by the screenItem argument.

The colorEntry argument is a packed color value containing an index and individual red, green, and blue components. Each of the four components in the colorEntry 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 colorEntry argument can be constructed using the MakeCLUTColorEntry() macro.

Arguments

screenItem: Item number of a screen structure.

colorEntry: 32-bit color entry comprising an index, a red, a green, and a blue value.

Return Value

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

GRAFERR_INDEXRANGE is returned if the index value in the color entry is larger than 32.

Implementation

Folio call implemented in Graphics folio V20.

Associated Files

graphics.h, graphics.lib