Lua Fonts: Difference between revisions
From Spring
Jump to navigationJump to search
New page: Development < Lua Scripting < {{FULLPAGENAME}} =Load/Delete= '''gl.LoadFont''' ( string fontfilename, number size = 14, number outlineWidth = 2,... |
|||
| Line 31: | Line 31: | ||
</span> | </span> | ||
http://home.arcor.de/jkei/fontlines.png | http://home.arcor.de/jkei/fontlines.png | ||
'''font:SetTextColor''' | '''font:SetTextColor''' | ||
| Line 40: | Line 41: | ||
'''font:SetAutoOutlineColor''' | '''font:SetAutoOutlineColor''' | ||
( boolean enable ) -> nil | ( boolean enable ) -> nil | ||
'''font:GetTextWidth''' | '''font:GetTextWidth''' | ||
| Line 46: | Line 48: | ||
( string "text" ) -> nil | number height, number descender, number numlines <span class=note>(in pixels, with a font size of 1.0)</span> | ( string "text" ) -> nil | number height, number descender, number numlines <span class=note>(in pixels, with a font size of 1.0)</span> | ||
<span class=note>further descriptions here: [[GetTextHeight]]</span> | <span class=note>further descriptions here: [[GetTextHeight]]</span> | ||
'''font:WrapText''' | '''font:WrapText''' | ||
| Line 52: | Line 55: | ||
'''font:BindTexture''' | '''font:BindTexture''' | ||
( ) -> nil | ( ) -> nil | ||
| Line 59: | Line 63: | ||
'''font:End''' | '''font:End''' | ||
( ) -> nil | ( ) -> nil | ||
=Userdata Properties (ReadOnly)= | =Userdata Properties (ReadOnly)= | ||
Revision as of 01:29, 1 July 2010
Development < Lua Scripting < Lua Fonts
Load/Delete
gl.LoadFont
( string fontfilename, number size = 14, number outlineWidth = 2, number outlineWeight = 15 ) -> userdata font
gl.DeleteFont
( userdata font ) -> nil
Userdata Functions
font:Print
(string "text", number x, number y [, number size [, string "options"] ] )
options are:
horizontal alignment:
'c' = center
'r' = right
vertical alignment:
'a' = ascender
't' = top
'v' = vertical center
'x' = baseline
'b' = bottom
'd' = descender
decorations:
'o' = black outline
'O' = white outline
's' = shadow
other:
'n' = don't round vertex coords to nearest integer (font may get blurry)
font:SetTextColor
( number r, number g, number b [, number a ] ) -> nil
( {r,g,b,a} ) -> nil
font:SetOutlineColor
( number r, number g, number b [, number a ] ) -> nil
( {r,g,b,a} ) -> nil
font:SetAutoOutlineColor
( boolean enable ) -> nil
font:GetTextWidth
(string "text") -> number width (in pixels, with a font size of 1.0)
font:GetTextHeight
( string "text" ) -> nil | number height, number descender, number numlines (in pixels, with a font size of 1.0) further descriptions here: GetTextHeight
font:WrapText
( string "text", number max_width [, number max_height [, number size ] ]) -> nil | string wrappedText, number lines
font:BindTexture
( ) -> nil
If you have multiple font:Print calls, then you can bunch them between a font:Begin() and font:End() to speedup the rendering.
font:Begin
( ) -> nil
font:End
( ) -> nil
Userdata Properties (ReadOnly)
string font.path
string font.family
string font.style
number font.size
number font.outlinecolor
number font.height a.k.a. font.lineheight
number font.descender
number font.outlinewidth
number font.outlineweight
number font.texturewidth
number font.textureheight
