mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-31 05:20:17 +00:00
46 lines
2.2 KiB
Text
46 lines
2.2 KiB
Text
|
The _PALETTECOLOR statement sets the color value of a palette entry of an image using 256 color modes or less (4 or 8 BPP).
|
||
|
|
||
|
|
||
|
{{PageSyntax}}
|
||
|
:[[_PALETTECOLOR]] {{Parameter|index%}}, {{Parameter|colour&}}[, {{Parameter|imageHandle&}}]
|
||
|
|
||
|
|
||
|
{{PageDescription}}
|
||
|
* The {{Parameter|index%}} is the palette index(attribute) of the color to set, ranging from 0 to 15 (4 bit) or 0 to 255 (8 bit) color modes.
|
||
|
* The [[LONG]] {{Parameter|colour&}} is the new color value to set using [[_RGB32]] or [[_RGBA32]] values or using [[HEX$ 32 Bit Values]].
|
||
|
* If {{Parameter|imageHandle&}} is omitted, it is assumed to be the current write page.
|
||
|
* If {{Parameter|index%}} is outside of image or screen mode attribute range, an [[ERROR Codes|illegal function call]] error will occur.
|
||
|
* If {{Parameter|imageHandle&}} does not use a palette, an [[ERROR Codes|illegal function call]] error occurs. '''Will not work in 24/32 bit color palette modes!'''
|
||
|
* If {{Parameter|imageHandle&}} is an invalid handle, an [[ERROR Codes|invalid handle]] error occurs.
|
||
|
|
||
|
|
||
|
''Example:'' Creating custom background colors in SCREEN 0 that follow the text.
|
||
|
{{CodeStart}}
|
||
|
{{Cl|_PALETTECOLOR}} 1, {{Cl|_RGB32}}(255, 255, 255) ' white.
|
||
|
{{Cl|_PALETTECOLOR}} 2, {{Cl|_RGB32}}(255, 170, 170) ' lighter red.
|
||
|
{{Cl|_PALETTECOLOR}} 3, {{Cl|_RGB32}}(255, 85, 85) ' light red.
|
||
|
{{Cl|_PALETTECOLOR}} 4, {{Cl|_RGB32}}(255, 0, 0) ' red.
|
||
|
{{Cl|_PALETTECOLOR}} 5, {{Cl|_RGB32}}(170, 0, 0) ' dark red.
|
||
|
{{Cl|_PALETTECOLOR}} 6, {{Cl|_RGB32}}(85, 0, 0) ' darker red.
|
||
|
|
||
|
{{Cl|COLOR}} 0, 1: {{Cl|PRINT}} "black on white."
|
||
|
{{Cl|COLOR}} 0, 2: {{Cl|PRINT}} "black on lighter red."
|
||
|
{{Cl|COLOR}} 0, 3: {{Cl|PRINT}} "black on light red."
|
||
|
{{Cl|COLOR}} 0, 4: {{Cl|PRINT}} "black on red."
|
||
|
{{Cl|COLOR}} 0, 5: {{Cl|PRINT}} "black on dark red."
|
||
|
{{Cl|COLOR}} 0, 6: {{Cl|PRINT}} "black on darker red.
|
||
|
|
||
|
{{Cl|COLOR}} 1, 6: {{Cl|PRINT}} "white on darker red"
|
||
|
{{Cl|COLOR}} 2, 6: {{Cl|PRINT}} "ligher red on darker red" '' ''
|
||
|
{{CodeEnd}}
|
||
|
: ''Note:'' _PALLETCOLOR expects [[LONG]] 32 bit color values, NOT [[_RGB]] or [[_RGBA]] palette attribute values.
|
||
|
|
||
|
|
||
|
{{PageSeeAlso}}
|
||
|
* [[_PALETTECOLOR (function)]]
|
||
|
* [[PALETTE]], [[OUT]]
|
||
|
* [[Images]]
|
||
|
* [[HEX$ 32 Bit Values]]
|
||
|
|
||
|
|
||
|
{{PageNavigation}}
|