Fragt die VI-Hierarchie in verkleinerter Darstellung ab.

Syntax

object.GetHierImgScaled(imgdepth, imgdata, maxwidth, maxheight, VIToHighlight)

Parameter

NameTypBeschreibung
imgdepthlongGibt die Farbtiefe oder Anzahl der unterstützten Farben des Bildes 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.
imgdataBilddaten

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.

  • image type—Für zukünftige Verwendung reserviert.
  • Bildtiefe—Gibt die Farbtiefe des Bilds an, also die Anzahl der Bits, die für die Beschreibung der Farbe jedes Bildpunkts notwendig sind. Für diesen Parameter sind die Werte 1, 4, 8und 24 Bits pro Pixel zulässig. Die Bildtiefe beeinflusst, wie LabVIEW die Werte von Bild und Farbeninterpretiert.
  • image—Array aus Bytes, das die Farbe jedes Bildpunkts in Rasterordnung bestimmt 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—Array aus Bytes, in denen jedes Bit die Maskierung eines Bildpunkts 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.
  • Farben—Array der RGB-Werte, die den Werten in 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.
  • Rectangle—Cluster, der die Koordinaten zur Beschreibung des Inhaltsbereichs des Bilds enthält, wobei die linke obere Ecke (0,0) ist. Die unteren rechten Ecken der Begrenzung enthält kein Bild.
maxwidthlongGibt die Breite der ausgegebenen Grafik an. Bei 0 hat die ausgegebene Grafik die gleiche Breite wie Standardgrafiken in der VI-Hierarchie. Darüber hinaus wird das ausgegebene Bild nicht verzerrt, wenn die Maximale Breite und die Maximale Höhe nicht das gleiche Verhältnis wie bei der Standardgrafik haben.
maxheightlongGibt die Höhe der ausgegebenen Grafik an. Bei 0 hat die ausgegebene Grafik die gleiche Höhe wie Standardgrafiken in der VI-Hierarchie. Darüber hinaus wird das ausgegebene Bild nicht verzerrt, wenn die Maximale Breite und die Maximale Höhe nicht das gleiche Verhältnis wie bei der Standardgrafik haben.
VIToHighlightVariantGibt an, welches VI in der Hierarchie hervorgehoben werden soll. LabVIEW markiert das VI durch einen lilafarbenen Rand und blendet zusätzlich Teile der Hierarchie ein oder aus, so dass es am besten erkennbar ist.

Ausgabewert

Keine