TextItemGetColor: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(Remove spaces) |
||
(6 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | |||
{{Server function}} | |||
This function allows you to retrieve the color of a text item. | |||
This | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
int int int int textItemGetColor ( textitem | int int int int textItemGetColor ( textitem theTextItem ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''theTextItem:''' The text item you wish to retrieve the color of. | ||
===Returns=== | ===Returns=== | ||
Returns '' | Returns four integers in RGBA format, with a maximum value of 255 for each. The values are, in order, ''red'', ''green'', ''blue'', and ''alpha''. Alpha decides transparency where 255 is opaque and 0 is transparent. ''false'' is returned if the text item is invalid. | ||
==Example== | ==Example== | ||
This example | This example gets the color of a text item named 'theTextItem' and if it is green, changes it to blue. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | local r,g,b,a = textItemGetColor ( theTextItem ) -- get the text color and store it in the variables 'r','g','b' and 'a' | ||
if ( r == 0 ) and ( g == 255 ) and ( b == 0 ) then -- if the color is green | |||
-- | textItemSetColor ( theTextItem, 0, 0, 255, 255 ) -- set it to blue | ||
end | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{ | {{Text functions}} |
Latest revision as of 21:15, 29 October 2023
This function allows you to retrieve the color of a text item.
Syntax
int int int int textItemGetColor ( textitem theTextItem )
Required Arguments
- theTextItem: The text item you wish to retrieve the color of.
Returns
Returns four integers in RGBA format, with a maximum value of 255 for each. The values are, in order, red, green, blue, and alpha. Alpha decides transparency where 255 is opaque and 0 is transparent. false is returned if the text item is invalid.
Example
This example gets the color of a text item named 'theTextItem' and if it is green, changes it to blue.
local r,g,b,a = textItemGetColor ( theTextItem ) -- get the text color and store it in the variables 'r','g','b' and 'a' if ( r == 0 ) and ( g == 255 ) and ( b == 0 ) then -- if the color is green textItemSetColor ( theTextItem, 0, 0, 255, 255 ) -- set it to blue end
See Also
- textCreateDisplay
- textCreateTextItem
- textDestroyDisplay
- textDestroyTextItem
- textDisplayAddObserver
- textDisplayAddText
- textDisplayGetObservers
- textDisplayIsObserver
- textDisplayRemoveObserver
- textDisplayRemoveText
- textItemGetColor
- textItemGetPosition
- textItemGetPriority
- textItemGetScale
- textItemGetText
- textItemSetColor
- textItemSetPosition
- textItemSetPriority
- textItemSetScale
- textItemSetText