ImageMagick 示例 --
图像变换

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          shade_circle_mask.gif
  magick shade_circle_mask.gif            -shade 120x45  shade_blur_0.gif
  magick shade_circle_mask.gif -blur 0x1  -shade 120x45  shade_blur_1.gif
  magick shade_circle_mask.gif -blur 0x2  -shade 120x45  shade_blur_2.gif
  magick shade_circle_mask.gif -blur 0x3  -shade 120x45  shade_blur_3.gif
  magick shade_circle_mask.gif -blur 0x4  -shade 120x45  shade_blur_4.gif
  magick shade_circle_mask.gif -blur 0x5  -shade 120x45  shade_blur_5.gif

magick shade_blur_3.gif -normalize shade_blur_3n.gif

magick shade_blur_3n.gif shade_circle_mask.gif \ -alpha Off -compose CopyOpacity -composite shade_blur_3n_mask.png

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          -blur 0x2  -shade 120x30           shade_30.png
  magick shade_30.png   -gravity center -crop 1x1+0+0 txt:-

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          -blur 0x2  -shade 120x30 -normalize   shade_30_norm.png
  magick shade_30_norm.png   -gravity center -crop 1x1+0+0 txt:-

  magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \
          -blur 0x2  -shade 120x21.78 -normalize   shade_21_norm.png
  magick shade_21_norm.png   -gravity center -crop 1x1+0+0 txt:-

magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \ \( +clone -blur 0x2 -shade 120x21.78 -normalize \) \ +swap -alpha Off -compose CopyOpacity -composite shade_tint_0.png magick shade_tint_0.png -fill grey50 -colorize 10% shade_tint_10.png magick shade_tint_0.png -fill grey50 -colorize 30% shade_tint_30.png magick shade_tint_0.png -fill grey50 -colorize 50% shade_tint_50.png magick shade_tint_0.png -fill grey50 -colorize 80% shade_tint_80.png

除了线性渐变高光之外，另一种方法是使用S型非线性对比度来减少高光的整体效果，同时保留高光中极亮/极暗的点。这应该可以让高光效果看起来更“自然”，并且可以使高光更亮，就像表面更具反射性一样。但是，为了使这种技术更有效，我们需要确保阴影结果中没有纯白色和黑色。这可以通过首先使用“-contrast-stretch”的'0%'而不是“-normalize”，以及像上面那样对结果进行少量反归一化来实现。这似乎只是增加了高光叠加图像生成的复杂性，但强调高光中的亮点使额外的处理值得付出努力。例如……如您所见，整体高光强度降低了，但反射光产生的亮点仍然像以前一样亮，只是尺寸减小了。结果是形状看起来更自然的“有光泽”。这种技术的唯一缺点是也会生成阴影“斑点”，但这通常不那么明显。最后，我们可以将“高光点”与整体高光减少相结合，以生成一组高度可配置的高光叠加生成器控件……

magick -size 50x50 xc:black -fill white -draw 'circle 25,25 20,10' \ \( +clone -blur 0x4 -shade 120x21.78 -contrast-stretch 0% \ +sigmoidal-contrast 7x50% -fill grey50 -colorize 10% \) \ +swap -alpha Off -compose CopyOpacity -composite shade_overlay.png

总之，上面的示例有四个单独的控件……

"blur"：圆化形状边缘（0.001=斜角 2=平滑 10=圆角）

"shade"：光线照射的方向（120=左上方 60=右上方）

"sigmoidal"：表面反射控制高光点（1=平坦 5=良好 10=反射）

"colorize"：高光的整体对比度（0%=明亮 10%=良好 50%=暗淡）

注意，虽然上面的例子已经形成原始的“圆形”形状，但透明度应该只在应用'Overlay'合成后恢复，而不是之前。此外，如果您计划对相同形状重复使用高光（在执行任何旋转后），您可以为计划使用的每个形状预先生成高光叠加，并将结果保存以供多次重复使用。在IM讨论论坛中，从平面源图像生成3D DVD封面就是这种阴影叠加重复使用的一个例子。我还强烈建议您尝试以上技术，因为它们是使您的平面形状图像看起来更逼真的关键。如果您想出其他突出显示的想法，请告诉我。

FUTURE:
   Color Tinting the Overlay image
   Overlay Alpha Composition with an Image

使用黎明阴影高亮

在上面蒙版阴影图像中，我们展示了“中午”或“正午”阴影图像（使用'90'的仰角）如何可以用于蒙版以及"-shade"产生的效果的位置和范围。但是，形状的水平或“黎明”阴影图像（使用'0'的仰角）也相当有用。例如，它可以用作白色或黑色图像的蒙版，以在形状上生成单独的高光和阴影效果。这还可以用于确保形状获得大致相等数量的明暗区域（甚至不相等的数量），因为我分别生成它们，但以完全受控的方式。

FUTURE: more detail here

请参阅第一个高级3D徽标，了解使用此技术的示例。

---

使用FX，DIY图像操作符

图像列表操作符"-fx"是一个通用的DIY操作符，它不属于任何特定类别的IM操作符，因为它可以用于创建几乎任何图像操作。在这些页面中可以看到其用法的示例，但在这里我们将专门关注其功能以及如何使用它们。该命令在其功能方面非常通用，它可以：

• 创建画布、渐变、数学颜色映射。
• 在图像和通道之间移动颜色值。
• 以几乎所有可以想象的方式调整图像颜色。
• 平移、翻转、镜像、旋转、缩放、剪切并通常扭曲图像。
• 将多个图像合并或合成在一起。
• 以奇特而奇妙的方式平铺图像。
• 卷积或合并相邻像素。
• 生成图像度量或“指纹”。
• 以不寻常的方式比较图像。

当然，许多这些技术已经是IM的一部分，可以产生更快、更灵活的结果。但是，如果它不是内置的，"-fx"允许您生成所需操作的自己的版本。事实上，我以及其他人经常使用它来制作新操作的原型，这些操作后来被构建到IM的核心库中。例如，请参阅DIY新的有序抖动替换，我使用"-fx"开发了-ordered-dither"操作符的修订版本。该操作符本质上允许您对一个或多个图像执行自由形式的数学运算。有关该命令的官方摘要，请参阅FX，特殊效果图像操作符，网址为ImageMagick网站。

FX 基本用法

