二、API Spec - Environment 环境(Photopea API 文档翻译)

260 阅读4分钟

编辑器的外观可以通过 JSON属性environment进行自定义。

{
	...
	"environment" : {          
		"theme"     : 2,         "lang"     : "es",    
		"vmode"     : 0,         "intro"    : true,
		"eparams"   : { "guides" :true, "grid" : true, "gsize": 8,   
		                                "paths": true, "pgrid": true },
		"customIO"  : { "open": "app.echoToOE("Open");" },
		"localsave" : false,     "autosave" : 120,    
		"showtools" : [0,5,9],   "menus"    : [ [1,1,0,1], 1, 0, 1, [0] ],
		"panels"    : [0, 2],
		
		"phrases"   : [ [1,0], "Open Design", [1,2], "Save Design" ],
		
		"topt"  : {  "t0": ...,  "t1": ...,  ... },
		"tmnu"  : {  "t0": ...,  "t1": ...,  ... },
		"icons" : {  "tools/crop": "https://www.me.com/img/crop.png",  ... },
		"plugins":[ ... ]
	}
}

每个参数都是可选的。它们具有以下含义:

  • theme- 主题 (0, 1, 2, ...)

  • lang- 语言

  • vmode- 视图模式。0:常规,1:面板折叠,2:隐藏所有面板

  • intro- 当没有打开文档时,显示介绍面板(带按钮等)

  • eparams- 附加功能:启用或禁用指南,网格,路径,像素网格...

  • customIO- 重新定义File-Open、 Save等,并运行自定义脚本。可能的属性:。"new", "open", "openFromURL", "takePic", "showTemplates", "save", "saveAsPSD", "publishOnline", "exportLayers"

  • localsave- 启用/禁用“另存为PSD”,“保存为web”和“在线发布”

  • autosave- 如果值为 X,Photopea将每X秒执行“File-Save”

  • showtools- 仅显示以下工具(请参阅下面的工具 ID)

  • menus- 指定具有0/1标志的文件、编辑、图像... 菜单的结构。
    数组的每个元素要么是 0:隐藏项目,
    要么是 1:显示具有标准内容的项目,
    要么是子元素的标志数组(递归工作)。
    如果数组短于要求,则末尾将添加零。查看Photopea的当前菜单结构,找到正确的值。例如,
    [1,1]作为第一个元素,“File”菜单将仅显示“New”和“Open”项目。

  • panels- 哪些面板应该显示在侧边栏中。使用以下 ID:
    0:历史记录,1:色板,2:图层,3:信息,4:直方图,5:属性,6:CSS,7:画笔,8:图层组合,9:字符,10:段落,11:操作,12:导航器,13:颜色,14:TPRESET,15:GUIDEGUY,16:通道,17:路径,18:调整,19:字形,20:内存,21:样式,22:注释。

  • phrases- 允许你用自己的短语替换 Photopea 境内的任何短语。这个数组的格式为 [ ID1,W1,ID2,W2,... ],其中 IDx 是某个短语的 ID,Wx 是一个(用来替换的 )新短语。
    一些有用的 ID:
    [1,2]:保存(文件菜单),
    [2,0]:前进一步,
    [2,1]:后退。
    要发现其他短语的ID,请熟悉OpenWord表结构并在当前短语数据库中查找您的短语(var LNG ...),或者只是给我们写一封电子邮件以 support@photopea.com

  • topt- 工具选项。用于更改每个工具的设置。键为“tXY”,其中 XY 是工具 ID。每个工具都有自己的格式(见下文)。

  • tmnu- 工具菜单。用于指定每个工具的顶部菜单的结构。键为“tXY”,其中 XY 是工具 ID。每个工具都有自己的格式(见下文)。

  • icons- 自定义图标。每个图标都有一个图标 ID(key)和图像 URL(value## 工具选项和菜单)。你可以在这里找到图标ID(var PIMG ...)。例如,裁剪工具有一个ID“工具/裁剪”。在介绍屏幕上,徽标是“徽标”,底部是“底部”。

  • plugins描述这里

工具选项和菜单

移动工具

选项:[1,0,null]。三个值表示自动选择、变换控制和距离。1 表示已启用,0:已禁用,空:未指定。

菜单:[1,1,1,1,1,1]。显示/隐藏六个项目的六个标志: 自动选择,转换控件,距离,快速保存(获取PNG...),垂直对齐,水平对齐。

魔棒 Magic Wand

选项:[0,0,[16,true,true]] - 组合操作、羽化、选择选项:容差、消除锯齿、连续。

工具ID

  • 0:移动工具
  • 1:矩形选择
  • 2:椭圆选择
  • 5: 套索选择
  • 6:多边形套索选择
  • 7:磁性套索选择
  • 8:快速选择
  • 9: 魔杖
  • 10:裁剪工具
  • 14: 吸管
  • 16: 标尺
  • 18: 斑点修复刷工具
  • 19: 修复画笔工具
  • 20: 补丁工具
  • 23: 画笔工具
  • 24: 铅笔工具
  • 27:克隆工具
  • 31: 橡皮擦工具
  • 34: 渐变工具
  • 35: 油漆桶工具
  • 36:模糊工具
  • 37: 锐化工具
  • 38: 涂抹工具
  • 39: 减淡工具
  • 40: 刻录工具
  • 41: 海绵工具
  • 47: 打字工具
  • 42: 钢笔
  • 43:免费笔
  • 51:路径选择
  • 52:直接选择
  • 54: 矩形
  • 55: 椭圆
  • 57: 线
  • 56: 参数化形状
  • 58: 自定义形状
  • 59: 手动工具
  • 61: 缩放工具