Celestia/Celx 脚本/CELX Lua 方法/CEL 命令 print
外观
print { text <textstring> origin <originstring> duration <duration> row <rownumber> column <columnnumber> }
print 命令允许您在 Celestia 的显示窗口中显示文本,定义文本的位置以及显示时长。
您必须在 print 命令之后使用一个 wait 命令,其持续时间等于或大于指定的 <duration>。
注意:如果要打印的文本长度超过用户窗口的宽度,则文本将超出窗口的右侧边缘。
参数
- text <textstring>
- 您要显示的文本,用引号括起来。无默认值。
您也可以使用 "\n" 在文本字符串的任何位置生成 CR/LF。 - origin <originstring>
- 文本第一个字符的起始位置。默认为 "bottomleft"。
必须是以下值之一- bottom
- bottomleft
- bottomright
- center
- left
- right
- top
- topleft
- topright
- duration <duration>
- 显示文本消息的秒数。默认为 1.0。
- row <rownumber>
- 定义文本应显示的起始显示行(垂直位置),从 <originstring> 偏移。默认为 0。
正值将起始行向下移动,而负值将起始行向上移动(“+”符号不是必需的)。 - column <columnnumber>
- 文本第一个字符应显示的列号(水平位置)。默认为 0。
第 0 列(零)是显示屏幕的左边缘。
CELX 等效项-1
基于 celestia:flash() 方法。
注意:此方法无法将文本定位到屏幕上的特定位置。
应改用 celestia:print() 方法(参见CELX 等效项-2)
- 在屏幕上打印文本,类似于 print。
<textstring> 包含要打印的消息的字符串。
该字符串可以包含换行符 "\n" 来换行,或许多以 UTF-8 编码的特殊字符。
<duration> 是文本显示的秒数。默认为 5.0 秒。
celestia:flash( <textstring>, <duration> )
CELX 等效项-2
基于 celestia:print() 方法。
- 在屏幕上打印文本。Celestia 支持 UTF-8 编码的文本字符串,用于显示非 ASCII 字符。
<textstring> 是一个包含要打印的消息的字符串。
该字符串可以包含换行符 "\n" 来换行,或许多以 UTF-8 编码的特殊字符。
<duration> 是文本显示的秒数。默认为 5.0 秒。
<horig> 是文本的水平原点:-1 是左,0 是中心,1 是右。
<vorig> 是文本的垂直原点,-1 是底部,0 是中心,1 是顶部。
<hoffset> 是相对于水平原点的水平偏移量。
<voffset> 是相对于垂直原点的垂直偏移量。
celestia:print( <textstring>, <duration>, <horig>, <vorig>, <hoffset>, <voffset> )
示例
此示例打印消息 "Hello Universe!",该消息位于显示屏幕底部的上方三行,从左侧边缘开始的两列
CEL
print { text "Hello Universe!" row -3 column 2 } wait { duration 5 }
CELX 使用 celestia:flash() 方法
celestia:flash("Hello Universe!", 5.0) wait(5.0)
CELX 使用 celestia:print() 方法
celestia:print( "Hello Universe!", 5.0, -1, -1, 3, 2) wait(5.0)