该命令接受任意数量的输入图像的图像序列。通常是一个或两个图像，并将所有输入图像替换为第一个图像的副本，该副本已由"-fx"函数的结果修改。也就是说，第一个图像中的任何元数据都将保留在"-fx"操作符的结果中。为了便于数学使用，所有提供的颜色值都归一化为0.0到1.0的值范围。结果也应在此范围内。这包括透明度或alpha通道，它从0.0（表示完全透明）到1.0（表示完全不透明）。这些值表示“alpha透明度”，实际上是IM通常在内部存储透明度（作为遮罩值）的反值。然而，以这种形式在数学上更正确且更容易使用。"-channel"设置定义了第一个（也称为“第零”或“u”）图像中的哪个通道将被"-fx"操作符的结果替换。默认情况下，这仅限于原始图像的颜色通道（'RGB'）。除非更改"-channel"设置以包含alpha（'A'）通道，否则该图像中任何现有的透明度都不会被修改。对于每个像素执行一次表达式，以及对正在处理的像素中的每个颜色通道执行一次。此外，由于每次执行表达式时都会重新解析它，因此复杂的表达式在大型图像上可能需要一些时间才能处理。例如，这里我们定义了一个黑色图像，但随后将蓝色通道设置为一半亮度以形成“海军蓝”颜色。

magick -size 64x64 xc:black -channel blue -fx '1/2' fx_navy.gif

在这里，我们采用黑白渐变，然后将蓝色和绿色通道设置为零，因此它变成了黑色-红色渐变。

magick -size 64x64 gradient:black-white \ -channel blue,green -fx '0' fx_red.gif

为了使"-channel"设置更像"-fx"操作符，它将接受字母'RGBA'的任何组合来指定操作符要限制其操作的通道。 这意味着要将"-fx"的输出限制为仅蓝色和绿色通道，您现在可以说"-channel BG"而不是更长的"-channel blue,green"。

我们本可以在不使用"-fx"的情况下生成上述示例，但能够对现有图像执行此操作使它成为一个强大的图像操作符。事实上，该函数可以读取和使用当前内存中图像序列中任何图像的任何像素或特定颜色。第一个“零”图像被赋予“u”的特殊名称。第二个图像“v”。内存中的其他图像可以通过索引引用。因此，“u[3]”是当前图像序列中的第四个图像，而“u[-1]”是序列中的最后一个图像。这与图像列表操作符使用的相同索引方案相同，因此您应该得心应手。如果没有给出其他限定符，则使用的颜色值与指定图像中使用的颜色值相同。也就是说，除非您明确表示要使用红色，否则它将使用命令在该时间处理的颜色通道的颜色值。也就是说，在处理蓝色通道时，它将应用蓝色颜色值的表达式。除非另有说明，否则它将处理图像中每个像素的每个RGB颜色值（由默认的"-channel"设置设置）。也就是说，3*w*h个计算，这些计算通过给定的表达式修改图像中的所有值。例如，这里我们采用IM内置的“rose:”图像并将所有像素值乘以50%。

magick rose: -fx 'u*1.5' fx_rose_brighten.gif

在上面的示例中，每个单独的红色、绿色和蓝色值都乘以1.5。如果结果值超出0到1的范围，它将被限制在适当的边界（在本例中为1.0），除非您使用默认的ImageMagick的HDRI版本。在数学颜色调整和直方图曲线中探讨了许多其他“-fx”公式来重新着色图像。由于我们还可以将当前图像序列中的任何图像作为修改第一个图像的表达式的一部分进行引用，因此我们可以以几乎任何我们想要的方式合并两个或更多图像。在这里，我们通过将黑色-蓝色渐变（旋转）中的蓝色通道复制到上面生成的以前的黑色-红色渐变中，生成一个黑色-红色-蓝色颜色图表图像。

当然，我们可以使用通道复制合成方法，这会快得多。但这不是重点。 虽然反之亦然。几乎所有IM图像操作都可以用FX等效函数替换。

现在上面的第二个图像仅用作源图像。真正发生的是"-fx"首先只创建第一个图像的副本。然后它根据公式修改该图像，使用所有其他给定的图像。最后，它放弃所有输入图像，并用第一个图像的修改副本替换它们。您还可以根据图像中每个像素的位置计算值。值'i,j'是正在处理的像素的当前位置，而'w,h'给出图像的大小（第一个图像，除非给出了特定图像限定符）。例如，这里我们生成一个DIY渐变图像。

magick rose: -channel G -fx 'sin(pi*i/w)' -separate fx_sine_gradient.gif

或者使用'i,j'位置值的其他更复杂的东西。 magick -size 80x80 xc: -channel G -fx 'sin((i-w/2)*(j-h/2)/w)/2+.5'\ -separate fx_2d_gradient.gif

在生成灰度渐变时，只需要求它只处理一个颜色通道（例如上面示例中的“G”或绿色通道），就可以使 -fx 运算符的速度提高约 3 倍。然后可以将此通道分离以生成最终的灰度图像。这可以带来非常大的速度提升，尤其是在使用非常复杂的“-fx”公式时。有关更多 FX 生成的渐变，请参见示例自定义渐变。您可以使用位置信息使用“p{x,y}”语法从源图像中查找特定像素。例如，您可以轻松地创建自己的“镜像”类型函数（如“-flop”图像运算符），该函数用原始源的“镜像”位置的颜色值替换每个像素。

magick rose: -fx 'p{w-i-1,j}' fx_rose_mirror.gif

这种类型的“图像扭曲”通过创建扭曲图像映射或其他类型的以图像形式的值查找表而变得更加强大。在DIY 抖动图案和阈值映射中提供了执行此操作的示例，其中 FX 用于将特定颜色替换为其他图像中的图案。现在，FX 表达式生成的最终图像的大小与给定的第一个图像相同，因此要生成更大的图像，您需要将第一个图像设置为所需的大小。在这种情况下，第二个图像（甚至第三个图像）可以用作颜色源（因此在下一个示例中交换）。例如，这里我们调整 rose 图像的大小（使用插值缩放或调整大小）以生成更大的图像。

magick rose: -size 120x80 xc: +swap \ -fx 'v.p{ (i+.5)*v.w/w-.5, (j+.5)*v.h/h-.5 }' \ fx_scaled.png

