1.废话

视觉算法库的第一步。

读取图片：

看你是从哪里读取，从相机读取还是从本地硬盘中读取。

保存图片：就只有保存到本地了。

上面的截图显示我读取了一张图片

从相机中读取另开一篇来说，先说从本地磁盘读取哈。

怎么读取的呢

三种方法哈

第一 直接鼠标拖进去

没错，跟大多数软件一样，直接拿住图片拖到程序编辑窗口就可以了

会给你弹个框

点击确定，就可以读取这张图片

第二 编写代码

在程序编辑窗口编写read_image算子，点击tab键，然后在算子的参数中输入图片的路径

点F6运行这一句，然后就把图片读进来了。

第三 算子窗口选择图片

在程序窗口中选中当前算子，打开算子窗口，点击这里即可选择图片读取进来

读取图片算子详解

read_image（操作员）

名字

read_image— 读取具有不同文件格式的图像。

签名

描述

操作员从中读取指示的图像文件 后台存储并生成图像。一个或多个文件 名称可以传入read_imageFileName.如果有多个文件 name 被传递，一个具有相应数字的图像对象元组 返回图像对象。

HALCON 格式（HOBJ 和 IMA）

对于 HALCON Iconic Object 格式 （HOBJ） 的图像，多个图像 保存在一个文件中将作为图像元组返回。如果区域或 XLD 包含在文件中，则引发异常。看write_object有关 HOBJ 格式的更多信息。

所有图像文件均由操作员写入write_image（格式 'ima'） 具有扩展名“.ima”.描述文件可以 可用于 IMA 格式的每张图像（与 外延'.exp').像素数据的类型 (“字节”,“int4”,“真实”）也可以取自 描述文件。如果描述文件不可用，则 类型“字节”默认使用以及默认数据 尺寸 （“高度”x“宽度”） 可以 通过查询get_system.如果“.ima”文件和默认数据大小不相等，一个 引发异常。

其他格式

除了 HALCON 格式，TIFF、GIF、BMP、JPEG、JPEG-2000、JPEG-XR、PNG、 还可以读取 PCX、SUN-Raster、PGM、PPM、PBM 和 XWD 文件。这 PBM 图像的灰度值设置为值 0 和 255。文件 格式要么由扩展名识别（如果指定），要么 由于文件的内部结构。如果扩展名是 表示可以更快地找到图像。如果没有扩展名 指示，带有扩展名的文件优先于没有扩展名的文件 外延。在 PGM、PPM 和 PBM 的情况下，相应的扩展 （例如，“铂族金属”）或一般值“PNM”可以 使用。在 TIFF 的情况下“tiff”和“tif”是 接受。如果是 JPEG-XR，则接受“jxr”、“wdp”、“wmp”和“hdp”。 仅适用于 JPEG-2000“JP2”被接受。倘 在彩色图像中，具有三个颜色通道的图像是 创建后，红色通道存储在第一个绿色通道中 在第二和蓝色通道在第三组件（通道 数字）。

对于图像格式 TIFF、PNG、JPEG-XR 和 JPEG-2000，二进制 alpha 通道被解释为域。对于 TIFF 文件，此外 具有 PhotometricInterpretation 的二进制 SubIFD = TransparencyMask 被解释为域。否则，生成的域 图像对象（= 矩阵的所有像素）被选为最大值。

对于 TIFF 图像，多页 TIFF 文件将作为图像对象返回 元组。仅读取 TIFF 文件中的子 IFD 时，才读取其尺寸 等于主图像的尺寸。

“int8”类型的图像只能在 64 位系统上读取。此外 只有 IMA 和 TIFF 格式支持此图像类型。

在当前目录和映像中搜索映像文件 HALCON 的目录（由环境变量确定）。这 HALCON 的映像目录预设为'.'和'/usr/local/halcon/images'在类 Unix 环境中，可以 通过运算符设置set_system.多张图片 可以指示目录。这是通过分离 用冒号表示的单个目录。

此外，可以通过环境变量设置搜索路径 HALCONIMAGES（与“image_dir”).例：

