TextItemGetPosition: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(Remove spaces) |
||
(6 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
{{Server function}} | |||
This function allows retrieval of the position of a text item. | This function allows retrieval of the position of a text item. | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
float float textItemGetPosition ( textitem | float float textItemGetPosition ( textitem theTextItem ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''theTextItem:''' The textitem you wish to retrieve the position of | ||
===Returns=== | ===Returns=== | ||
Line 14: | Line 15: | ||
==Example== | ==Example== | ||
This example creates a text item 'myTextItem' only if the text item 'otherTextItem' is not in the same position, to prevent overlap | 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. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
myDisplay = textCreateDisplay () -- | function MyTestTextFunction () | ||
textDisplayAddObserver ( myDisplay, myPlayer ) -- | myDisplay = textCreateDisplay ( ) -- create a text display | ||
x,y = textItemGetPosition ( otherTextItem ) --get the position of 'otherTextItem' | textDisplayAddObserver ( myDisplay, myPlayer ) -- make it visible to the player | ||
if ( x | 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 in the middle | |||
textItemSetPosition ( otherTextItem, 0.5, 0.6 ) -- move otherTextItem down | |||
end | |||
textItemSetPosition ( otherTextItem, 0.5, 0.6 ) --move | myTextItem = textCreateTextItem ( "Hello world!", 0.5, 0.5 ) -- create a new textitem in the middle saying "Hello world" | ||
textDisplayAddText ( myDisplay, myTextItem ) -- and add it to the text display | |||
end | end | ||
</syntaxhighlight> | </syntaxhighlight> |
Latest revision as of 21:14, 29 October 2023
This function allows retrieval of the position of a text item.
Syntax
float float textItemGetPosition ( textitem theTextItem )
Required Arguments
- theTextItem: 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.
function MyTestTextFunction () myDisplay = textCreateDisplay ( ) -- create a text display textDisplayAddObserver ( myDisplay, myPlayer ) -- make it visible to the 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 in the middle textItemSetPosition ( otherTextItem, 0.5, 0.6 ) -- move otherTextItem down end myTextItem = textCreateTextItem ( "Hello world!", 0.5, 0.5 ) -- create a new textitem in the middle saying "Hello world" textDisplayAddText ( myDisplay, myTextItem ) -- 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