请注意如何执行像素查找，它可能看起来很复杂，但它是缩放（扭曲）图像的正确方法。基本上，添加到表达式中的所有额外的“0.5”值都需要在用于输入坐标“i,j”的像素坐标和位置查找“v.p{...}”之间正确地进行映射，而更数学上正确的图像坐标则需要用于实际的数学计算（缩放）。上面实际上是任何形式的图像扭曲所使用的确切方法。您可以通过打开详细扭曲摘要来查看大多数扭曲的 FX 等效项。这报告了大多数图像扭曲的 FX 等效项，作为一种双重检查扭曲是否按预期执行的方式。使用FX DIY 运算符进行图像扭曲，显示了该运算符的强大功能。如果不是因为这个运算符，我怀疑许多新的操作，例如扭曲、稀疏颜色或有序抖动，是否会添加到 ImageMagick 核心库中。这里有一些更简单的东西，交换 rose 图像的红色和蓝色通道。看看你是否能弄清楚它是如何工作的。

magick rose: \( +clone -channel R -fx B \) \ +swap -channel B -fx v.R fx_rb_swap.gif

执行相同操作更快更好的方法是使用“-separate”和“-combine”)。请参见组合 RGB 通道图像。或者，您还可以使用“-color-matrix”以更快地执行相同操作。 你在这里看到趋势了吗？

作为默认的“-channel”设置，它将“-fx”运算符的输出限制为三个颜色通道。这意味着如果您想影响 alpha 或透明度通道，则必须通过更改通道设置来显式指定它。例如，让我们通过将所有 alpha 通道值设置为一半来创建一个半透明的“rose:”图像。

magick rose: -alpha set -channel A -fx '0.5' fx_rose_trans.png

请注意，为了使上述操作正常工作，我需要确保“rose:”实际上有一个 alpha 通道，以便“-fx”可以处理它。我是用Alpha 通道控制运算符来实现的。“-fx”运算符能够操作图像的 RGBA 通道，这使得它非常适合操作通道和蒙版。
从 IM 6.2.10 开始，您可以向“-fx”表达式添加变量赋值，这使您可以减少某些表达式的复杂性，否则这些表达式基本上是不可能的。例如，这里我根据距特定点（分配给变量“xx”和“yy”）的距离创建渐变。如果没有使用变量，这个公式可能会变得非常难以阅读。

magick -size 100x100 xc: -channel G \ -fx 'xx=i-w/2; yy=j-h/2; rr=hypot(xx,yy); (.5-rr/70)*1.2+.5' \ -separate fx_radial_gradient.png

由于“-fx”使用的简单标记化处理，变量名只能包含字母，并且不能包含数字。此外，由于许多单个字母用于访问图像信息的内部变量，因此建议变量名至少为两个字母长。因此，我使用“xx”和“yy”而不是“x”或“y”。

“-fx”函数 'rr=hypot(xx,yy)' 已添加到 IM v6.3.6 中，以加快非常常用的表达式 'rr=sqrt(xx*xx+yy*yy)' 的速度。 当然，如果您需要距离的平方，则应避免使用 'hypot()' 函数及其隐含的 sqrt() 函数。

有关一些真正复杂表达式的更多示例，请参见更复杂的 DIY 渐变，如果没有多语句赋值，这些表达式将是不可能的。对于透视扭曲的 FX 形式也是如此。从 IM 版本 6.3.0-1 开始，“-fx”表达式的复杂性开始需要外部文件，因此标准的“@filename”现在可以用于从文件中读取表达式。

echo "u*2" | magick rose: -fx "@-" fx_file.png

这也意味着您可以使用更复杂的脚本为特定作业生成特定的 FX 表达式。在内部，文件只是简单地读入一个字符串并像往常一样解释。对“-fx”很重要的其他设置是“-virtual-pixel”和“-interpolate”。虚拟像素设置允许人们设置当查找坐标超出输入图像覆盖的区域时应返回的颜色或图像结果。这允许人们为模糊等内容设置边缘效果，以及在更大区域上平铺图像。插值设置允许人们指定当查找坐标（浮点值）落在输入图像中像素的整数坐标之间时，IM 应该如何混合相邻像素的颜色。有关更多信息，请参见插值像素查找。

在不同的时间添加了一些更多功能 IM v6.3.6：hypot() IM v6.7.3-4：while()、not()、guass()、squish()

FX 调试

'debug(expr)' 本质上是一种打印浮点值的方法，每次计算 FX 表达式时都会打印一次。这反过来提供了一种调试表达式的办法。但是，您可以通过使用三元 if-else 表达式来限制“debug()”的输出。例如，这将打印内置“rose:”图像中像素 10,10 的浮点颜色值。通过使用 'NULL:' 图像处理程序来忽略实际的图像结果。

magick rose: -fx 'i==10&&j==10?debug(u):1; u' null:

请记住，输出在标准错误上，而不是正常的标准输出，这样您就可以在命令管道中使用它，而不会出现问题。请注意 FX 表达式是如何执行三次的，一次针对每个通道，仅针对该一个像素。将此乘以像素数，您可以想象如果“debug()”不限于单个像素，即使对于这张小图像，输出的长度也会有多长。

类似 FX 的内置操作

-fx 运算符表示一种开发以前在 ImageMagick 中不存在的新图像处理函数的方法。用户进行此类开发的结果使 ImageMagick 能够扩展，并具有新的功能和方法，例如颜色查找表（“-clut”）。但是，通常一旦使用“-fx”稳定了新方法，该表达式就会转换为更快的内置操作，通常作为一组类似运算符的一部分添加。这些包括以下通用图像运算符及其方法...

-evaluate	直接像素、颜色值、通道修改函数。 (见下面的Evaluate)。
-function	更复杂的像素、颜色值、通道修改函数。 (见下面的Function)。
-evaluate-sequence	以数学方式合并多图像序列的图像 (见下面的Evaluate-Sequence)。
-sparse-color	通用图像重新着色运算符。 (见稀疏颜色渐变)
-compose	通用多图像组合和叠加方法。 (见Alpha 合成)。
-distort	通用图像扭曲运算符，使用反向像素映射。 (见扭曲运算符)
-morphology	通用区域效果卷积/形态学函数。 (见形态学运算符和卷积运算符)

