指定する画像データからVIアイコンを設定します。この場合にも、VIアイコンと呼ばれる画像のユーザレイヤが作成され、アイコンエディタダイアログボックスの既存のアイコン情報がすべて削除されます。

ピックスマップを使用してアイコンを設定する場合、このメソッドを使用する前に「ピックスマップを平坦化」VIを使用して、データを画像データクラスタに変換します。ピクチャを使用してアイコンを設定する場合、このメソッドを使用する前に「ピクチャからピックスマップに変換」VIを使用して、データを画像データクラスタに変換します。画像データをこのメソッドに書き込む前に、「マスク作成」VIを使用して特定の色を透明にします。

このメソッドは配線した画像データを適切なカラー深度に変換します。たとえば、4ビット画像データをColor256入力に配線すると、このメソッドは画像データを8ビットのカラー深度に変換します。

画像データをColor16入力に配線しない場合、LabVIEWはColor256入力に配線した画像データを4ビットのカラー深度に変換します。画像データをモノクロ入力に配線しない場合、LabVIEWはColor16入力に配線した画像データを1ビットのカラー深度に変換します。それ以外の場合は、Color256入力に配線された画像データは1ビットのカラー深度に変換されます。

このメソッドに配線した画像データが32 × 32ピクセル以外のサイズで画像を表示する場合、このメソッドは画像を32 × 32ピクセルにサイズ変更します。

画像ファイルからVIアイコンを設定するには、VIアイコン:ファイルから設定メソッドを使用することもできます。

パラメータ

名前 データタイプ 必須 説明
256色 ccclst.png はい
8ビットのVIアイコンを使用する画像データを指定します。アイコンエディタダイアログボックスでは、アイコンが256色 (8ビット) とモノクロ (1ビット) の両方の形式で保存されます。
  • image type-Reservedfor future use.
  • image depth-画像の色深度を指定します。これは、画像の各画素の色を記述するために使用するビット数です。有効な値は、 1、 4、 8、 24 ビット/ピクセルです。 画像深度は 、LabVIEWが 画像と 色の値をどう解釈するかに影響します。
  • image画像の各画素の色をラスター順に記述したバイトの配列。画像深度の値は、LabVIEWでのこの入力値の解釈方法を指定します。

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

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

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

    画像深度が1の場合、画像の0の値はすべて色の要素0に対応します。その他のすべての値は、色の要素1に対応します。
  • mask-各ビットが画素のマスク情報を記述するバイトの配列。最初のバイトは最初の8ピクセルを表し、2番目のバイトはその次の8ピクセルを表すというようになります。1ビットが0の場合、LabVIEWでは対応するピクセルを透明として描画します。配列が空の場合、LabVIEWでは透明度なしですべてのピクセルを描画します。画像内の各ピクセルに対して配列に1ビットが含まれない場合、LabVIEWは透明度なしで配列から欠如したピクセルを描画します。
  • colors- 画像の値に対応するRGBカラー値の配列。画像深度の値は、LabVIEWでのこの入力値の解釈方法を指定します。画像深度が24の場合、LabVIEWはこの入力を無視します。画像深度が8の場合、配列に256の要素が含まれます。画像深度が4の場合、配列に16の要素が含まれます。画像深度が1の場合、配列に2の要素が含まれます。
  • Rectangle -画像の外接矩形を表す座標を含むクラスタで、左上隅が (0,0) である。枠の右下隅には画像が含まれません。
