TextItemSetPosition: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(Remove spaces) |
||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | |||
{{Server function}} | |||
This function allows the setting of the position of a text item. | |||
This function allows the setting of the position of a text item | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool textItemSetPosition ( textitem | bool textItemSetPosition ( textitem theTextItem, float x, float y ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''theTextItem:''' The text item that you want to move | ||
*'''x:''' A floating point number between 0.0 and 1.0 indicating how far across the screen the text should be shown, as a percentage of the width, from the left hand side. | *'''x:''' A floating point number between 0.0 and 1.0 indicating how far across the screen the text should be shown, as a percentage of the width, from the left hand side. | ||
*'''y:''' A floating point number between 0.0 and 1.0 indicating how far down the screen the text should be shown, as a percentage of the height, from the top. | *'''y:''' A floating point number between 0.0 and 1.0 indicating how far down the screen the text should be shown, as a percentage of the height, from the top. | ||
| Line 18: | Line 17: | ||
==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 () -- | 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 text item 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}} | ||
Latest revision as of 21:14, 29 October 2023
This function allows the setting of the position of a text item.
Syntax
bool textItemSetPosition ( textitem theTextItem, float x, float y )
Required Arguments
- theTextItem: The text item that you want to move
- x: A floating point number between 0.0 and 1.0 indicating how far across the screen the text should be shown, as a percentage of the width, from the left hand side.
- y: A floating point number between 0.0 and 1.0 indicating how far down the screen the text should be shown, as a percentage of the height, from the top.
Returns
Returns true if the position was successfully set, false otherwise.
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 text item 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