当人们开发新型图像操作时，他们通常首先使用“-fx”运算符对其进行原型设计。当他们完成了该“方法”的制定后，该方法将转换为 ImageMagick 核心库中的新超快速内置运算符。欢迎用户贡献他们认为对 IM 有用的自己的“-fx”表达式（或其他已定义的函数），但这些函数尚未被其他图像运算符涵盖，如果它们可以由上述通用运算符之一处理，则应该很容易添加它。例如，我自己需要一种“如果颜色相似则屏蔽”类型的操作来比较两张图像。这已作为新的“-compose”方法“ChangeMask”添加。这反过来让我能够为 GIF 动画添加更复杂的透明度优化。“-fx”的速度和复杂性开始成为问题，那么最好转向 API 脚本语言（如 PerlMagick）。使用 PerlMagick 的一个示例“pixel_fx.pl”是该 API 发行版的一部分。

FX 表达式作为格式和注释转义

从 IM 版本 6.2.10 开始，您现在可以在图像属性转义字符串（例如“-format”和“-annotate”参数使用）中使用FX 表达式。转义序列“%[fx:...]”被替换为一个数字作为浮点值，在当前图像序列中的每个图像上计算一次。FX 表达式在处理期间会稍作修改。具体来说...

• 当前像素坐标“i”、“j”固定为值 0，因此，除非使用“p{}”索引，否则图像变量本身仅返回像素 0,0 的值。
• 除非选择颜色通道，否则仅返回红色通道值。
• 默认图像引用“s”设置为当前图像，正在对其进行注释或识别。
• 索引“t”返回由“s”引用的图像的索引。

在 IM v6.6.8-6 之前，"t" 图像索引和 "n" 图像总数的 FX 表达式值都存在问题，并且对于所有图像都只分别返回 0 和 1 的值。 '%p' 和 '%n' 的百分比转义符也存在相同的问题。

例如，这里我使用 "-annotate" 命令在每个图像上标注了其左上角像素的颜色。

magick -size 150x25 xc:DarkRed xc:Green xc:Blue \ -fill white -gravity center \ -annotate 0 '%[fx:t] / %[fx:n] : %[fx:r],%[fx:g],%[fx:b]' \ annotate_fx_%d.gif

注意，每个图像上写入的文本都不同，因为 'r' 实际上等价于 's.p{0,0}.r'。'g' 和 'b' 颜色通道值也是如此。当然，每个值都返回 0.0 到 1.0 范围内的归一化值。为了使特定像素颜色值的输出更容易，在 IM v6.3.0 中也添加了一个 '%[pixel:...]' 转义符。此运算符对每个图像的每个通道调用一次给定的 FX 表达式，并将返回值格式化为 IM 可以处理的颜色参数。您可以使用 "-format" 选项与 "identify" 命令直接输出结果。

magick identify -format '%[fx:atan(1)*4]' null:

这将数学计算并返回 PI 的值，尽管此值可作为内置变量 'pi' 使用。您可以生成随机数。例如，要生成一个介于 -5 到 10（包含 -5 和 10）之间的整数。这里我使用 "info:"，它等价于 "magick identify" 命令。

magick xc: -format '%[fx:int(rand()*16)-5]' info:

有关更多方法，请参阅 识别替代方案：文本输出选项。另请参阅 带圆角的边框，它使用 FX 表达式 根据图像宽度和高度信息生成绘制字符串。您可以 使用 FX 公式计算图像位置，甚至可以使用其他图像的大小和位置进行定位（请参阅 增量计算的位置）。您还可以在 文件名百分比转义符 中使用 FX 转义符 来根据计算值生成新文件。有关示例，请参阅 平铺裁剪 中的最后一个示例。
以上所有操作实际上都会对当前图像序列中的每个图像运行 "-format" 命令，以及任何包含的 FX 表达式。 "-print" 运算符的工作方式与 "-identify" 类似，但它只运行一次，并且可以访问当前图像序列中的所有图像。使用此运算符，您可以使用 'u[{i}]' 访问任何图像的值，这与上面提到的不同。
Fx 表达式可以应用于其他颜色空间的图像，因此我可以例如找出三种不同颜色的 '色相' 值（在 '红色' 通道中）。

magick xc:red xc:green xc:blue -colorspace HSL \ -format '%[fx: s.r ]\n' info:

您还可以使用 IM 进行一些直接的颜色数学运算，例如找出 'gold'、'yellow' 和 'khaki' 的平均颜色。

magick xc: -format '%[pixel:(gold+yellow+khaki)/3]' info:

虽然这显示了颜色与三个源颜色相比的样子，但...

magick xc:gold xc:yellow xc:khaki +append \ \( xc: -fx '(gold+yellow+khaki)/3' \) \ -scale 90x30\! -append fx_hues.png

您还可以使用 "-print" 打印信息。这仅对整个图像序列应用一次。这意味着您可以使用此运算符计算涉及多个图像的更复杂的 '%[fx:...]' 表达式。

访问其他图像中的数据

然而，使用 FX 转义表达式存在一个严重的问题。当您创建图像时，IM 无法直接访问当前图像序列中的其他图像。在典型的图像创建过程中，通常不需要这样做，因为新图像通常不依赖于以前内存中的图像。基本上，如果您想获取不同图像中特定像素的颜色（如上所示），或者正在创建新图像，那么 IM 核心函数与所需信息没有直接关联。例如，如果您尝试使用内置 "rose:" 图像像素 12,26（一个蓝色的像素）的颜色创建标签，则直接方法将失败！

magick rose: label:'%[pixel:p{12,26}]' -delete 0 label_fx_direct.gif

好吧，rose 图像实际上不包含任何黑色像素，因此以上结果是错误的。解决此问题的办法是提取所需的信息并将其保存到全局 IM 元数据中。此信息将传递给库核心中的所有子例程，包括图像创建的子例程。

magick rose: -set option:mylabel '%[pixel:u.p{12,26}]' -delete 0 \ label:'%[mylabel]' label_fx_indirect.gif

这并不直观，但我们现在得到了正确的结果。特殊的 'option:' 标签告诉 "-set" 选项，您希望将给定的设置保存为全局 工件，而不是作为图像 '属性' 或 '特性' 字符串，就像 "-define" 一样。但是，"-set" 形式允许您在设置 工件 时扩展 百分比转义符，而 "-define" 则不允许。当 "label:" 运算符扩展其百分比转义符时，首先会查找给定的 '键' 作为每个图像的 '属性' 或 '特性'，但如果找不到任何内容，则会查找全局 工件 设置中的 '键'。因此，即使在创建 工件 时该图像不再存在，也会使用我们从前一个图像创建的全局 '工件'。基本上，'工件' 设置在 "magick" 命令的生命周期内是全局的，因此可用于将信息从一个图像传递到另一个图像。对于编程 API，可以避免这种情况，因为您可以直接从图像中读取所需的数据并自己生成标签字符串，而无需 IM 以如此复杂的方式存储这些信息。

