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 | 画像の境界外のピクセルへのアクセス方法です。 |