Gibt eine Abbildung des Frontpanels als 1D-Pixmap aus. Mit der Methode Frontpanel:Skaliertes Bild lesen wird eine Frontpanel-Abbildung mit den Maßen erzeugt, die mit der Methode verbunden wurden.

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 sichtbar ist und auf das die Methode "Frontpanel:Panel-Grafik abfragen" angewandt wird, enthält die Abbildung keine Wertänderungen, die während der Ausführung des VIs 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.

Ebenso können Sie mit dem VI Frontpanel-Grafik an Protokoll anfügen eine Frontpanel-Grafik erstellen und an ein Protokoll anfügen.

Parameter

Name Datentyp Erforderlich Beschreibung
Nur sichtbarer Bereich cbool.png Nein

Zeigt an, ob die Frontpanel-Grafik nur die Objekte im sichtbaren Bereich des Frontpanels (TRUE) enthält oder alle Frontpanel-Objekte (FALSE). Die Standardeinstellung lautet TRUE.
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), oder 32 (32 Bit, ARGB-Format). Der Standardwert lautet 8.
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 FP.Bild lesen
Datentyp Kein Ausgabewert
In Runtime-Engine verfügbar Ja
Für Real-Time-Betriebssystem verfügbar Nein
Bei laufendem VI einstellbar Ja
Lädt das Frontpanel in den Speicher Ja
Vor Benutzung zu authentifizieren Nein
Lädt das Blockdiagramm in den Speicher Nein
Netzwerkzugriff erlaubt Ja
Benutzeroberfläche muss erst im Ruhezustand sein Ja
Für Element-VIs verfügbar Ja
Für globale VIs verfügbar Ja
Für strikte Typdefinitionen verfügbar Nein
Für polymorphe VIs verfügbar Ja