Stream は、画像または画像の一部の一つか複数のピクセルコンポーネントを、選択したストレージフォーマットにストリーミングするための軽量ツールです。入力画像から読み取ったピクセルコンポーネントを一行ずつ書き込むため、大規模な画像を処理する場合や、生のピクセルコンポーネントが必要な場合にstreamは有用です。
使用例
ここでは、streamコマンドの有用性と使いやすさを示すいくつかの例を示します。まず、640x480 JPEG画像の赤、緑、青のコンポーネントを符号なし文字としてディスクにストリーミングしてみましょう。
magick stream -map rgb -storage-type char image.jpg pixels.dat magick display -depth 8 -size 640x480 rgb:pixels.dat
ここでは、グレースケール形式のTIFF画像から100x100の領域を倍精度浮動小数点数として抽出します。
magick stream -map i -storage-type double -extract 100x100+30+40 image.tif gray.raw
抽出する領域を画像ファイル名に関連付けることもできます。
magick stream -map i -storage-type double 'image.tif[100x100+30+40]' gray.raw
ストリーミングには、画像コーダーが画像ピクセルを行順で読み取る必要があります。すべてのフォーマットがこの要件を満たしているわけではありません。ワークフローでストリーミングを使用する前に、特定の画像フォーマットを確認してください。
オプション概要
streamコマンドはこれらのオプションを認識します。オプションをクリックすると、そのオプションの動作に関する詳細情報が表示されます。
オプション | 説明 |
---|---|
-authenticate value | このパスワードで画像を復号化します。 |
-channel type | 選択した画像チャンネルにオプションを適用します。 |
-colorspace type | 画像の色空間を設定します。 |
-debug events | 詳細なデバッグ情報を表示します。 |
-define format:option | 1つ以上の画像フォーマットオプションを定義します。 |
-density geometry | 画像の水平および垂直解像度です。 |
-depth value | 画像の深度です。 |
-extract geometry | 画像から領域を抽出します。 |
-help | プログラムのオプションを出力します。 |
-interlace type | 画像のインターレース方式の種類です。 |
-interpolate method | ピクセルの色の補間方法です。 |
-limit type value | ピクセルキャッシュのリソース制限です。 |
-list type | Color、Configure、Delegate、Format、Magic、Module、Resource、またはType |
-log format | デバッグ情報のフォーマットです。 |
-map components | この形式でピクセルを保存します。 |
-monitor | 進捗状況を監視します。 |
-quantize colorspace | この色空間で画像の色を削減します。 |
-quiet | すべての警告メッセージを抑制します。 |
-regard-warnings | 警告メッセージに注意を払います。 |
-respect-parentheses | 括弧の境界まで設定が有効なままになります。 |
-sampling-factor geometry | 水平および垂直サンプリング係数です。 |
-seed value | 擬似乱数の新しいシーケンスのシードを設定します。 |
-set attribute value | 画像属性を設定します。 |
-size geometry | 画像の幅と高さです。 |
-storage-type type | このストレージタイプでピクセルを保存します。 |
-synchronize | 画像をストレージデバイスと同期します。 |
-taint | 画像を変更済みとしてマークします。 |
-transparent-color color | 透明色です。 |
-verbose | 画像に関する詳細情報を表示します。 |
-version | バージョン情報を表示します。 |
-virtual-pixel method | 画像の境界外のピクセルへのアクセス方法です。 |