Gibt eine Abbildung eines Frontpanel-Objekts aus.

Diese Methode ähnelt der Methode Frontpanel:Bild lesen.

Wenn ein Frontpanel nicht sichtbar ist, werden die Werte in den Frontpanel-Objekten auch nicht im Hintergrund angepasst. Beim Aufruf eines VIs, dessen Frontpanel nicht angezeigt wird, und auf das die Methode "Abbild abfragen" angewandt wird, um eine Abbildung von Frontpanel-Elementen zu erstellen, zeigt das Bild keine Wertänderungen an, die während der VI-Ausführung aufgetreten sind.

Wenn die Abbildung die neuesten Werte enthalten soll, öffnen Sie daher das Frontpanel. Wenn anstelle des Frontpanels Wertänderungen auf der Abbildung zu sehen sein sollen, erstellen Sie an einem beliebigen Blockdiagrammanschluss des betreffenden VIs einen Eigenschaftsknoten.

Sie können auch das VI Abbildung des Elements an Protokoll anfügen verwenden, um eine Abbildung von einem Frontpanel-Element zu erstellen und es an ein Protokoll anzuhängen.

Parameter

Name Datentyp Erforderlich Beschreibung
Bildtiefe ci32.png Nein

Zeigt Farbtiefe bzw. die Anzahl unterstützter Farben der Grafik an: 1 (1-Bit, schwarz/weiß), 4 (4-Bit, 16 Farben), 8 (8-Bit, 256 Farben) oder 24 (24-Bit, true-color). Der Standardwert lautet 8.
Hintergrundfarbe cu32.png Nein

Legt die Hintergrundfarbe der Grafik fest.
Bilddaten icclst.png Nein
Angaben zur Grafik, anhand deren die Grafik mit dem VI Serialisierte Pixmap zeichnen als Bild dargestellt oder mit den VIs für Grafikformate als Datei gespeichert werden kann. Dieser Cluster ist dem Bilddaten-Ausgang der VIs JPEG-Datei lesen, PNG-Datei lesen und BMP-Datei lesen sehr ähnlich.
  • image type-Reservedfor future use.
  • bildtiefe - Gibtdie Farbtiefe des Bildesan, d. h. die Anzahl der Bits, die zur Beschreibung der Farbe jedes Pixels im Bild verwendet werden. Gültige Werte sind 1, 4, 8und 24 Bit pro Pixel. Die Bildtiefe beeinflusst, wie LabVIEW die Bild- und Farbwerteinterpretiert.
  • image - Byte-Array, das die Farbe jedes Pixels im Bild in Rasterreihenfolge beschreibt. Wie der Wert dieses Ausgangs interpretiert wird, hängt von der Einstellung der Bildtiefe ab.

    Bei einer Bildtiefe von 24 wird der Farbwert jedes Pixels durch 3 Bytes beschrieben. Das erste Byte jedes Pixels enthält den Rot-Anteil, das zweite den Grün-Anteil und das dritte den Blau-Anteil.

    Bei einer Bildtiefe von 8 wird die Farbe jedes Pixels durch ein Byte beschrieben. Der Wert jedes Bits entspricht einem Element in Farben, das 32-Bit-RGB-Werte speichert, deren MSB 0 ist, gefolgt von den Werten für den Rot-, Grün- und Blau-Anteil.

    Das Gleiche trifft für eine Bildtiefe von 4 zu, nur dass die gültigen Werte in Bild die Werte 0 bis 15 einschließen.

    Wenn Bildtiefe 1 ist, entspricht jeder Nullwert in Bild dem Element 0 in Farben. Alle anderen Werte entsprechen Element 1 in Farben.

    Das Array ist möglicherweise größer als erwartet, da es mit Nullen aufgefüllt wurde.
  • mask - Anordnungvon Bytes, in der jedes Bit die Maskeninformationen für ein Pixel beschreibt. Dabei steht das erste Byte für die ersten acht Pixel, das zweite für die nächsten acht usw. Wenn ein Bit 0 ist, wird das entsprechende Pixel transparent dargestellt. Bei einem leeren Array wird keines der Pixel transparent dargestellt. Wenn das Array zu einem Pixel kein Bit enthält, werden alle fehlenden Pixel nicht transparent dargestellt.
  • colors - Reihevon RGB-Farbwerten, die den Werten im Bildentsprechen. Wie der Wert dieses Ausgangs interpretiert wird, hängt von der Einstellung der Bildtiefe ab. Bei einer Bildtiefe von 24 wird dieser Eingang ignoriert. Bei einer Bildtiefe von 8 hat das Array 256 Elemente. Bei einer Bildtiefe von 4 hat das Array 16 Elemente. Bei einer Bildtiefe von 1 hat das Array 2 Elemente.
  • Rechteck-Cluster, das Koordinaten enthält, die das begrenzende Rechteck des Bildes beschreiben, wobei die linke obere Ecke bei (0,0) liegt. Die unteren rechten Ecken der Begrenzung enthält kein Bild.

Anmerkungen

Diese Methode hat folgende Merkmale:

Kurzname Bild lesen
Datentyp Kein Ausgabewert
In Runtime-Engine verfügbar Ja
Für Real-Time-Betriebssystem verfügbar Ja
Bei laufendem VI einstellbar Ja
Lädt das Frontpanel in den Speicher Nein
Vor Benutzung zu authentifizieren Nein
Lädt das Blockdiagramm in den Speicher Nein
Netzwerkzugriff erlaubt Ja