TextItemGetColor: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
mNo edit summary |
||
| Line 5: | Line 5: | ||
==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 four integers in RGBA format, with a maximum value of 255 for each. | 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 gets the color of a | 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"> | ||
r,g,b,a = textItemGetColor ( | 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 ( r == 0 ) and ( g == 255 ) and ( b == 0 ) then -- if the color is green | ||
textItemSetColor ( | textItemSetColor ( theTextItem, 0, 0, 255, 255 ) -- set it to blue | ||
end | end | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 18:25, 21 August 2007
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.
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