nearblack
将近黑白边框转换为黑色。
简介
nearblack [-of format] [-white | [-color c1,c2,c3...cn]*] [-near dist] [-nb non_black_pixels]
[-setalpha] [-setmask] [-o outfile] [-q] [-co "NAME=VALUE"]* infile
描述
这个工具将扫描一个图像，并试图设置所有像素几乎或完全黑，白或一个或多个自定义颜色周围的衣领黑色或白色。这是经常用来“修复”压缩空气有损照片，使彩色像素可以被视为透明镶嵌时。如果未设置alpha波段或mask波段，则输出格式必须使用无损压缩。
- -o <outfile>
要创建的输出文件的名称。
- -of <format>
选择输出格式。从GDAL 2.3开始，如果没有指定，则从扩展名猜测格式（以前是ERDAS Imagine.img）。使用短格式名称（例如，GeoTIFF的GTiff）。
- -white
搜索近白色（255）像素而不是近黑色像素。
- -color <c1,c2,c3...cn>
搜索指定颜色附近的像素。可以多次指定。当指定-color时，将被视为项圈的像素设置为0。
- -near <dist>
选择像素值与黑色、白色或自定义颜色之间的距离，并将其视为接近黑色、白色或自定义颜色。默认为15。
- -nb <non_black_pixels>
放弃向内搜索之前可能遇到的非黑色像素数。默认为2。
- -setalpha
如果指定了输出文件且输入文件有3个波段，则添加alpha波段；如果指定了输出文件且输入文件有4个波段，则设置输出文件的alpha波段；如果输入文件有4个波段且未指定输出文件，则设置输入文件的alpha波段。在图像领中，alpha波段设置为0，在其他地方设置为255。
- -setmask
向输出文件中添加遮罩带区，或在输入文件中添加遮罩带区（如果尚未指定输出文件）。在图像领中，遮罩带设置为0，在其他位置设置为255。
- -q
抑制进度监视器和其他非错误输出。
- <infile>
输入文件。任何支持GDAL的格式，任何数量的频带，通常是8位字节的频带。
该算法一次处理一个扫描线的图像。扫描“进入”是从任意一端设置像素为黑色或白色，直到至少“非黑色像素”像素超过“距离”黑色、白色或自定义颜色的灰度级，扫描停止。近似黑色、白色或自定义颜色像素设置为黑色或白色。该算法还从上到下和从下到上扫描，以识别顶部或底部的缩进。
所有的处理都是在8bit（字节）内完成的。
如果输出文件被省略，处理后的结果将被写回输入文件-输入文件必须支持更新。
计算机辅助编程接口
此实用程序也可以通过 GDALNearblack() .
2.1 新版功能.