跳至内容

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)


返回 CEL 命令索引

华夏公益教科书