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. If it is in the same position, then it moves it down.

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