1
1
Fork 0
mirror of https://github.com/QB64Official/qb64.git synced 2024-07-01 09:10:37 +00:00
qb64/internal/help/_CLEARCOLOR_(function).txt
2019-04-14 22:15:33 -03:00

26 lines
1.1 KiB
Plaintext

{{DISPLAYTITLE:_CLEARCOLOR (function)}}
The [[_CLEARCOLOR (function)|_CLEARCOLOR]] function returns the current transparent color of an image or page.
{{PageSyntax}}
:''result&'' = [[_CLEARCOLOR (function)|_CLEARCOLOR]] [{{Parameter|Source_Handle&}}]
{{PageDescription}}
* If {{Parameter|Source_Handle&}} is omitted, it is assumed to be the current [[_DEST|destination]] write page.
* If {{Parameter|Source_Handle&}} is an invalid handle value(-1), then an [[ERROR Codes|invalid handle value]] is returned.
* In color modes using a palette, the index of the current transparent color value is returned, or -1 if no transparent color is set.
* In 32-bit color modes, zero is returned.
* Returns the color that currently is transparent, or if no color is transparent -1 without error.
* A [[_CLEARCOLOR]] statement can set the transparent color of an image or screen.
* '''NOTE: Default 32 bit backgrounds are clear black or [[_RGBA]](0, 0, 0, 0). Use [[CLS]] to make the black opaque.'''
{{PageSeeAlso}}
* [[_CLEARCOLOR]] {{text|(sets a clear color)}}
* [[_SETALPHA]] {{text|(sets color transparency)}}
* [[Images]]
{{PageNavigation}}