setenv HALCONIMAGES “/usr/images：/usr/local/halcon/images”

HALCON 还会搜索子目录中的图像“图像”（程序示例的图像）。这 环境变量 HALCONROOT 用于 HALCON 目录。

注意力

如果读取 CMYK 或 YCCK JPEG/JPEG-XR 文件，HALCON 会假定这些 文件遵循 CMYK 通道的 Adobe Photoshop 约定 是倒置存储的，即 0 表示 100% 的墨水覆盖率，而不是 比人们所期望的 0% 墨水。图像将转换为RGB 使用此约定的图像。如果 JPEG 文件不遵循此内容 约定，但以通常的方式存储 CMYK 通道，invert_image必须在读取图像后调用。

如果读取包含 alpha 通道的 PNG 图像，则 alpha 通道作为输出的第二或第四通道返回 图像，除非 Alpha 通道正好包含两个不同的灰度 值，在这种情况下，一个或三个通道图像具有 返回 domain，其中域中的点对应于 Alpha 通道中灰度值较高的点。

执行信息

• 多线程类型：可重入（与非独占运算符并行运行）。
• 多线程作用域：全局（可以从任何线程调用）。
• 无需并行处理。

参数

2.写入图片

处理好的图片需要保存的本地的，使用下面的这个算子保存到本地

write_image (Image3, 'tiff', 0, '')

第一个参数是需要保存的图像变量

第二个参数是保存到本地的图像的格式

第三个参数是没有像素值的像素应该填充为哪个灰度值

第四个参数是保存的路径和文件名

写入图片算子详解

write_image（操作员）

名字

write_image— 以图形格式编写图像。

签名

描述

操作员保存输入图像write_imageImage在 文件FileName在格式中Format.如果域（区域） 不能保存在指定的Format（'bmp'就是这种情况， 'jpeg' 和 'ima'），该区域外的所有像素都接收定义的颜色 由FillColor.对于灰度值图像，介于 0（黑色）和 必须通过255（白色）。对于 RGB 彩色图像，可以传递 RGB 值 直接作为十六进制值：例如，黄色背景的0xffff00 （红色=255，绿色=255，蓝色=0）。

目前支持以下格式：

'tiff'， 'bigtiff'： TIFF 格式，文件扩展名 *.tif

支持所有 HALCON 像素类型。最多 65535 个图像对象元组 图像对象和多达 65535 个通道可以写入。 可以写入具有混合像素类型通道的图像对象。

压缩是可能的

这里“[数字]'表示压缩的可选规范 参数。为“放气”，介于 0 之间的数字（否 压缩）和 9（最大压缩）可以指定。为'jpeg'，介于 0 和 100 之间的数字可以是 指定。语义与所描述的“jpeg”的语义相同 下面。'jpeg'只能用于 byte 和 int1 类型的图像 最多有四个通道。

每个图像对象的域（区域）可以通过压缩形式保存“面具”（默认设置）或作为额外的 Alpha 通道通过“阿尔法”.仅当域不包含完整的域时，才会存储该域 图像。'jpeg'和“阿尔法”不能一起使用，因为 由于 JPEG 的有损压缩，图像的域不能 正确重建。不同的选项可以通过以下方式累积 附加用空格字符分隔的它们。

例子：

请注意，“大夫”表示可以大于 4 GB，而“tiff”表示限制为 4 GB 的 TIFF 文件。 文件大小取决于图像大小和所选的压缩。 因此“大夫”如果有可能，应选择 压缩文件将增长到 4 GB 以上。

“bmp”： Windows-BMP 格式，文件扩展名 *.bmp

此格式只能存储具有一个通道的图像（灰度值图像） 或三个通道（RGB图像）。

仅支持具有像素类型字节的图像 文件格式。

“jpeg”：JPEG 格式（有损压缩），文件扩展名 *.jpg

