1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-03 12:21:20 +00:00
QB64-PE/internal/help/_RED__111.txt
Roland Heyder aeb9c0668b Updates help files for use with new Wiki parser (2nd try)
Note: Many files were removed (not yet existing/empty pages). The parser will try to download them on demand and will auto-generate text for missing pages (eg. most _gl pages).
2022-05-21 00:18:31 +02:00

35 lines
1.4 KiB
Plaintext

{{QBDLDATE:05-20-2022}}
{{QBDLTIME:23:10:08}}
{{DISPLAYTITLE:_RED}}
The [[_RED]] function returns the palette index or the red component intensity of a 32-bit image color.
{{PageSyntax}}
: {{Parameter|redIntensity&}} = [[_RED]]({{Parameter|rgbaColorIndex&}}[, {{Parameter|imageHandle&}}])
{{PageDescription}}
* {{Parameter|rgbaColorIndex&}} is the ''RGBA'' color value or palette index of the color to retrieve the red component intensity from.
* The [[LONG]] intensity value returned ranges from 0 (no intensity, not present) to 255 (full intensity).
* {{Parameter|imageHandle&}} is optional.
* If {{Parameter|imageHandle&}} specifies a 32-bit color image, {{Parameter|rgbaColorIndex&}} is interpreted as a 32-bit ''RGBA'' color value.
* If {{Parameter|imageHandle&}} specifies an image that uses a palette, {{Parameter|rgbaColorIndex&}} is interpreted as a palette index.
* If {{Parameter|imageHandle&}} is not specified, it is assumed to be the current write page.
* If {{Parameter|imageHandle&}} is an invalid handle, an [[ERROR Codes|invalid handle]] error occurs.
* If {{Parameter|rgbaColorIndex&}} is outside the range of valid indexes for a given image mode, an [[ERROR Codes|illegal function call]] error occurs.
* Uses index parameters passed by the [[_RGB]], [[_RGBA]], [[_RGB32]] or [[_RGBA32]] functions.
{{PageExamples}}
* See the example in [[POINT]].
{{PageSeeAlso}}
* [[_GREEN]], [[_BLUE]]
* [[_RGB]], [[RGB32]]
* [[_LOADIMAGE]]
{{PageNavigation}}