====== 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

==== See Also ====

''%%MakeCLUTColorEntry%%''()