---

评估和函数，自由形式通道修改器

因为 FX 运算符 是一个解释型表达式处理器，所以添加了 "-evaluate" 运算符，以便您可以更快地进行简单的图像修改。后来，在 IM v6.4.8-8 中添加了一个更复杂的 "-function" 运算符，以允许在复杂的图像调整中具有更大的灵活性。这两个运算符以及其他 图像级别调整运算符（例如 "-negate"、"-level"）可能最适用于对灰度图像进行微调，然后再应用这些图像。尤其是在用于 背景去除、高光和阴影叠加 以及 图像映射 生成和微调的灰度图像中。

Evaluate，简单的数学运算

"-evaluate" 运算符基本上是 "-fx" 运算符的快速但非常简单的版本（实际上比它添加到 IM 中早了几个月）。但是，它仅限于使用单个用户提供的常数值进行一项简单操作。您可以使用以下命令找出哪些函数已内置到 evaluate 中：这包括典型的数学函数 'add'、'subtract'、'multiply' 和 'divide'。针对常数值。与 -fx 运算符不同，这些值不会规范化为 0 到 1 的范围，而是保持图像的真实颜色值。因此，在 Q8 IM 中减去 50 的值（请参阅 质量和深度 将导致大幅减小，但对于 Q16 版本的 IM，它只会是一个很小的、几乎不可察觉的变化。但是，如果您在参数中添加了 '%'，则该参数将表示最大颜色值的百分比（称为 'QuantumRange'，等于 ('2quality-1')。这意味着您可以通过适当使用百分比来使 "-evaluate" 参数与 IM 质量级别无关，适用于相应的 evaluate 方法。 例如，只需简单地将图像中的所有颜色值替换为 50% 的灰色级别非常简单且快速，使用 'Set'

magick rose: -evaluate set 50% rose_set_gray.gif

"-evaluate" 运算符还包括典型的数学函数 'add'、'subtract'、'multiply' 和 'divide'。 例如，要将图像的对比度减半，您可以将其 'divide' 除以 '2'，然后 'add' 加 '25%' 以将其重新居中到完美的灰色。

magick rose: -evaluate divide 2 -evaluate add 25% rose_de-constrast.gif

这比直接使用带有 'u/2+.25' 的 "-fx" 运算符快几个数量级。因此，如果可能，您应该优先使用此运算符而不是 "-fx"。 "-evaluate" 的主要问题是所有结果都被剪裁到 0 到 'QuantumRange' 的限制内（除非您使用的是 HDRI 版本的 ImageMagick），因为每个修改后的值都会保存回图像数据中。这意味着在任何单独的 "-evaluate" 操作之后，值可能会被 'QuantumRange' 剪裁。 因此，如果您尝试直接应用对比度增强函数（相当于 "-fx '2*u-.25'"），您将无法获得正确的结果，因为在进行减法之前，加倍的值将被剪裁。

magick rose: -evaluate multiply 2 -evaluate subtract 25% \ rose_contrast.gif

首先，'multiply' 将所有较大的颜色值剪裁到最大值，然后 'subtract' 将剪裁下限值。结果是对上限的错误剪裁，产生暗淡和颜色失真的结果。 直接解决方案是首先 'subtract' 减去适当的常数（对下限进行最终但正确的剪裁），然后再进行乘法，有效地使用等效公式 '(u-.125)*2'

magick rose: -evaluate subtract 12.5% -evaluate multiply 2 \ rose_contrast2.gif

但是，此“剪裁”问题有很多替代方案。第一个合乎逻辑的方案是较新的 多项式函数方法（见下文）。其他替代方案还包括使用 级别调整运算符 甚至 按颜色进行级别调整，只需指定您想要拉伸以填充整个颜色范围的原始颜色值即可。基本上，在使用多个 "-evaluate" 方法时，请注意颜色值剪裁。
"-evaluate" 运算符与 "-fx"（以及大多数其他低级 IM 运算符）一样受 "-channel" 影响。这允许您分别控制图像的 alpha 透明度与颜色通道。是的，与 "-fx" 一样，透明度被视为 'alpha 值'，而不是 '蒙版' 值。例如，要使图像透明 50%，作为 溶解 类型操作的一部分。

magick rose: -alpha set -channel A -evaluate divide 2 rose_transparent.png

结果是一个半透明的图像，这意味着在显示时，您看到的颜色有一半是网页的背景颜色。因此，显示的图像会朝向背景颜色变暗。通常，我还发现，在将各个通道分离成单独的图像以用于特定目的之前（请参阅 分离通道），在各个颜色通道上使用 "-evaluate" 通常更容易。例如，这里我使用它来进行快速但不寻常的灰度化。基本上，我将每个通道乘以适当的数量，然后将这些通道分离并加在一起，以生成使用特定颜色比例进行灰度化的图像。

magick test.png -channel R -evaluate multiply .2 \ -channel G -evaluate multiply .5 \ -channel B -evaluate multiply .3 \ -channel RGB -separate -background black -compose plus -flatten gray_253.png

Evaluate 数学函数

除了评估操作，ImageMagick 还包含一组特殊用途的数学函数。这些函数通常使用归一化的颜色值（0 到 1 的范围），输出结果也进行归一化，以适应图像的完整颜色范围。 S形对比度 函数也是这种数学函数拟合的一个例子。

幂运算

例如，“Pow” 函数（从 IM v6.4.1-9 版本开始添加）使用归一化的颜色值，允许用户修改图像亮度。它与 C 函数 pow() 完全等效，（使用 0 到 1 范围内的归一化颜色值）。

    value = pow(value, constant) 

因此，要创建“抛物线”渐变，可以使用参数“2”。或者使用值“0.5”来创建“平方根”渐变。例如……

下面三个图像显示了生成的渐变的曲线图和原始图像本身。这使得更容易看出一个渐变图像是如何修改成另一个的。它是使用 Gnuplot 图形绘制程序生成的，通过 IM 示例中的脚本“im_profile”，位于 Scripts 目录。