与格式字符串一起确定压缩的质量值 可以提供费率，例如“JPEG 30”。

此格式只能存储具有一个通道的图像（灰度值图像） 或三个通道（RGB图像）。

仅支持具有像素类型字节的图像 文件格式。

注意：存储以供以后处理的图像不应 由于压缩过程中信息丢失，因此以此格式存储。

“jp2”：JPEG-2000 格式（无损和有损压缩），文件扩展名 *.jp2

与格式字符串一起确定压缩的质量值 可以提供费率（例如，'JP2 40').此值对应于 压缩图像大小与未压缩图像大小之比 图像（以百分比为单位）。由于无损 JPEG-2000 压缩已经减少了 文件大小显着，只有较小的值（通常小于 50） 影响文件大小。如果未为压缩提供任何值（和 只有这样），图像才会被压缩而不会丢失。

映像可以包含任意数量的通道。可能的类型有 Byte、Cyclic、Direction、Int1、Uint2、Int2 和 Int4。在 int4 的情况下，它 只能存储精度小于或等于 24 位的图像 （否则会引发异常）。如果图像具有缩小的 域被写入，区域存储为 1 位 alpha 通道。

请注意，图像的 JPEG-2000 编码需要大量内存。为 大图像，因此建议使用不同的格式（例如，“tiff”).支持的最大图像大小（宽 x 高） JPEG-2000 是也在 HALCON-XL 中。

'jpegxr'：JPEG-XR 格式（无损和有损压缩），文件扩展名 *.jxr

与格式字符串一起确定压缩的质量值 可以提供速率，例如，“JPEGXR 30”（使用“JPEGXR”或“JPEGXR 100”表示 无损编码）。除 int8 之外的所有 HALCON 像素类型 受支持。具有任意数量的图像对象的图像对象元组 可以写。图像最多可以有 8 个通道。在 int4 和 真实图像，数值范围被压缩到 24 位精度。请注意， 无论质量设置如何，这都可能导致损失。 如果写入具有缩小域的图像，则该区域存储时没有 损失为 1 位 Alpha 通道。复杂图像、矢量场和常规图像 具有两个灰度值通道的图像填充了第三个空通道 符合标准。

请注意，您需要在当前工作中具有写入权限 目录，以便将图像保存为 JPEG-XR 格式，无论 目标目录。

“png”：PNG 格式（无损压缩），文件扩展名 *.png

与格式字符串一起，0 到 9 之间的压缩级别可以是 指定，其中 0 对应于无压缩，9 对应于最佳压缩 压缩。或者，可以使用 以下字符串：“最佳”,“最快”和“无”. 因此，正确参数的示例是“png”,“png 7”, 和'png 无'.

byte 和 uint2 类型的图像可以存储在 PNG 文件中。如果图像具有 写入缩减域，该区域存储为 alpha 通道，其中 域内的点存储为 图像类型和域外的点存储为格雷值 0。 如果写入具有完整域的图像，则不会存储 Alpha 通道。

此格式只能存储具有一个通道的图像（灰度值图像） 或三个通道（RGB图像）。支持的最大图像大小 PNG 的（宽 x 高）为也在 HALCON-XL 中。

'hobj'： HALCON 标志性物体 （HOBJ），文件扩展名 *.hobj

支持所有类型的 HALCON 映像。看write_object查看更多 有关 HOBJ 格式的信息。

'ima'：HALCON 格式，文件扩展名 *.ima 和 *.exp

此文件格式现在是旧版，应改用 HOBJ 格式。 数据以二进制形式逐行写入（不带标题或回车 返回）。图像的大小和像素类型存储在 描述文件”FileName.exp“。所有 HALCON 像素类型，除了“复杂”和“vector_field”可以写。 对于此格式，只能存储一个通道图像。

执行信息

• 多线程类型：可重入（与非独占运算符并行运行）。
• 多线程作用域：全局（可以从任何线程调用）。
• 无需并行处理。

参数