MyBox宏命令（未完待续）

1 宏命令的用途

“宏命令”指用命令行来执行操作，指令及其参数均在命令行里给定，而不是由用户在交互式界面中输入或选择。

2 执行宏命令

宏命令可以按以下方式来执行：

不启动MyBox图形界面，执行操作并输出结果。
例如，在系统的命令行窗口中，执行：
java -jar .\MyBox.jar image sharp algorithm=four color=keep edge=copy inputFile='D:\MyBox测试\图片\v1.png' outputFile='D:\临时\2\v1_sharp_4neighborg_keep_copy.png'
MyBox宏命令可以成为用户shell脚本的一部分，也有利于批处理。
在MyBox图形界面下，执行操作并显示结果。
例如，在MyBox的宏命令管理窗口中，执行：
image sharp algorithm=mask color=grey edge=zero inputFile='D:\MyBox测试\图片\v1.png' outputFile='D:\临时\2\v1_sharp_mask_grey_zero.png'
MyBox按树形管理宏命令，并提供示例，包含了MyBox大多数功能的重要参数组合。

3 宏命令的格式

MyBox宏命令的如下：

功能名操作名参数1 参数2 ... 参数n

即：宏命令由空格分割的字符串组成，其中第一个字符串是功能名，第二个字符串是操作名，其它字符串是多个参数。
参数可以是“参数名=参数值”、或是单纯的参数值。
若参数值包含空格，则它应该被双引号或单引号围起来。
若参数有缺省值，则可以省略。
功能名、操作名、参数名均是预定义的，如果查不到则是非法宏。
有的参数值是预定义的，如果查不到则是非法宏。
功能名、操作名、参数名均为大小写不敏感，有的参数值也大小写不敏感。

4 通用参数

以下参数适用于所有功能和操作：

参数名	参数值	缺省值	说明
inputFile	文件的完整路径	MyBox示例文件	要处理的文件若不定义此参数，则引用MyBox的示例文件。
outputFile	文件的完整路径	MyBox临时文件	要生成的文件。若不定义此参数，则用MyBox缺省方式生成对象。
openResult	true：打开结果 false：不打开结果	命令行执行宏命令时，缺省值为false 图形化执行宏命令时，缺省值为true	是否打开结果

5 图像处理（image）

图像处理的“功能名”均是“image”，以下只介绍操作名及其参数。

5.1 编辑（edit）

操作名是“edit”，有效参数是“inputFile”，参数“outputFile”被忽略。

引用示例图像：

image edit

参数示例：

image edit inputFile='D:\MyBox测试\图片\v1.png'

5.2 换色（replace）

操作名是“replace”，参数：

参数名	参数值	缺省值	说明
color	颜色的web值如“#0000FF”、“hsla(270,100%,100%,1.0)”		被匹配的颜色
newColor	颜色的web值如“0x0000FF”、“rgba(0,0,255,1.0)”		被替换成的新颜色
invert	true：反选 false：正选	false	是否反选颜色
trans	true：处理 false：不处理	false	是否处理透明像素
algorithm	RGBRoughWeightedEuclidean：RGB简单加权欧几里得 RGBWeightedEuclidean：RGB加权欧几里得 RGBEuclidean：RGB欧几里得 Red：红色 Green：绿色 Blue：蓝色 Hue：色相 Saturation：饱和度 Brightness：亮度 RGBManhattan：RGB曼哈顿 CIE76: LUV色彩空间 CIEDE2000: 色差公式 CIE94: 色差公式 HSBEuclidean: HSB欧几里得 CMC: 色差公式	RGBRoughWeightedEuclidean	匹配颜色的算法
threshold	浮点数	各算法的缺省阈值	匹配颜色的阈值
hueWeight	浮点数	各算法的缺省权重	色相权重。只对以下算法有效：CIEDE2000、CIE94、HSBEuclidean
brightnessWeight	浮点数	各算法的缺省权重	亮度权重。只对以下算法有效：CIEDE2000、CIE94、HSBEuclidean、CMC
saturationWeight	浮点数	各算法的缺省权重	饱和度权重。只对以下算法有效：CIEDE2000、CIE94、HSBEuclidean、CMC
hue	true：替换色相 false：不替换色相	true	是否替换色相
brightness	true：替换亮度 false：不替换亮度	false	是否替换亮度
saturation	true：替换饱和度 false：不替换饱和度	false	是否替换饱和度

引用示例图像：

image replace color=0xfa7094 newColor=0x7777FF outputFile='D:\临时\2\example_replace.png'

参数示例：

image replace color=0xfa7094 newColor=0x3377CC   algorithm=CMC  threshold=1  inputFile='D:\MyBox测试\图片\v1.png' outputFile='D:\临时\2\v1_replace_cmc_w6.png'

5.3 锐化（sharp）

操作名是“sharp”，参数：

参数名	参数值	缺省值	说明
algorithm	four：四邻域拉普拉斯 eight：八邻域拉普拉斯 mask：反锐化掩码	mask	锐化的算法
color	keep：保持 grey：灰色 blackwhite：黑白色	keep	对颜色的转换
edge	copy：复制 zero：填零	copy	对边缘像素的处理
intensity	整数，建议小于5	2	卷积半径。只对算法“反锐化掩码”有效。

引用示例图像：

image sharp outputFile='D:\临时\2\example_sharp.png'

参数示例：

image sharp algorithm=eight color=blackwhite edge=zero inputFile='D:\MyBox测试\图片\v1.png' outputFile='D:\临时\2\v1_sharp_8neighborg_bw_zero.png'