画像にマスクを適用し、画像データのマスク要素にあるマスク情報を返します。このVIは2Dピクチャ制御器に画像を書き込む前に画像の特定の色を透明にする場合に役に立ちます。


icon

入力/出力

  • ccclst.png 画像データ —

    画像データは画像情報を返すため、「平坦化ピックスマップ描画」VIを使用して、ピクチャとして画像を描画できます。

  • ci32.png 画像タイプ —

    画像タイプは、将来の使用に備えて予約されています。

  • ci32.png 画像深度 —

    画像深度は、画像のカラー深度を指定します。これは、画像の各ピクセルの色を表示するために使用するビット数です。有効な値は、1ピクセルあたり1、4、8、および、24ビットです。

    画像深度は、LabVIEWでの画像および色の値の解釈方法に影響します。

  • c1du8.png 画像 —

    画像は、ラスター順で画像にある各ピクセルの色を表すバイトの配列です。画像深度の値は、LabVIEWでの出力値の解釈方法を指定します。

    画像深度が24の場合、各ピクセルは3バイトで色を表示します。各ピクセルの最初のバイトは赤の値、2番目のバイトは緑の値、そして、3番目の値は青の値を示します。

    画像深度が8の場合、各ピクセルは1バイトで色を表示します。各バイトの値は色の要素に対応します。この色は、最上位バイトが0で、次に赤・緑・青の値の順に表される32ビットRGB値を格納します。有効な値は0から255です。

    画像深度が4の場合、0から15を含む画像の有効値を除いて、画像深度が8の場合と似た動作になります。

    画像深度が1の場合、画像の0の値はすべて色の要素0に対応します。その他のすべての値は、色の要素1に対応します。

  • c1du8.png マスク —

    マスクは、ピクセルについてマスク情報を記述する各ビットのバイトの配列です。最初のバイトは最初の8ピクセルを表し、2番目のバイトはその次の8ピクセルを表すというようになります。

    1ビットが0の場合、LabVIEWでは対応するピクセルを透明として描画します。配列が空の場合、LabVIEWでは透明度なしですべてのピクセルを描画します。画像内の各ピクセルに対して配列に1ビットが含まれない場合、LabVIEWは透明度なしで配列から欠如したピクセルを描画します。

  • c1du32.png 色 —

    色は、画像でRGBカラーの値に対応するRGBカラー値の配列です。画像深度の値は、LabVIEWでの出力値の解釈方法を指定します。

    画像深度が24の場合、LabVIEWはこの入力を無視します。

    画像深度が8の場合、配列には256の要素があります。

    画像深度が4の場合、配列には16の要素があります。

    画像深度が1の場合、配列には2の要素があります。

  • cnclst.png 長方形 —

    境界は、画像の四角形枠を表す座標を含むクラスタです。

    VIは、境界の幅と高さに合わせて画像をクリップします。境界枠の右下隅には画像ピクセルは含まれません。水平座標は右方向に増加し、垂直座標は下方向に増加します。

  • ci16.png 左 —

    左は、四角形の左端の水平座標です。

  • ci16.png 上 —

    上は、四角形の上端の垂直座標です。

  • ci16.png 右 —

    右は、四角形の右端の水平座標です。

  • ci16.png 下 —

    下は、四角形の下端の垂直座標です。

  • cu32.png マスクカラー (黒) —

    マスクカラーは、24ビット、8ビット、4ビットの画像を透明で表示する画像の色です。

    この入力には、カラーボックス定数を配線できます。

  • cbool.png 1ビットマスク値 (T) —

    1ビットマスク値がTRUE (デフォルト) の場合、VIは、1の指標を含む画像配列内のすべての要素を透明に描画します。FALSEの場合、VIは0の指標を含むすべての要素を透明に描画します。

    画像データが1ビット画像を描画しない場合、VIはこの入力を無視します。

  • cbool.png マスク統合? (F) —

    マスク統合?がTRUEの場合、VIは、画像の既存のマスク情報およびこのVIに配線したマスク情報を統合し、すべてのマスク情報を画像に適用します。FALSE (デフォルト) の場合、このVIに配線したマスク情報のみを適用します。FALSE (デフォルト) の場合、このVIに配線したマスク情報のみを適用します。

  • icclst.png 画像データ —

    画像データは、描画または操作する画像を示します。

  • ii32.png 画像タイプ —

    画像タイプは、将来の使用に備えて予約されています。

  • ii32.png 画像深度 —

    画像深度は、画像のカラー深度を指定します。これは、画像の各ピクセルの色を表示するために使用するビット数です。有効な値は、1ピクセルあたり1、4、8、および、24ビットです。

    画像深度は、LabVIEWでの画像および色の値の解釈方法に影響します。

  • i1du8.png 画像 —

    画像は、ラスター順で画像にある各ピクセルの色を表すバイトの配列です。画像深度の値は、LabVIEWでのこの入力値の解釈方法を指定します。

    画像深度が24の場合、各ピクセルは3バイトで色を表示します。各ピクセルの最初のバイトは赤の値、2番目のバイトは緑の値、そして、3番目の値は青の値を示します。

    画像深度が8の場合、各ピクセルは1バイトで色を表示します。各ビットの値は、赤、緑、青の値が後に続く、最上位バイトがゼロの32ビットRGB値を格納する色の要素に対応します。有効な値は0から255です。

    画像深度が4の場合、0から15を含む画像の有効値を除いて、画像深度が8の場合と似た動作になります。

    画像深度が1の場合、画像の0の値はすべて色の要素0に対応します。その他のすべての値は、色の要素1に対応します。

    配列のサイズは、パッディングのため、予想以上のサイズになる可能性があります。

  • i1du8.png マスク —

    マスクは、ピクセルについてマスク情報を記述する各ビットのバイトの配列です。最初のバイトは最初の8ピクセルを表し、2番目のバイトはその次の8ピクセルを表すというようになります。

    1ビットが0の場合、LabVIEWでは対応するピクセルを透明として描画します。配列が空の場合、LabVIEWでは透明度なしですべてのピクセルを描画します。画像内の各ピクセルに対して配列に1ビットが含まれない場合、LabVIEWは透明度なしで配列から欠如したピクセルを描画します。

  • i1du32.png 色 —

    色は、画像でRGBカラーの値に対応するRGBカラー値の配列です。画像深度の値により、LabVIEWでこの入力値が解釈される方法が決定します。色は、最上位バイトがゼロで、次に赤・緑・青の値の順に表される32ビットのRGB値を格納します。有効な値は0から255です。

    画像深度が24の場合、LabVIEWはこの出力を無視します。

    画像深度が8の場合、配列には256の要素があります。

    画像深度が4の場合、配列には16の要素があります。

    画像深度が1の場合、配列には2の要素があります。

    ピクセルあたり24ビット以外の深度の配列が空の場合、画像はLabVIEWのカラーパレットを使用します。

  • inclst.png 長方形 —

    境界は、画像を描くための四角形枠を表す座標を含むクラスタです。

    水平座標は右方向に増加し、垂直座標は下方向に増加します。

  • ii16.png 左 —

    左は、四角形の左端の水平座標です。

  • ii16.png 上 —

    上は、四角形の上端の垂直座標です。

  • ii16.png 右 —

    右は、四角形の右端の水平座標です。

  • ii16.png 下 —

    下は、四角形の下端の垂直座標です。

    • 「ピックスマップを平坦化」VIを使用して、ピックスマップを画像データへ配線可能なクラスタに変換します。画像が4ビット、8ビット、または24ビットの場合、カラーをマスクカラー入力に配線します。画像が1ビットの場合、値を1ビットマスク値入力に配線します。

    サンプルプログラム

    LabVIEWに含まれている以下のサンプルファイルを参照してください。

    • labview\examples\Graphics and Sound\2D Picture Control\Using Mask with Picture.vi