这实际上等同于 伽马校正 操作符，但参数反转了。例如，“-gamma 2” 操作相当于“-evaluate pow 0.5” 或“平方根”操作函数。类似地，“-gamma 0.5” 等于使用“-evaluate pow 2”进行平方。通过一些特殊的渐变操作，您可以使用此方法将线性渐变转换为复杂的圆弧。

magick -size 20x300 gradient: -rotate 90 \ -evaluate Pow 2 -negate -evaluate Pow 0.5 \ -flop \( +clone -flop \) +append eval_circle_arc.png

对于想要弄清楚这一点的人来说，上面代码的第二行等同于 FX 表达式 'sqrt(1-u^2)'。这生成一个四分之一圆弧，然后进行 翻转 和 拼接，以生成一个半圆弧。它也比使用 FX 表达式 快得多，即使它需要更多单独的（更小的）步骤。另请参阅更高级的 多项式函数。

对数运算

“Log” 函数（从 IM v6.4.2-1 版本开始添加）也使用归一化值（添加 1.0 以避免无穷大），其中给定的常数用作对数底数。实际公式（使用归一化值）如下……

    value = log(value*constant+1.0)/log(constant+1.0) 

例如...

magick gradient.png -evaluate Log 10 eval_log.png

这看起来可能与之前的 Pow 评估方法 非常相似，但并不完全相同。“Log” 在接近“0” 时会产生明显的斜率，而“Pow” 会产生垂直斜率。该值控制斜率。对数函数也与指数函数密切相关，指数函数目前仅作为 S形对比度调整 操作符实现。它包含与上面对数曲线中相同的斜率特征。这解释了为什么“-sigmoidal-contrast” 是一种比 伽马校正 或“幂运算”曲线更适合增强低光照条件下图像的技术。

正弦和余弦运算

从 IM v6.4.8-8 版本开始添加了“sin” 和“cos” 方法。这些方法获取图像中给定的值并将其归一化为角度，因此完整范围将覆盖一个完整的圆形角度。结果给出一个 50% 的偏差并缩放以再次适应正常的值范围。常数用作值的乘数（以及角度），因此“N” 表示该函数将在整个值范围内绕圆旋转“N” 次。具体来说，它定义了这些函数（使用归一化值）如下……

   value = 0.5 * sin( constant*value*2*PI ) + 0.5
   value = 0.5 * cos( constant*value*2*PI ) + 0.5 

从本质上讲，这些函数的作用是将图像值（通常是灰度值）重新映射到正弦/余弦曲线。例如，这里我取一个渐变图像并使用这些评估方法对其进行修改。现在，由于常数参数是角度乘数，因此提供给评估方法的值将在图像中整个渐变范围内创建这么多峰值。

magick gradient.png -evaluate cos 5 -negate eval_cos_5.png

这对于许多任务都非常完美，从生成波纹或色散效果到生成波纹状位移曲线。通过使用“0.5” 的乘数常数，您可以简单地将线性渐变转换为正弦曲线渐变，它仍然具有与原始渐变相同的斜率。通过对结果取反，可以确保渐变也具有正确的斜率。

magick gradient.png -evaluate cos 0.5 -negate eval_cos.5.png

这对于生成用于重叠照片的平滑渐变非常有用。但是，最后两个“-evaluate” 方法很少使用，因为它们已被更通用的 正弦函数（见下文）所取代，该函数提供了更多控制选项，超越了简单的频率选项。

---

Function，多参数 Evaluate

上述波形生成器被证明非常有用，尤其是在 图像扭曲映射 中。但人们发现需要对函数进行更精细的控制，需要多个参数。因此，在 IM v6.4.8-9 版本中添加了“-function” 操作符。基本上，“-function” 是“-evaluate” 的多参数形式。但是，与 评估操作符 不同，这些操作符与数学操作符一样，所有上述函数仅作用于图像的归一化通道值（0.0 到 1.0 范围），这在大多数情况下使它们更容易使用。

多项式函数

“polynomial” 方法将接受任意数量的值，并根据给定的精确表达式修改图像中的颜色值，速度比 FX 操作符 快得多。每个值将用作从最高阶到最低阶的系数，以生成具有给定项数的多项式。例如，参数“4,-4,1” 将生成等效于“-fx” 表达式“4*u^2 - 4*u + 1” 的多项式表达式。如果您了解高中数学，那么您应该知道此多项式函数会生成一个抛物线曲线，在输入（'u'）颜色范围 0.0 到 1.0 内从 1.0 到 0.0 再回到 1.0。也就是说，它将使黑色和白色颜色变为“白色”，并将完美的灰色变为“黑色”。

magick gradient.png -function Polynomial 4,-4,1 func_parabola.png

您甚至可以创建更复杂的渐变，例如四次多项式，它是使用一组“级别控制点”生成 曲线级别调整 的结果。这通常用于调整图像的颜色以赋予其各种阴影效果。

magick gradient.png -function Polynomial '-25, 53, -36, 8.3, 0.2' \ func_quartic.png

当然，简单的线性修改也是可能的，就像您使用 级别操作符 时获得的一样……

magick gradient.png -function Polynomial '4, -1.5' func_linear.png

但是请注意，您不能使用“Polynomial” 执行完整的 阈值 操作，因为需要无限个系数才能执行此操作，尽管您可以非常接近。单个值自然只是一个常数，并导致直接分配该值。换句话说，它就像“-evaluate Set” 方法一样，在这种情况下为 33% 的灰色值。

magick gradient.png -function Polynomial 0.33 func_constant.png

通过将“Polynomial” 与其他数学函数结合使用，您可以创建更复杂的渐变修改。例如，通过取多项式的平方根，我可以在一个线性渐变上创建一个真正的圆弧。等效的“-fx” 表达式“sqrt( -4*u^2 + 4*u + 0 )”……

magick gradient.png -function Polynomial -4,4,0 -evaluate Pow 0.5 \ func_circle_arc.png

另请参阅 Pow 评估方法 以了解上述方法的替代方案。

正弦函数

“Sinusoid” 函数方法是“-evaluate” 方法“sin” 和“cos” 的更高级版本，实际上可以复制这些函数，但您可以更好地控制它如何修改图像中的颜色值。并且使用以下公式实现……

  value = ampl * sin(2*PI( freq*value + phase/360 ) ) + bias

这看起来可能很复杂，但它确保了函数易于使用。只需要第一个值“频率”，其工作方式与上面完全相同，所有其他参数都是可选的。默认情况下，它将生成一个正弦曲线。

