Class Label
Used to place text.
Class Label
label:new () | Constructor. |
Class Label
- label:new ()
-
Constructor.
text
: a string. The text to be displayed.maxText
: a string. The text of maximum possible length displayed by this label. Let us explain: as you know the size of a block is calculated once per a call to Block:place, however, it is highly likely you want to change the text "on-the-fly", f.e., when displaying HP or XP of a character, current FPS, or the number of items left in a slot. You don't want to re-place the HUD every time you need to change the text. More over, you don't want the HUD to vary in size if text is changed. That is where themaxText
parameter comes to play: it reserves the necessary area on the screen to fit any text there. So suppose you have a label in your HUD that displays XP. You know that the maximum possible XP is limited to10000
, but at the moment you want to display0
, so you do:local label = ui.Label { text = '0', maxText = '10000' }
NOTE: I encourage you to use a monospace font, otherwise
maxText
might not guarantee it occupies the maximum area. For example, for some fonts the string11111
may be shorter than9999
.color
: a color like in love2d (the table variant). The color of the text.