フロントパネルの画像を平坦化されたピックスマップとして返します。フロントパネル:スケールされた画像を取得メソッドを使用して、フロントパネルの画像を返し、メソッドに配線した最大幅および最大の高さに比例させるようにスケールします。

フロントパネルが非表示の場合、LabVIEWはフロントパネルのオブジェクトの値を更新しません。フロントパネルが表示されていないVIを呼び出し、フロントパネル:画像を取得メソッドを使用してフロントパネルの画像を作成する場合、VIの実行時に発生した値の変更はその画像に反映されません。

値の変更を画像に反映させるには、値が変更される前にフロントパネルが開いていることを確認してください。フロントパネルを表示しない場合、値の変更を画像に反映させるには、フロントパネルの画像を作成するVIのブロックダイアグラム上の端子からプロパティノードを作成します。

また、レポートにフロントパネルの画像を作成するには、「フロントパネル画像をレポートに追加」VIを使用します。

パラメータ

名前 データタイプ 必須 説明
可視領域のみ cbool.png いいえ

フロントパネルの画像がフロント表示領域のオブジェクトのみを含む (TRUE) か、フロントパネルのすべてのオブジェクトを含む (FALSE) かを指定します。デフォルトはTRUEです。

画像深度 ci32.png いいえ

画像のカラー深度またはサポートされている色の数を、1 (1ビット、白黒)、4 (4ビット、16色)、8 (8ビット、256色)、24 (24ビット、トゥルーカラー)、または32 (32ビット、ARGB形式) で示します。デフォルトは8です。

画像データ icclst.png いいえ
平坦化ピックスマップ描画」VIを使用して画像をピクチャとして描画したり、「グラフィック形式」VIを使用して画像をファイルに保存するために必要な画像の情報です。このクラスタは「JPEGファイルを読み取る」、「PNGファイルを読み取る」、および「BMPファイルを読み取る」VIの画像データ出力と似ています。
  • image type-Reservedfor future use.
  • image depth-画像の色深度を指定します。これは、画像の各画素の色を記述するために使用するビット数です。有効な値は、 14824 ビット/ピクセルです。 画像深度は 、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) である。枠の右下隅には画像が含まれません。

備考欄

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

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