magick gradient.png -function Sinusoid 1 func_sine.png

通过添加一个以度为单位的“相位” 参数，您可以指定曲线的起始角度。允许您将默认正弦曲线转换为余弦曲线。

magick gradient.png -function Sinusoid 1,90 func_cosine.png

通过调整“频率”和“相位”，我可以直接将线性渐变转换为一个从黑色到白色（沿正弦曲线从最小到最大）的平滑正弦渐变。有关不太直接的方法，请参阅 评估余弦方法。

magick gradient.png -function Sinusoid 0.5,-90 func_sine_grad.png

接下来的两个可选值“幅度”和“偏差”控制正弦曲线的比例和中心线。例如，这里我制作了一个波形（反余弦曲线），它在白色和灰色之间振荡（值范围为0.75 ±0.25 或0.5 到 1.0），从白色开始并以白色结束。

magick gradient.png -function Sinusoid 5,90,.25,.75 func_sine_bias.png

小心使用这些最后的参数，因为它们很容易导致波形超出颜色值范围的界限，从而被剪裁（除非您使用 ImageMagick 的 HDRI 版本）。

反正弦函数

反正弦函数“Arcsin” 已添加到 IM v6.5.3-0 版本中。这是一种特殊的曲线，需要用于生成 圆柱体位移图。它的参数是……并且使用以下公式实现……

  value = range/PI * asin(2/width*( value - center ) ) + bias

默认值（如果未定义）“1, 0.5, 1, 0.5” 确保该函数居中，以便覆盖从0,0 到1,1 的整个颜色范围。

magick gradient.png -function Arcsin 1 func_arcsin.png

通过将所得曲线的“宽度” 减半，您将得到……

magick gradient.png -function Arcsin 0.5 func_arcsin_width.png

“中心” 将允许您根据输入灰度值重新定位曲线。

magick gradient.png -function Arcsin 0.4,0.7 func_arcsin_center.png

“范围” 参数允许减小颜色值的输出范围，“偏差” 将调整该范围的中心。

magick gradient.png -function Arcsin 0.5,0.5,0.5,0.5 func_arcsin_range.png

请注意如何处理由于函数导致的无效值。这使得在位移中使用该函数时可以更好地控制，并提供清理它们的方法。使用的实际值是“偏差 ±范围/2”，正如您所期望的那样。请注意，如果“宽度” 或“范围” 为负数，则由于该负值，函数的斜率将被翻转。

magick gradient.png -function Arcsin -1 func_arcsin_neg.png

反正切函数

“Arctan” 方法已添加到 IM v6.5.3-1 版本中。它的参数是……并且使用以下公式实现……

  value = range/PI * atan(slope*PI*( value - center ) ) + bias

如您所见，它与“Arcsin” 函数几乎完全相同，只是做了一些小的改动以使其更有用。它甚至具有相同的默认值集（如果未定义）“1, 0.5, 1.0, 0.5”。这意味着，如果您指定“1.0” 的斜率值，则直方图变化的斜率将在纯灰色周围产生 1:1 的变化（无缩放），同时使白色和黑色变为更灰色的值。例如

magick gradient.png -function Arctan 1 func_arctan.png

也就是说，渐变的中间部分实际上保持不变，只有黑色和白色端变得对比度降低。随着曲线的“斜率” 变大，中间的渐变将变得更强（中间更压缩），增加的量与斜率成正比。

magick gradient.png -function Arctan 10 func_arctan_10.png

在很多方面，这与 S形对比度 颜色修改操作符非常相似。但是，“Arctan” 函数永远不会真正达到纯黑色和白色的输出范围限制。它将接近这些限制，但永远不会越过它们。与前面的函数（以及 S形对比度）类似，第二个参数将调整曲线相对于输入渐变值的位置。

magick gradient.png -function Arctan 10,.7 func_arctan_center.png

最后两个参数“范围” 将允许您调整将生成的值的输出范围。例如，通过稍微扩展此值，您可以确保它将完全覆盖所有可能的值范围。

magick gradient.png -function Arctan 5,0.7,1.2 func_arctan_range.png

但是，如果您确实想要生成曲线以这种方式修改整个图像的对比度，则更典型的方法是使用S形对比度运算符，该运算符专为此目的而设计。更典型的是使用“Arctan”渐变函数来创建一条曲线，该曲线将非常快地接近特定值，但不会超过该值。正是这些限制值由“range”和“bias”参数控制。例如，此曲线将修改图像中的渐变，以在 0.7 的输入灰度级周围产生非常锐利的阈值，但值在 0.5 和 1.0 的范围限制之间变化。

magick gradient.png -function Arctan 15,0.7,0.5,0.75 func_arctan_typ.png

这是S形对比度无法生成的。

---

渐变图像上的数学运算

现在，上述函数为渐变图像提供了一些非常基本的变换。但是，如果您想对两个或多个渐变图像进行一些数学运算怎么办？也就是说，使用另一个图像的渐变修改一个渐变。为此，您需要使用特殊的数学合成方法（例如“Plus”和“Divide”）。但是，在我们开始之前，我想给您一个警告。如果您的渐变图像是纯灰度图像，没有 Alpha 通道，那么您可以直接使用数学合成方法。但是，如果您想将这些方法限制在特定通道，或将其应用于 Alpha（透明度）通道，则需要确保设置了适当的“-channel”设置，并且没有特殊的“Sync”通道标志。有关更多详细信息，请参阅使用图像合成进行图像数学运算。通常，使用数学合成方法并不是那么困难。当您具有也包含“偏差”的渐变时，就会出现复杂情况。也就是说，渐变应在“50% 灰色”处表示“零”值，并在 -1（黑色）到 +1（白色）之间覆盖一个范围。此类图像通常用于失真图像映射。因此，对“带偏差的渐变”进行数学运算才是真正的问题，我们将在本文中更具体地讨论这个问题。

衰减带偏差的渐变

例如，这里我想创建一个正弦波，但它最初很小，然后幅度变大。这称为“衰减”带偏差的渐变。或者换句话说，将带偏差的渐变乘以另一个绝对渐变。这也是诸如调幅广播中的“幅度调制”的工作原理！因此，我们首先需要一个正弦波，我们可以简单地从线性渐变中生成它……现在，为了衰减它，我们使用乘法 Alpha 合成将正弦波与线性渐变相乘……但是，为了在例如水波纹、位移映射中使用它，波浪必须保持围绕完美的灰色居中。为此，我们需要向原始图像添加偏差。碰巧这是我们用于将原始图像相乘的相同函数，取反并除以二……因此，我们得到了一个线性衰减的正弦波渐变，适用于位移映射。

