文档 参考

Celas Studio 把文件放在哪儿

Celas Studio 写在你项目之外的每一个文件:设置、工作区、画笔、快捷键、崩溃报告和自动保存,以及每一个在各平台上住在哪儿。

Celas Studio 在磁盘上保着两套分开的文件:一个应用数据文件夹,装你能从首选项和那些面板里改的一切;还有一个更小、单独的文件夹,装你的许可证和账户,好让它们熬得过一次重装。

应用数据文件夹

平台位置
Windows和 celasstudio.exe 并排,在你装到的那个文件夹里
macOS~/Library/Application Support/Fruzai/CelasStudio/
Linux$XDG_DATA_HOME/Fruzai/CelasStudio/,那个变量没设的话就是 ~/.local/share/Fruzai/CelasStudio/
文件 / 文件夹它装着什么
imgui.ini停靠布局和窗口位置
celaskanvas_ui.cfg面板可见性、视口显示选项、工具选项、导出对话框设置、首选项和最近项目列表
shortcuts.cfg每一条键盘快捷键绑定
celasstudio_brushes.cbrushset你自定义的画笔预设
swatches_library.json你的色板颜色库:每一个分类、颜色和渐变
celaskanvas_swatches.cfg色板面板正怎么显示那个库:视图模式、色块大小、显示名称、当前分类
celaskanvas_color.cfg颜色面板的状态
workspaces/ 文件夹你用 窗口 ▸ 工作区 ▸ 保存工作区… 存下的每一个工作区一个 .ini 文件,按它命名
tips/*.png你用「将选区保存为笔尖」存下的画笔笔尖,加上你自己丢进这个文件夹的任何 PNG
crash-report.txt上一次崩溃的纯文本报告,前提是它还没被发出去
client-id.txt一个匿名 id,只用来把崩溃报告归到一起,不是设备指纹

还有一个文件住在你项目旁边而不是应用数据文件夹里:你要是打开了自动保存,一份自动保存的恢复副本会以你项目的文件名加上 .autosave.cls 写出来,就在真正的项目文件旁边。它是一个单独的文件。自动保存从不碰你实际的项目,也从不清掉它那个未保存改动的标记。一个从来没保存过的文档没有项目文件夹可待,所以它的副本进应用数据文件夹,叫作 untitled-N.autosave.cls;一份崩溃时抢救出来的副本落在那儿叫作 rescued.cls。

在 Windows 上有一样东西是 Celas Studio 写在这些文件夹之外的。为了让双击一个项目管用,它会给你的用户账户注册 .cls 文件类型,在 HKEY_CURRENT_USER\Software\Classes 底下,在 .cls 键和 CelasKanvas.Project 里。注册表全机器那一部分什么都没写,所以它不需要管理员权限,而 celasstudio.exe --unregister-file-types 会把这些条目撤回去。见「打开项目」。

许可证和账户:另一个文件夹

你的许可证和你的 celas.studio 登录是和其余设置分开存的,正是为了让你搬动、重装或者就地更新这个软件时它们不丢。

平台位置
Windows%LOCALAPPDATA%\CelasKanvasStudio\
macOS~/Library/Application Support/CelasKanvasStudio/
Linux$XDG_CONFIG_HOME/CelasKanvasStudio/,那个变量没设的话就是 ~/.config/CelasKanvasStudio/

里面:license.dat 装着你的许可证密钥和它缓存下来的状态,auth.json 装着你的 celas.studio 登录令牌和资料。在 Windows 上,一份由更早的构建保存在安装文件夹里的许可证,为了兼容照样读得到。

安全地重置一个文件

请先关掉 Celas Studio:这里每一个文件都是在正常退出或者保存时写出去的,所以在这个软件开着期间编辑或删掉其中一个,只会被覆盖回来。

  • 面板布局或首选项出了问题:删掉 celaskanvas_ui.cfg(停靠布局本身是问题的话再删 imgui.ini)。两个都会在下次启动时按默认值重建。
  • 快捷键:更稳妥的路子在软件里面(首选项 ▸ 快捷键 ▸ 全部恢复默认值),它不需要重启。手工删掉 shortcuts.cfg 效果是一样的。
  • 一个你不想要的工作区:在 窗口 ▸ 工作区 底下右键它并挑删除,它会先问一句、也会说出那个工作区的名字,或者直接把它的 .ini 从 workspaces 文件夹里移走,那样不会问。两种都撤不回来。
  • 自定义画笔:celasstudio_brushes.cbrushset 是那份工作副本。画笔面板库菜单里的导出画笔集… 会写出一份你可以再导入回来的备份,所以在删掉任何你还想要回来的东西之前,请先用它。
  • 色板:请先用色板面板菜单 ▸ 导出 存一份 .json 备份,因为删掉 swatches_library.json 会把这个库清空,而软件里面没有什么能把它还原回来。
  • 一个卡住的或者不想要的自动保存:删掉项目旁边那个 .autosave.cls 文件,或者在启动时那条恢复提示里回答「全部丢弃」。它从来只是一份恢复副本,所以移走它动不了真正的项目文件。
除了快捷键之外,首选项没有应用内的「恢复默认值」按钮:重置 celaskanvas_ui.cfg、色板库或者画笔集,意味着关掉这个软件、自己去把那个文件删掉。