nearblack

黒/白に近い境界色部分を黒に変換します.

概要

nearblack [--help] [--help-general]
          [-of <format>] [-white | [-color <c1>,<c2>,<c3>...<cn>]...]
          [-near <dist>] [-nb <non_black_pixels>]
          [-setalpha] [-setmask] [-alg twopasses|floodfill]
          [-o <outfile>] [-q] [-co <NAME>=<VALUE>]... <infile>

説明

このユーティリティは画像をスキャンし, ほぼ黒または完全に黒, 白またはカラーカラーの周りの 1 つ以上のカスタムカラーのすべてのピクセルを黒または白に設定しようとします. これは, 圧縮されたエア写真を "修正" してモザイク処理時にカラーピクセルを透明として扱うためによく使用されます. 出力形式は, アルファバンドまたはマスクバンドのいずれかが設定されていない場合, 損失のない圧縮を使用する必要があります.

--help: このヘルプメッセージを表示して終了します

--help-general: 一般的な GDAL コマンドラインオプションの簡単な使用メッセージを表示して終了します.

-o <outfile>: 作成される出力ファイルの名前です.

-of <format>: 出力フォーマットを選択します. GDAL 2.3 以降,指定されていない場合,フォーマットは拡張子から推測されます (以前は ERDAS Imagine .img でした). 短いフォーマット名を使用してください (例: GeoTIFF の場合は GTiff).

-co <NAME>=<VALUE>

出力フォーマットドライバに作成オプションを渡します. 複数の -co オプションをリストアップできます. 各フォーマットの法的な作成オプションについては, ラスタードライバー形式固有のドキュメントを参照してください.

新しいファイルを作成する場合のみ有効です

-white: ほぼ白 (255) のピクセルを検索します.

-color <c1>,<c2>,<c3>...<cn>: 指定されたカラーに近いピクセルを検索します. 複数回指定できます. -color が指定されている場合, カラーとして考慮されるピクセルは 0 に設定されます.

-near <dist>: ピクセル値が黒, 白またはカスタムカラーからどれだけ離れていても, まだ黒, 白またはカスタムカラーに近いと見なされるかを選択します. デフォルトは 15 です.

-nb <non_black_pixels>: 内側の検索を諦める前に遭遇できる連続した非黒ピクセルの数. デフォルトは 2 です.

-setalpha: 出力ファイルが指定されており,入力ファイルが 3 バンドの場合,アルファバンドを追加します. または,出力ファイルが指定されており,入力ファイルが 4 バンドの場合,アルファバンドを設定します. または,入力ファイルが 4 バンドで出力ファイルが指定されていない場合,入力ファイルのアルファバンドを設定します. アルファバンドは画像のカラー部分に 0 を設定し,それ以外は 255 に設定されます.

-setmask: 出力ファイルにマスクバンドを追加します.または,入力ファイルにマスクバンドを追加します. または,入力ファイルにマスクバンドを追加します. マスクバンドは画像のカラー部分に 0 を設定し,それ以外は 255 に設定されます.

-alg twopasses|floodfill

Added in version 3.8.

適用するアルゴリズムを選択します.

twopasses は上から下へのパスに続いて下から上へのパスを使用します. これは, GDAL 3.8 以前に実装された唯一のアルゴリズムです. 凹凸部分でミスする可能性があります. このアルゴリズムは画像を 1 スキャンラインずつ処理します. 両端からのスキャン "in" は, "non_black_pixels" ピクセルが黒, 白またはカスタムカラーから "dist" グレーレベル以上離れていることが確認されるまで, ピクセルを黒または白に設定します. ほぼ黒, 白またはカスタムカラーピクセルは黒または白に設定されます. このアルゴリズムはまた, 上から下へ,下から上へのスキャンを行い, 上部または下部の凹凸を識別します.

floodfill (GDAL 3.8 で追加) は Flood Fill アルゴリズムを使用し, 凹凸部分でも機能します. 一時データセットの作成が必要であり, twopasses よりも遅くなります. -nb に 0 以外の値を使用すると, floodfill の初期ステップとして実際に twopasses が呼び出されます.

-q: 進行状況モニターおよびその他のエラー以外の出力を抑制します.

<infile>: 入力ファイルです. 任意の GDAL サポートされた形式, 任意のバンド数, 通常 8 ビットバンドです.

処理はすべて 8 ビット (バイト) で行われます.

出力ファイルが省略された場合,処理された結果は入力ファイルに書き戻されます. 入力ファイルは更新をサポートする必要があります.

C API

このユーティリティは GDALNearblack() から C で呼び出すこともできます.

Added in version 2.1.