stream
使用例 • オプション一覧
stream は、画像（または画像の一部）の 1 つ以上のピクセル成分を、選択した格納フォーマットへストリーミングする軽量ツールです。入力画像から読み込んだピクセル成分を 1 行ずつ書き出すため、大きな画像を扱う場合や、生のピクセル成分が必要な場合に適しています。
使用例
stream コマンドの有用さと手軽さを示すため、いくつか例を挙げます。手始めに、640x480 の JPEG 画像の赤・緑・青成分を、符号なし文字（unsigned char）としてディスクへストリーミングします:
magick stream -map rgb -storage-type char image.jpg pixels.dat
magick display -depth 8 -size 640x480 rgb:pixels.dat
ここでは、TIFF 画像からグレースケール形式の 100x100 領域を、倍精度浮動小数点数（double）として抽出します:
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 | 画像境界外のピクセルへのアクセス方法 |