将黑色/白色边框转换为黑色。
~#~# 概要
```
nearblack [-of format] [-white | [-color c1,c2,c3...cn]*] [-near dist]
[-nb non_black_pixels] [-setalpha] [-setmask] [-o outfile] [-q]
[-co "NAME=VALUE"]* infile
```
~#~# 描述
该实用程序将扫描图像，并尝试将所有的颜色都设置为黑色或白色，几乎或完全为黑色，白色或一个或多个自定义颜色的像素。 这通常用于“修复”有损的压缩空气照片，使得彩色像素可以在镶嵌时视为透明。
~*~*-o outfile:~*~*
要创建的输出文件的名称。 默认情况下，使用HFA驱动程序创建新创建的文件（Erdas Imagine - .img）
~*~*-of format:~*~*
（GDAL 1.8.0或更高版本）选择输出格式。 使用短格式名称（例如，用于GeoTIFF的GTiff）。
~*~*-co "NAME=VALUE":~*~*
（GDAL 1.8.0或更高版本）将创建选项传递给输出格式驱动程序。 可能会列出多个-co选项。 有关每种格式的合法创建选项，请参阅格式化的文档。 仅在创建新文件时有效
~*~*-white:~*~*
搜索近白色（255）像素，而不是近乎黑色的像素。
~*~*-color c1,c2,c3...cn:~*~*
（GDAL> = 1.9.0）搜索指定颜色附近的像素。 可以多次指定。 当指定-color时，被认为是领的像素被设置为0。
~*~*-near dist:~*~*
选择距离黑色，白色或自定义颜色多少像素值可能仍然被认为是接近黑色，白色或自定义颜色。 默认为15。
~*~*-nb non_black_pixels:~*~*
在放弃搜索之前可能遇到的非黑色像素数。 默认为2。
~*~*-setalpha:~*~*
（GDAL 1.8.0或更高版本）如果指定输出文件，并且输入文件有3个频段，则添加一个Alpha频段，如果指定了输入文件，则设置输出文件的alpha带，输入文件有4个频段，或者设置 输入文件的alpha带，如果它有4个波段，没有指定输出文件。 图像项圈中的alpha带设置为0，在其他位置设置为255。
~*~*-setmask:~*~*
（GDAL 1.8.0或更高版本）向输出文件添加一个掩码带，或者如果没有指定输出文件，那么将掩码波段添加到输入文件中。 图像领域中的蒙版条带设置为0，其他地方设置为255。
~*~*-q:~*~*
（GDAL 1.8.0或更高版本）禁止进度监视器和其他无错误输出。
~*~*infile:~*~*
输入文件。 任何GDAL支持的格式，任意数量的频段，通常为8位字节频段。
该算法一次处理图像一条扫描线。 扫描“in”是从两端设置像素到黑色或白色完成的，直到扫描停止为止，至少比“黑色”，“白色”或“自定义”颜色多了“dist”灰度级别的“non_black_pixels”像素。 近黑色，白色或自定义颜色像素设置为黑色或白色。 该算法还从顶部到底部以及从底部到顶部扫描以识别顶部或底部的凹痕。
处理全部以8位（字节）完成。
如果输出文件被省略，处理后的结果将被写回到输入文件 - 这必须支持更新。