2022-01-15 12:33:23 +00:00
< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
< html >
< meta http-equiv = "Content-Type" content = "text/html; charset=UTF-8" / >
< head >
< title > TombEngine Lua API< / title >
< link rel = "stylesheet" href = "../ldoc.css" type = "text/css" / >
< / head >
< body >
< div id = "container" >
< div id = "product" >
< div id = "product_logo" > < / div >
< div id = "product_name" > < big > < b > < / b > < / big > < / div >
< div id = "product_description" > < / div >
< / div > <!-- id="product" -->
< div id = "main" >
<!-- Menu -->
< div id = "navigation" >
< br / >
< h1 > TombEngine< / h1 >
< ul >
< li > < a href = "../index.html" > Index< / a > < / li >
< / ul >
< h2 > Contents< / h2 >
< ul >
< li > < a href = "#Functions" > Functions< / a > < / li >
< / ul >
2022-04-10 00:38:39 +01:00
< h2 > 2 Classes< / h2 >
2022-01-15 12:33:23 +00:00
< ul class = "nowrap" >
2022-04-10 00:38:39 +01:00
< li > < a href = "../2 classes/Flow.Animations.html" > Flow.Animations< / a > < / li >
< li > < a href = "../2 classes/Flow.Fog.html" > Flow.Fog< / a > < / li >
< li > < a href = "../2 classes/Flow.InventoryItem.html" > Flow.InventoryItem< / a > < / li >
< li > < a href = "../2 classes/Flow.Level.html" > Flow.Level< / a > < / li >
< li > < a href = "../2 classes/Flow.Mirror.html" > Flow.Mirror< / a > < / li >
< li > < a href = "../2 classes/Flow.Settings.html" > Flow.Settings< / a > < / li >
< li > < a href = "../2 classes/Flow.SkyLayer.html" > Flow.SkyLayer< / a > < / li >
< li > < a href = "../2 classes/Objects.AIObject.html" > Objects.AIObject< / a > < / li >
< li > < a href = "../2 classes/Objects.Camera.html" > Objects.Camera< / a > < / li >
< li > < a href = "../2 classes/Objects.Moveable.html" > Objects.Moveable< / a > < / li >
< li > < a href = "../2 classes/Objects.Sink.html" > Objects.Sink< / a > < / li >
< li > < a href = "../2 classes/Objects.SoundSource.html" > Objects.SoundSource< / a > < / li >
< li > < a href = "../2 classes/Objects.Static.html" > Objects.Static< / a > < / li >
< li > < strong > Strings.DisplayString< / strong > < / li >
2022-01-15 12:33:23 +00:00
< / ul >
2022-04-10 00:38:39 +01:00
< h2 > 1 Modules< / h2 >
2022-01-15 12:33:23 +00:00
< ul class = "nowrap" >
2022-04-10 00:38:39 +01:00
< li > < a href = "../1 modules/Flow.html" > Flow< / a > < / li >
< li > < a href = "../1 modules/Inventory.html" > Inventory< / a > < / li >
< li > < a href = "../1 modules/Logic.html" > Logic< / a > < / li >
< li > < a href = "../1 modules/Misc.html" > Misc< / a > < / li >
< li > < a href = "../1 modules/Objects.html" > Objects< / a > < / li >
< li > < a href = "../1 modules/Strings.html" > Strings< / a > < / li >
2022-01-15 12:33:23 +00:00
< / ul >
2022-04-10 00:38:39 +01:00
< h2 > 3 Primitive Classes< / h2 >
2022-01-15 12:33:23 +00:00
< ul class = "nowrap" >
2022-04-10 00:38:39 +01:00
< li > < a href = "../3 primitive classes/Color.html" > Color< / a > < / li >
< li > < a href = "../3 primitive classes/Rotation.html" > Rotation< / a > < / li >
2022-04-18 17:53:06 +01:00
< li > < a href = "../3 primitive classes/Vec3.html" > Vec3< / a > < / li >
2022-01-15 12:33:23 +00:00
< / ul >
2022-04-10 00:38:39 +01:00
< h2 > 4 Enums< / h2 >
2022-01-15 12:33:23 +00:00
< ul class = "nowrap" >
2022-04-10 00:38:39 +01:00
< li > < a href = "../4 enums/Flow.InvID.html" > Flow.InvID< / a > < / li >
< li > < a href = "../4 enums/Objects.ObjID.html" > Objects.ObjID< / a > < / li >
2022-01-15 12:33:23 +00:00
< / ul >
< / div >
< div id = "content" >
2022-04-10 00:38:39 +01:00
< h1 > Class < code > Strings.DisplayString< / code > < / h1 >
2022-01-15 12:33:23 +00:00
< p > A string appearing on the screen.< / p >
< p > Can be used for subtitles and "2001, somewhere in Egypt"-style messages.< / p >
< p > Uses screen-space coordinates, with x values specifying the number of pixels from the left of the window,
and y values specifying the number of pixels from the top of the window.< / p >
< p > Since different players will have different resolutions, you should work in terms of percentages where possible,
2022-04-10 00:38:39 +01:00
and use < a href = "../1 modules/Misc.html#ScreenToPercent" > ScreenToPercent< / a > and < a href = "../1 modules/Misc.html#PercentToScreen" > PercentToScreen< / a >
2022-01-15 12:33:23 +00:00
when you need to use screen-space coordinates.< / p >
2022-04-10 00:38:39 +01:00
< h2 > < a href = "#Functions" > Functions< / a > < / h2 >
2022-01-15 12:33:23 +00:00
< table class = "function_list" >
< tr >
2022-04-10 12:01:20 +01:00
< td class = "name" > < a href = "#DisplayString.new" > DisplayString.new(str, x, y, color, translated, flags)< / a > < / td >
2022-04-10 00:38:39 +01:00
< td class = "summary" > Create a DisplayString.< / td >
2022-01-15 12:33:23 +00:00
< / tr >
< tr >
2022-04-10 00:38:39 +01:00
< td class = "name" > < a href = "#GetColor" > GetColor()< / a > < / td >
< td class = "summary" > Get the display string's color< / td >
2022-01-15 12:33:23 +00:00
< / tr >
< tr >
2022-04-10 00:38:39 +01:00
< td class = "name" > < a href = "#SetColor" > SetColor(color)< / a > < / td >
< td class = "summary" > Set the display string's color< / td >
< / tr >
< tr >
< td class = "name" > < a href = "#SetKey" > SetKey(string)< / a > < / td >
< td class = "summary" > Set the string key to use.< / td >
2022-01-15 12:33:23 +00:00
< / tr >
< tr >
2022-04-10 00:38:39 +01:00
< td class = "name" > < a href = "#DisplayString:SetPosition" > DisplayString:SetPosition(x, y)< / a > < / td >
2022-01-15 12:33:23 +00:00
< td class = "summary" > Set the position of the string.< / td >
< / tr >
< tr >
2022-04-10 00:38:39 +01:00
< td class = "name" > < a href = "#DisplayString:GetPosition" > DisplayString:GetPosition()< / a > < / td >
2022-01-15 12:33:23 +00:00
< td class = "summary" > Get the position of the string.< / td >
< / tr >
< / table >
< br / >
< br / >
< h2 class = "section-header " > < a name = "Functions" > < / a > Functions< / h2 >
< dl class = "function" >
< dt >
< a name = "DisplayString.new" > < / a >
2022-04-10 12:01:20 +01:00
< strong > DisplayString.new(str, x, y, color, translated, flags)< / strong >
2022-01-15 12:33:23 +00:00
< / dt >
< dd >
Create a DisplayString.
2022-04-10 00:38:39 +01:00
For use in < a href = "../1 modules/Strings.html#ShowString" > ShowString< / a > and < a href = "../1 modules/Strings.html#HideString" > HideString< / a > .
2022-01-15 12:33:23 +00:00
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > str< / span >
< span class = "types" > < a class = "type" href = "https://www.lua.org/manual/5.1/manual.html#5.4" > string< / a > < / span >
string to print or key of translated string
< / li >
< li > < span class = "parameter" > x< / span >
< span class = "types" > < span class = "type" > int< / span > < / span >
x-coordinate of top-left of string (or the center if DisplayStringOption.CENTER is given)
< / li >
< li > < span class = "parameter" > y< / span >
< span class = "types" > < span class = "type" > int< / span > < / span >
y-coordinate of top-left of string (or the center if DisplayStringOption.CENTER is given)
< / li >
< li > < span class = "parameter" > color< / span >
< span class = "types" > < span class = "type" > Color< / span > < / span >
the color of the text
< / li >
2022-04-10 12:01:20 +01:00
< li > < span class = "parameter" > translated< / span >
< span class = "types" > < span class = "type" > bool< / span > < / span >
if false or omitted, the str argument will be printed.
If true, the str argument will be the key of a translated string specified in
strings.lua. < strong > Default: false< / strong > .
< / li >
2022-01-15 12:33:23 +00:00
< li > < span class = "parameter" > flags< / span >
< span class = "types" > < a class = "type" href = "https://www.lua.org/manual/5.1/manual.html#5.5" > table< / a > < / span >
a table of display options. Can be empty or omitted. The possible values and their effects are...< / p >
2022-04-10 00:38:39 +01:00
< pre > < code > TEN.Strings.DisplayStringOption.CENTER -- see x and y parameters
TEN.Strings.DisplayStringOption.SHADOW -- will give the text a small shadow
2022-01-15 12:33:23 +00:00
< / code > < / pre >
< p > < strong > Default: empty< / strong >
< / li >
< / ul >
< h3 > Returns:< / h3 >
< ol >
A new DisplayString object.
< / ol >
< / dd >
< dt >
2022-04-10 00:38:39 +01:00
< a name = "GetColor" > < / a >
< strong > GetColor()< / strong >
< / dt >
< dd >
Get the display string's color
< h3 > Returns:< / h3 >
< ol >
< span class = "types" > < span class = "type" > Color< / span > < / span >
a copy of the display string's color
< / ol >
< / dd >
< dt >
< a name = "SetColor" > < / a >
< strong > SetColor(color)< / strong >
< / dt >
< dd >
Set the display string's color
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > color< / span >
< span class = "types" > < span class = "type" > Color< / span > < / span >
the new color of the display string
< / li >
< / ul >
< / dd >
< dt >
< a name = "SetKey" > < / a >
< strong > SetKey(string)< / strong >
< / dt >
< dd >
Set the string key to use. If < code > translated< / code > is true when < a href = "../2 classes/Strings.DisplayString.html#DisplayString.new" > DisplayString.new< / a >
is called, this will be the string key for the translation that will be displayed.
If false or omitted, this will be the string that's displayed.
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > string< / span >
< span class = "types" > < span class = "type" > String< / span > < / span >
the new key for the display string
< / li >
< / ul >
< / dd >
< dt >
< a name = "DisplayString:SetPosition" > < / a >
< strong > DisplayString:SetPosition(x, y)< / strong >
2022-01-15 12:33:23 +00:00
< / dt >
< dd >
Set the position of the string.
Screen-space coordinates are expected.
< h3 > Parameters:< / h3 >
< ul >
< li > < span class = "parameter" > x< / span >
< span class = "types" > < span class = "type" > int< / span > < / span >
x-coordinate of the string
< / li >
< li > < span class = "parameter" > y< / span >
< span class = "types" > < span class = "type" > int< / span > < / span >
y-coordinate of the string
< / li >
< / ul >
< / dd >
< dt >
2022-04-10 00:38:39 +01:00
< a name = "DisplayString:GetPosition" > < / a >
< strong > DisplayString:GetPosition()< / strong >
2022-01-15 12:33:23 +00:00
< / dt >
< dd >
Get the position of the string.
Screen-space coordinates are returned.
< h3 > Returns:< / h3 >
< ol >
< li >
< span class = "types" > < span class = "type" > int< / span > < / span >
x x-coordinate of the string< / li >
< li >
< span class = "types" > < span class = "type" > int< / span > < / span >
y y-coordinate of the string< / li >
< / ol >
< / dd >
< / dl >
< / div > <!-- id="content" -->
< / div > <!-- id="main" -->
< div id = "about" >
< i > generated by < a href = "http://github.com/stevedonovan/LDoc" > LDoc 1.4.6< / a > < / i >
2022-04-18 17:53:06 +01:00
< i style = "float:right;" > Last updated 2022-04-18 17:50:55 < / i >
2022-01-15 12:33:23 +00:00
< / div > <!-- id="about" -->
< / div > <!-- id="container" -->
< / body >
< / html >
