Celestia/Celx 脚本/CELX Lua 方法/CEL 命令捕获
外观
capture { type <jpg|png> filename <名称> }
截取屏幕截图并保存到磁盘(如果您的系统允许)。
注意事项
- 为了避免覆盖其他文件(例如非屏幕截图),文件名始终类似于“screenshot-000001.png”或“screenshot-<名称>-000001.png”,其中数字从每次启动脚本时开始计数,名称可以由脚本选择 - 如上所述。
- 截取屏幕截图需要一些时间,但任何正在进行的闪光、打印、跳转或居中命令都不会等待。这可能会在将来发生变化,但另一方面,还没有人抱怨过。
- Celestia 版本 1.3.2 中出于安全原因实施的限制在 Celestia 版本 1.4.0 中已有所解除,因为 CEL 脚本也提供了安全性较低的屏幕截图拍摄。这意味着可以使用 CEL 脚本绕过安全性 :-(
- 但是,屏幕截图仍然写入由 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")