前言
write_image 是一个可以用来保存图片的算子，可以将Image对象保存成各种格式的图片。还可以对图片进行压缩。
正文
参数：
-
Image（输入对象）： 输入图像或输入图像的数组。支持的像素类型包括byte、direction、cyclic、int1、complex、int2、uint2、vector_field、int4、int8和real。
-
Format（输入控制）： 要保存图像的图形格式。支持的格式包括：
- 'tiff'，'bigtiff'：TIFF格式。
- 'bmp'：Windows-BMP格式。
- 'jpeg'：JPEG格式。
- 'jp2'：JPEG-2000格式。
- 'jpegxr'：JPEG-XR格式。
- 'png'：PNG格式。
- 'hobj'：HALCON Iconic Object（HOBJ）格式。
- 'ima'：HALCON格式。
-
FillColor（输入控制）： 不属于图像域（区域）的像素的填充灰度值。对于灰度值图像，必须传递0（黑色）到255（白色）之间的值。对于RGB彩色图像，RGB值可以直接传递为十六进制值，例如，对于黄色背景，可以传递0xffff00（红=255，绿=255，蓝=0）。
-
FileName（输入控制）： 图像文件的名称，包括文件扩展名。具体的扩展名取决于所选择的图形格式。
支持的格式：
-
TIFF格式：
- 支持所有HALCON像素类型。
- 可以使用'deflate [num]'、'jpeg [num]'、'lzw'和'packbits'进行压缩。
- 可以将图像域以压缩形式存储为'mask'（默认设置）或作为附加的alpha通道存储为'alpha'。
-
BMP格式：
- 仅支持像素类型为byte的图像。
- 仅支持包含一个通道（灰度值图像）或三个通道（RGB图像）的图像。
-
JPEG格式：
- 仅支持像素类型为byte的图像。
- 可以指定质量值确定的压缩率，例如，'jpeg 30'。
-
JPEG-2000格式：
- 支持lossless和lossy压缩。
- 可以指定决定压缩率的质量值，例如，'jp2 40'。
-
JPEG-XR格式：
- 支持lossless和lossy压缩。
- 可以指定决定压缩率的质量值，例如，'jpegxr 30'。
-
PNG格式：
- 支持lossless压缩。
- 可以指定0到9的压缩级别，或使用字符串'best'、'fastest'和'none'进行选择。
-
HALCON Iconic Object（HOBJ）格式：
- 支持所有HALCON图像类型。
-
HALCON格式：
- 现在是遗留的格式，建议使用HOBJ格式。
执行信息：
- 多线程类型： 可重入（可以与非独占操作同时运行）。
- 多线程范围： 全局（可以从任何线程调用）。
- 自动并行化： 在元组级别上自动并行化。
返回结果：
如果参数值正确，write_image 操作符将返回值2（H_MSG_TRUE）。否则，将引发异常。
问答环节
如果我想保存成png格式如何实现压缩？
要将图像保存为PNG格式并实现压缩，你可以在 write_image 操作符的 Format 参数中指定压缩级别。压缩级别可以是介于0和9之间的整数，其中0表示无压缩，9表示最佳压缩。此外，你还可以使用一些字符串来选择压缩级别，如'best'表示最佳压缩，'fastest'表示最快速度，'none'表示无压缩。
以下是将图像保存为PNG格式并进行压缩的示例：
cpp
// 将图像保存为PNG格式并设置压缩级别
write_image(Image, 'png 5', 0, 'output.png');在上述示例中，'png 5' 指定了压缩级别为5。你可以根据需要调整压缩级别。如果你希望实现最佳压缩，可以将字符串设置为 'png best'。
cpp
// 将图像保存为PNG格式并使用最佳压缩级别
write_image(Image, 'png best', 0, 'output.png');请注意，使用更高的压缩级别可能会导致保存过程变慢，因此你可能需要权衡压缩率和性能。
JPEG 如何保存呢？
当你想将图像保存成 JPEG 格式时，可以使用 write_image 操作符，并设置格式参数为 'jpeg'，同时可以通过指定质量参数来调整 JPEG 的压缩质量。以下是详细介绍：
操作符签名
cpp
write_image(Image, 'jpeg [quality]', FillColor, 'output.jpg');- Image： 待保存的图像或图像数组。
- 'jpeg [quality]'： JPEG 格式字符串，quality 参数可选，用于指定压缩质量。quality 的范围一般为 0 到 100，值越大表示质量越高，文件大小越大。例如，'jpeg 90' 表示压缩质量为 90。
- FillColor： 用于指定图像外部区域的填充颜色。对于 JPEG，这通常不太影响，可以设置为 0。
- 'output.jpg'： 输出文件的名称和路径。
示例
cpp
// 保存为 JPEG 格式，压缩质量为 90
write_image(Image, 'jpeg 90', 0, 'output.jpg');注意事项
- 压缩质量： 质量设置为 100 表示最高质量，0 表示最低质量。适当的质量设置可以在保持图像质量的同时减小文件大小。
- 压缩速度和文件大小： 选择较高的质量通常会导致较大的文件大小，同时保存时间可能稍长。在速度和文件大小之间需要平衡，具体取决于应用需求。
- 颜色损失： JPEG 是有损压缩格式，会引入一定程度的颜色损失。这种损失在较高的质量设置下会减小，但不会完全消除。
根据你的具体需求，可以根据测试和实验来选择合适的质量参数和其他选项。
哪一种保存的时间比较快呢？
这里我写了一个程序进行测试：
csharp
HObject img;
HOperatorSet.ReadImage(out img, "1.tif");
stopwatch.Restart();
HOperatorSet.WriteImage(img, "png fastest", 0, "p1");
stopwatch.Stop();
Debug.WriteLine($"png fastest: {stopwatch.ElapsedMilliseconds}");
stopwatch.Restart();
HOperatorSet.WriteImage(img, "png bset", 0, "p2");
stopwatch.Stop();
Debug.WriteLine($"png bset: {stopwatch.ElapsedMilliseconds}");
stopwatch.Restart();
HOperatorSet.WriteImage(img, "tiff", 0, "t");
stopwatch.Stop();
Debug.WriteLine($"tiff: {stopwatch.ElapsedMilliseconds}");
stopwatch.Restart();
HOperatorSet.WriteImage(img, "bmp", 0, "b");
stopwatch.Stop();
Debug.WriteLine($"bmp: {stopwatch.ElapsedMilliseconds}");
stopwatch.Restart();
HOperatorSet.WriteImage(img, "jpeg", 0, "j1");
stopwatch.Stop();
Debug.WriteLine($"jpeg: {stopwatch.ElapsedMilliseconds}");
stopwatch.Restart();
HOperatorSet.WriteImage(img, "jpeg 30", 0, "j2");
stopwatch.Stop();
Debug.WriteLine($"jpeg 30: {stopwatch.ElapsedMilliseconds}");
stopwatch.Restart();
HOperatorSet.WriteImage(img, "jpeg 90", 0, "j3");
stopwatch.Stop();
Debug.WriteLine($"jpeg 90: {stopwatch.ElapsedMilliseconds}");读取的是一张56M图片，是黑白的，执行结果如下（单位ms）：
png fastest: 1247
png bset: 3421
tiff: 144
bmp: 179
jpeg: 126
jpeg 30: 100
jpeg 90: 183
最快的是 jpeg 压缩质量为30的时候。虽然质量只有30，但一眼看上去也没啥区别，不过大小是小的真的多（不愧是是有损压缩！）。
当然还有其他格式，我没有一一去测试，大家可以自行尝试！