16色 ccclst.png いいえ
4ビットのVIアイコンを使用する画像データを指定します。アイコンエディタダイアログボックスでは、アイコンが256色 (8ビット) とモノクロ (1ビット) の形式のみで保存されます。この入力を使用してアイコンに4ビットの画像データを指定すると、VIアイコン:画像データとして取得メソッドのColor16出力を使用した場合のみにこのデータを取得できます。
  • image type-Reservedfor future use.
  • image depth-画像の色深度を指定します。これは、画像の各画素の色を記述するために使用するビット数です。有効な値は、 1、 4、 8、 24 ビット/ピクセルです。 画像深度は 、LabVIEWが 画像と 色の値をどう解釈するかに影響します。
  • image画像の各画素の色をラスター順に記述したバイトの配列。画像深度の値は、LabVIEWでのこの入力値の解釈方法を指定します。

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

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

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

    画像深度が1の場合、画像の0の値はすべて色の要素0に対応します。その他のすべての値は、色の要素1に対応します。
  • mask-各ビットが画素のマスク情報を記述するバイトの配列。最初のバイトは最初の8ピクセルを表し、2番目のバイトはその次の8ピクセルを表すというようになります。1ビットが0の場合、LabVIEWでは対応するピクセルを透明として描画します。配列が空の場合、LabVIEWでは透明度なしですべてのピクセルを描画します。画像内の各ピクセルに対して配列に1ビットが含まれない場合、LabVIEWは透明度なしで配列から欠如したピクセルを描画します。
  • colors- 画像の値に対応するRGBカラー値の配列。画像深度の値は、LabVIEWでのこの入力値の解釈方法を指定します。画像深度が24の場合、LabVIEWはこの入力を無視します。画像深度が8の場合、配列に256の要素が含まれます。画像深度が4の場合、配列に16の要素が含まれます。画像深度が1の場合、配列に2の要素が含まれます。
  • Rectangle -画像の外接矩形を表す座標を含むクラスタで、左上隅が (0,0) である。枠の右下隅には画像が含まれません。
モノクロ ccclst.png いいえ
1ビットのアイコンを使用する画像データを指定します。アイコンエディタダイアログボックスでは、アイコンが256色 (8ビット) とモノクロ (1ビット) の両方の形式で保存されます。
  • image type-Reservedfor future use.
  • image depth-画像の色深度を指定します。これは、画像の各画素の色を記述するために使用するビット数です。有効な値は、 1、 4、 8、 24 ビット/ピクセルです。 画像深度は 、LabVIEWが 画像と 色の値をどう解釈するかに影響します。
  • image画像の各画素の色をラスター順に記述したバイトの配列。画像深度の値は、LabVIEWでのこの入力値の解釈方法を指定します。

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

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

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

    画像深度が1の場合、画像の0の値はすべて色の要素0に対応します。その他のすべての値は、色の要素1に対応します。
  • mask-各ビットが画素のマスク情報を記述するバイトの配列。最初のバイトは最初の8ピクセルを表し、2番目のバイトはその次の8ピクセルを表すというようになります。1ビットが0の場合、LabVIEWでは対応するピクセルを透明として描画します。配列が空の場合、LabVIEWでは透明度なしですべてのピクセルを描画します。画像内の各ピクセルに対して配列に1ビットが含まれない場合、LabVIEWは透明度なしで配列から欠如したピクセルを描画します。
  • colors- 画像の値に対応するRGBカラー値の配列。画像深度の値は、LabVIEWでのこの入力値の解釈方法を指定します。画像深度が24の場合、LabVIEWはこの入力を無視します。画像深度が8の場合、配列に256の要素が含まれます。画像深度が4の場合、配列に16の要素が含まれます。画像深度が1の場合、配列に2の要素が含まれます。
  • Rectangle -画像の外接矩形を表す座標を含むクラスタで、左上隅が (0,0) である。枠の右下隅には画像が含まれません。

備考欄

以下の表は、このメソッドの 特性の一覧です。

短い名前 VI Icon.Set from Image Data
データタイプ 戻り値なし
ランタイムエンジンで使用可能 いいえ
リアルタイムオペレーティングシステムで利用可能 いいえ
VI実行中に設定可能 はい
フロントパネルをメモリにロード いいえ
使用前に認証が必要 はい
ブロックダイアグラムをメモリにロード いいえ
リモートアクセス可能 はい
ユーザインタフェースがアイドルになるまで待機 いいえ
制御VIで使用可能 はい
グローバルVIで使用可能 はい
指定タイプ定義で使用可能 いいえ
多態性VIで使用可能 はい