TextItemGetScale

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