Erstellt ein VI-Symbol aus den angegebenen Bilddaten. LabVIEW erzeugt für die Grafik eine Benutzerebene mit dem Namen VI-Symbol und löscht alle sonstigen Bilddaten aus dem Symbol-Editor.

Wenn das Symbol mit einer Pixmap festgelegt werden soll, wandeln Sie vor Anwendung dieser Methode die Daten mit dem VI 2D-Pixmap nach 1D in einen Bilddaten-Cluster um. Wenn eine bestimmte Grafik für das Symbol verwendet werden soll, wandeln Sie vor Anwendung dieser Methode die Daten mit dem VI Bild nach Pixmap in einen Bilddaten-Cluster um. Mit dem VI Maske erstellen kann eine bestimmte Farbe in den Bilddaten vor dem Übertragen der Daten an die Methode transparent dargestellt werden.

Mit dieser Methode werden die mit einem Eingang verbundenen Bilddaten in die entsprechende Farbtiefe umgewandelt. Wenn zum Beispiel 4-Bit-Bilddaten an den Eingang 256-Farben angeschlossen werden, wandelt die Methode die Bilddaten in eine Farbtiefe von 8 Bit um.

Wenn Sie keine Bilddaten mit dem Eingang 16Farben verbinden, werden die am Eingang 256Farben angeschlossenen Bilddaten in eine Farbtiefe von 4 Bit umgewandelt. Wenn Sie keine Bilddaten mit dem Eingang Schwarz/Weiß verbinden, werden eventuell am Eingang 16Farben anliegende Bilddaten in eine Farbtiefe von einem Bit umgewandelt. Anderenfalls werden die am Eingang 256Farben anliegenden Bilddaten in 1-Bit-Farben umgewandelt.

Wenn die Bilddaten, die mit dieser Methode verbunden wurden, ein Bild bezeichnen, das 32 x 32 Pixel über- oder unterschreitet, wird das Bild durch die Methode auf 32 x 32 Pixel gebracht.

Zum Erstellen von VI-Symbolen aus Grafikdateien kann auch die Methode VI-Symbol:Aus Datei verwendet werden.

Parameter

Name Datentyp Erforderlich Beschreibung
256 Farben ccclst.png Ja
Gibt die Bilddaten an, die als 8-Bit-VI-Symbol genutzt werden sollen. Symbole werden im Symbol-Editor sowohl in 256 Farben (8 Bit) als auch in Schwarz/Weiß (1 Bit) gespeichert.
  • 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. Je nach Bildtiefe werden die Werte in diesem Eingang unterschiedlich interpretiert.

    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.
  • 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. Je nach Bildtiefe werden die Werte in diesem Eingang unterschiedlich interpretiert. Bei einer Bildtiefe von 24 ignoriert LabVIEW diesen Eingang. 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.
16 Farben ccclst.png Nein
Gibt die Bilddaten an, die als 4-Bit-VI-Symbol genutzt werden sollen. Symbole werden im Symbol-Editor nur in 256 Farben (8 Bit) und in Schwarz/Weiß (1 Bit) gespeichert. Wenn Sie mit diesem Eingang Bilddaten mit einer Farbtiefe von 4 Bit angeben, können diese nur mit dem Ausgang 16Farben der Methode VI-Symbol:Als Bilddaten lesen abgefragt werden.
  • 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. Je nach Bildtiefe werden die Werte in diesem Eingang unterschiedlich interpretiert.

    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.
  • 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. Je nach Bildtiefe werden die Werte in diesem Eingang unterschiedlich interpretiert. Bei einer Bildtiefe von 24 ignoriert LabVIEW diesen Eingang. 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.
Schwarz/Weiß ccclst.png Nein
Gibt die Bilddaten an, die als 1-Bit-Symbol genutzt werden sollen. Symbole werden im Symbol-Editor sowohl in 256 Farben (8 Bit) als auch in Schwarz/Weiß (1 Bit) gespeichert.
  • 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. Je nach Bildtiefe werden die Werte in diesem Eingang unterschiedlich interpretiert.

    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.
  • 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. Je nach Bildtiefe werden die Werte in diesem Eingang unterschiedlich interpretiert. Bei einer Bildtiefe von 24 ignoriert LabVIEW diesen Eingang. 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 VISymbol.Aus Bilddaten erzeugen
Datentyp Kein Ausgabewert
In Runtime-Engine verfügbar Nein
Für Real-Time-Betriebssystem verfügbar Nein
Bei laufendem VI einstellbar Ja
Lädt das Frontpanel in den Speicher Nein
Vor Benutzung zu authentifizieren Ja
Lädt das Blockdiagramm in den Speicher Nein
Netzwerkzugriff erlaubt Ja
Benutzeroberfläche muss erst im Ruhezustand sein Nein
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