TextItemGetPosition: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
mNo edit summary |
||
| Line 5: | Line 5: | ||
==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 17: | Line 17: | ||
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. | 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 () -- | myDisplay = textCreateDisplay ( ) -- create a text display | ||
textDisplayAddObserver ( myDisplay, myPlayer ) -- | textDisplayAddObserver ( myDisplay, myPlayer ) -- make it visible to the player | ||
x,y = textItemGetPosition ( otherTextItem ) --get the position of 'otherTextItem' | 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 | 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 | textItemSetPosition ( otherTextItem, 0.5, 0.6 ) -- move otherTextItem down | ||
end | end | ||
myTextItem = textCreateTextItem ( "Hello world!", 0.5, 0.5 ) -- | 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 | textDisplayAddText ( myDisplay, myTextItem ) -- and add it to the text display | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{Text functions}} | {{Text functions}} | ||
Revision as of 18:27, 21 August 2007
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.
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
See Also
- textCreateDisplay
- textCreateTextItem
- textDestroyDisplay
- textDestroyTextItem
- textDisplayAddObserver
- textDisplayAddText
- textDisplayGetObservers
- textDisplayIsObserver
- textDisplayRemoveObserver
- textDisplayRemoveText
- textItemGetColor
- textItemGetPosition
- textItemGetPriority
- textItemGetScale
- textItemGetText
- textItemSetColor
- textItemSetPosition
- textItemSetPriority
- textItemSetScale
- textItemSetText