跳转到内容

Celestia/Celx 脚本/CELX Lua 方法/CEL 命令捕获

来自维基教科书,开放世界中的开放书籍

capture { type <jpg|png> filename <名称> }

截取屏幕截图并保存到磁盘(如果您的系统允许)。


注意事项

  1. 为了避免覆盖其他文件(例如非屏幕截图),文件名始终类似于“screenshot-000001.png”或“screenshot-<名称>-000001.png”,其中数字从每次启动脚本时开始计数,名称可以由脚本选择 - 如上所述。
  2. 截取屏幕截图需要一些时间,但任何正在进行的闪光、打印、跳转或居中命令都不会等待。这可能会在将来发生变化,但另一方面,还没有人抱怨过。
  3. Celestia 版本 1.3.2 中出于安全原因实施的限制在 Celestia 版本 1.4.0 中已有所解除,因为 CEL 脚本也提供了安全性较低的屏幕截图拍摄。这意味着可以使用 CEL 脚本绕过安全性 :-(
  4. 但是,屏幕截图仍然写入由 celestia.cfg 文件中的配置选项“ScriptScreenshotDirectory”设置的目录,默认情况下为主要 celestia 目录(通常类似于 C:\Program Files\Celestia\),具体取决于您的系统,Celestia 可能无法写入文件那里。


参数

type <jpg|png>
定义屏幕截图的文件类型(扩展名),默认为“png”。
必须是以下之一
  • "png"
  • "jpg"
filename <名称>
一个必需的字符串,将用于此屏幕截图的整个文件名,包括扩展名。
此名称仅限于 A-z、0-9 和 _(下划线),最大长度为许多字符。


CELX 等效

基于 celestia:takescreenshot() 方法。

  • 截取屏幕截图并保存到磁盘(如果您的系统允许)。如果成功,则返回布尔值 true。
screenshot = celestia:takescreenshot("jpg", <name>)

-- 或者 --

screenshot = celestia:takescreenshot("png", <name>)


示例
截取当前场景的屏幕截图并将其存储在文件名: "screenshot-test-000001.jpg" 中。如果此文件名已存在,则数字部分将递增,直到第一个空闲数字。

CEL

capture { type "jpg" filename "test" }

CELX

screenshot = celestia:takescreenshot("jpg", "test")


返回 CEL 命令索引

华夏公益教科书