TextItemGetPosition

This function allows retrieval of the position of a text item.

Syntax

float float textItemGetPosition ( textitem textitem )              

Required Arguments

• textitem: The textitem you wish to retrieve the position of

Returns

Returns two floats of the x and y position on the screen, where the maximum value is 1.0.

Example

This example creates a text item 'myTextItem' only if the text item 'otherTextItem' is not in the same position, to prevent overlap

myDisplay = textCreateDisplay () --created display
textDisplayAddObserver ( myDisplay, myPlayer ) --made display visible to player
x,y = textItemGetPosition ( otherTextItem ) --get the position of 'otherTextItem'
if ( x ~= 0.5 ) and ( y ~= 0.5 ) then --if the x and y of the text item are not in the middle
    myTextItem = textCreateTextItem ( "Hello world!", 0.5, 0.5 ) --create a new item for the display in the middle saying "Hello world"
    textDisplayAddText ( myDisplay, myTextItem ) --and add it to the text display
else --otherwise
    textItemSetPosition ( otherTextItem, 0.5, 0.6 ) --move the otherTextItem down 
    myTextItem = textCreateTextItem ( "Hello world!", 0.5, 0.5 ) --and create a new item for the display in the middle saying "Hello world"
    textDisplayAddText ( myDisplay, myTextItem ) --then and add it to the text display
end

See Also

• textCreateDisplay
• textCreateTextItem
• textDestroyDisplay
• textDestroyTextItem
• textDisplayAddObserver
• textDisplayAddText
• textDisplayGetObservers
• textDisplayIsObserver
• textDisplayRemoveObserver
• textDisplayRemoveText
• textItemGetColor
• textItemGetPosition
• textItemGetPriority
• textItemGetScale
• textItemGetText
• textItemSetColor
• textItemSetPosition
• textItemSetPriority
• textItemSetScale
• textItemSetText