TextItemGetScale: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(Remove spaces) |
||
| (5 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | |||
{{Server function}} | |||
This function allows retrieval of the scale or size of a text item. | |||
This | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
float textItemGetScale ( textitem | float textItemGetScale ( textitem theTextitem ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''theTextitem:''' The text item you wish to retrieve the scale of | ||
===Returns=== | ===Returns=== | ||
Returns | Returns a floating point of the scale of the text. 1.0 is around 12pt. | ||
==Example== | ==Example== | ||
This example | This example retrieves the scale of the 'theTextItem' text item, and if it is too small it enlarges it so it is more visible. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | scale = textItemGetScale ( theTextitem ) -- get the scale of theTextItem and store it in the 'scale' variable | ||
if scale < 0.5 then -- if the scale is smaller than 0.5 | |||
-- | textItemSetScale ( theTextItem, 1.0 ) -- then restore it to default size, 1.0. | ||
end | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{ | {{Text functions}} | ||
Latest revision as of 21:14, 29 October 2023
This function allows retrieval of the scale or size of a text item.
Syntax
float textItemGetScale ( textitem theTextitem )
Required Arguments
- theTextitem: The text item you wish to retrieve the scale of
Returns
Returns a floating point of the scale of the text. 1.0 is around 12pt.
Example
This example retrieves the scale of the 'theTextItem' text item, and if it is too small it enlarges it so it is more visible.
scale = textItemGetScale ( theTextitem ) -- get the scale of theTextItem and store it in the 'scale' variable
if scale < 0.5 then -- if the scale is smaller than 0.5
textItemSetScale ( theTextItem, 1.0 ) -- then restore it to default size, 1.0.
end
See Also
- textCreateDisplay
- textCreateTextItem
- textDestroyDisplay
- textDestroyTextItem
- textDisplayAddObserver
- textDisplayAddText
- textDisplayGetObservers
- textDisplayIsObserver
- textDisplayRemoveObserver
- textDisplayRemoveText
- textItemGetColor
- textItemGetPosition
- textItemGetPriority
- textItemGetScale
- textItemGetText
- textItemSetColor
- textItemSetPosition
- textItemSetPriority
- textItemSetScale
- textItemSetText