当然，您可以将整个过程都放在一个命令中，并且它也不必是简单的线性衰减。例如，这里我使用取反的余弦波而不是线性渐变来衰减高频正弦波。

从 IM v6.5.4-3 开始，现在可以在一个合成方法中完成上述所有步骤，使用特殊的数学合成方法。基本上，通过认识到衰减运算的公式为Sc*Dc-.5*Sc+.5或参数“1,-.5,0,.5”。

magick math_sine.png math_cosine_peak.png \ -compose Mathematics -set option:compose:args 1,-.5,0,.5 \ -composite math_attenuate.png

也可以通过首先使用多项式函数调整衰减渐变，然后使用排除合成运算符来合并图像来实现相同的结果。

magick math_sine.png \( math_cosine_peak.png -function polynomial -.5,.5 \) \ -compose Exclusion -composite math_poly_excl.png

乘以有偏渐变

但是如果两个函数都存在偏差，因此完美的灰色表示零，黑色和白色表示 -1 到 +1 的范围呢？好吧，这有点复杂，因为您不能只是将它们相乘并期望得到正确的结果，因为乘法可能包含负值。这需要小心，以确保您最终不会裁剪值并获得结果图像中曲线的正确取反。诀窍是将乘法分解成多个步骤。也就是说   A × B   也可以写成   A × abs(B) × sign(B)。通过这样做，您避免了乘以负值，这无法存储在正常的渐变图像中。因此，我们需要做的就是取其中一个偏差渐变并将其分成两部分，以便它们可以适当地应用于另一个渐变。“sign()”带偏差的渐变，或获取哪些部分为负的掩码，可以通过在偏差级别对渐变使用阈值来提取。您可以稍后使用合成差和该阈值图像选择性地取反另一个渐变。“abs()”带偏差的渐变可以使用Solarize轻松提取，然后取反并加倍（使用Level）以获得从 0.0 到 1.0 的渐变的绝对值。由于我们还需要将偏差偏移作为乘法的一部分（如上所述衰减），因此您可以在将其转换为渐变的绝对值之前，直接使用取反且缩放一半的 Solarize 输出。因此，让我们将一个渐变转换为这三个组成部分。现在我们有了其中一个渐变图像的这三个部分，我们可以将它们与另一个渐变合并。为此，我们乘以绝对值，重新添加偏差，然后取反应取反的部分。这就是两个偏差渐变图像的完美乘法！这里再次显示所有内容，但都在一个命令中……最后一点，与衰减不同，偏差渐变的这种乘法是可交换的。也就是说，交换输入图像不会影响最终结果。由于以上等价于公式2*Sc*Dc-Sc-Dc+1，因此从 IM v6.5.4-3 开始，您可以使用参数“2,-1,-1,1”将上述复杂步骤实现为单个“Mathematics”合成方法。

magick math_sine.png math_cosine_peak.png \ -compose Mathematics -set option:compose:args 2,-1,-1,1 \ -composite math_bias_multiply.png

也就是说，与没有此参数化合成方法所需的十几步相比，这是一种简单得多的方法。碰巧的是，一旦我看到了那个公式，我就意识到这恰好是“Exclusion”合成方法的否定。奇怪但真实。因此，以下内容也将生成相同的零偏差乘法。

magick math_sine.png math_cosine_peak.png \ -compose exclusion -composite -negate math_excl_neg.png

添加有偏渐变

随着“Mathematics”合成方法的出现，添加偏差渐变也相对容易。等效的 FX 公式为“u+v-0.5”或合成参数“0,1,1,-.5”。例如，以下是傅里叶变换示例，我手动生成了它，需要添加 3 个带偏差的正弦波和一个常数直流值。请注意，在上面我如何使用“-flatten”运算符和“-background”设置来实现多图像合成。或者在这种情况下，所有给定图像加上背景常数的“带偏差的总和”。

频率调制

通过将函数直接应用于另一个函数的输出，您不会产生简单结果。原因是所有这些数学函数都应用于各个像素的渐变“值”，而不是针对渐变中像素的 x 值。例如……

magick gradient.png -evaluate sin 0.5 -normalize \ -evaluate cos 8 math_cos_var.png

这会生成一个非常复杂的函数，基本上等效于换句话说，这是一个可变频率，其中频率随第一个正弦曲线的渐变而变化。基本上，原始图像中渐变变化越快，峰值之间的距离就越小。但是峰值的高度（幅度）不会变化。这实际上是“频率调制”的工作原理，其中一个看似简单的函数会产生非常复杂的结果。

---

Miscellaneous Image Transformation Techniques.

These have not been exampled yet, but are some basic IM developed transforms
that may provide useful.  If you have an interesting effect please contribute.

   pixelize an image
      resize an image down 10 then scale the image 10 to produce blocks
      of roughly averaged color.
      For example...
         magick input.jpg -resize 10% -sample 1000% output.jpg

  De-skew slightly rotated images

    -deskew {threshold}
       straighten an image. A threshold of 40% works for most images.

    Use -set option:deskew:auto-crop {width} to auto crop the image. The set
    argument is the pixel width of the image background (e.g 40).

    Programmically we auto crop by running a median filter across the image
    to eliminate salt-n-pepper noise.  Next we get the image bounds of the
    median filter image with a fuzz factor (e.g. -fuzz 5%).  Finally we
    crop the original image by the bounds.  The code looks like this:

      median_image=MedianFilterImage(image,0.0,exception);
      geometry=GetImageBoundingBox(median_image,exception);
      median_image-DestoryImage(median_image);

      print("  Auto-crop geometry: %lux%lu%+ld%+ld",
                geometry.width,geometry.height, geometry.x,geometry.y);
      crop_image=CropImage(rotate_image,&geometry,exception);

    See Trimming 'Noisy' Images

  Segmentation
    look at scripts
       divide_vert
       segment_image
    for some simple scripts I wrote to segment well defined images into
    smaller parts.   I hope to get simple segmentation functions like this
    into the core library, to allow for things like automatic sub-division of
    GIF animations, and seperating images and diagrams from scanned documents.

---