Wendet eine Maske auf eine Grafik an und gibt Angaben dazu im Element Maske von Bilddaten aus. Dieses VI ist hilfreich, wenn eine Farbe innerhalb einer Grafik transparent erscheinen soll, bevor die Grafik an ein 2D-Bildelement übertragen wird.


icon

Ein-/Ausgänge

  • ccclst.png Bilddaten —

    Bilddaten gibt die Grafik aus, so dass sie mit dem VI Serialisierte Pixmap zeichnen als Bild dargestellt werden kann.

  • ci32.png Bildtyp —

    Bildtyp ist für die zukünftige Verwendung reserviert.

  • ci32.png Bildtiefe —

    Bildtiefe ist die Farbtiefe der Grafik in Form der Bitanzahl, die zur Beschreibung der Farbe jedes Pixels notwendig ist. Für diesen Parameter sind die Werte 1, 4, 8 und 24 (Bits pro Pixel) zulässig.

    Die Bildtiefe beeinflusst, wie LabVIEW die Werte in Bild und Farben interpretiert.

  • c1du8.png Bild —

    Bild ist ein Array aus Bytes, das die Farbe jedes Pixels in der Rastergrafik 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 Bytes entspricht einem Element in Farben. Das Array enthält 32-Bit-RGB-Werte, deren MSB 0 ist, gefolgt von den Werten für den Rot-, Grün und Blau-Anteil. Der Wert kann im Bereich von 0 bis 255 liegen.

    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.

  • c1du8.png Maske —

    Maske ist ein Array aus Bytes, in denen jedes Bit die Maskierung eines Pixels 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.

  • c1du32.png Farben —

    Farben ist ein Array der RGB-Werte, die den Werten in Bild entsprechen. Wie der Wert dieses Ausgangs interpretiert wird, hängt von der Einstellung der Bildtiefe ab.

    Bei einer Bildtiefe von 24 ignoriert LabVIEW diesen Eingang.

    Bei einer Bildtiefe von 8 kann das Array 256 Elemente enthalten.

    Bei einer Bildtiefe von 4 kann das Array 16 Elemente enthalten.

    Bei einer Bildtiefe von 1 kann das Array 2 Elemente enthalten.

  • cnclst.png Rechteck —

    Rechteck ist ein Cluster mit den Koordinaten der Grafik.

    Alle Bildteile, die über die Breite und Höhe des Rechtecks hinausgehen, werden abgeschnitten. Die untere und die rechte Kante der Begrenzung enthalten keine Pixel. (Der Koordinatenursprung befindet sich in der linken unteren Ecke.)

  • ci16.png Links —

    Links ist die x-Koordinate des linken Rands des Rechtecks.

  • ci16.png Oben —

    Oben ist die y-Koordinate des oberen Rands des Rechtecks.

  • ci16.png rechts —

    Rechts ist die x-Koordinate des rechten Rands des Rechtecks.

  • ci16.png Unten —

    Unten ist die y-Koordinate des unteren Rands des Rechtecks.

  • cu32.png Maskenfarbe (Schwarz) —

    Maskenfarbe ist die Farbe für 24-, 8- und 4-Bit-Bilder, die transparent angezeigt werden soll.

    Mit diesem Eingang kann auch eine Farbfeldkonstante verbunden werden.

  • cbool.png 1-Bit-Maskenwert (T) —

    Wenn 1-Bit Maskenwert TRUE ist (Standard), werden alle Elemente im Array Grafik mit dem Index 1 transparent dargestellt. Bei FALSE werden alle Elemente mit dem Index 0 transparent dargestellt.

    Wenn die Bilddaten keine 1-Bit-Grafik beschreiben, wird der Eingang ignoriert.

  • cbool.png Masken kombinieren? (F) —

    Wenn Masken kombinieren? TRUE ist, werden die vorhandenen Angaben zur Maskierung der Grafik, und die, die Sie mit dem VI verbunden haben, miteinander kombiniert und auf die Grafik angewandt. Bei FALSE (Standard) wird nur mit den Angaben gearbeitet, die Sie bereitgestellt haben.

  • icclst.png Bilddaten —

    Bilddaten ist das darzustellende oder zu verändernde Bild.

  • ii32.png Bildtyp —

    Bildtyp ist für die zukünftige Verwendung reserviert.

  • ii32.png Bildtiefe —

    Bildtiefe ist die Farbtiefe der Grafik in Form der Bitanzahl, die zur Beschreibung der Farbe jedes Pixels notwendig ist. Für diesen Parameter sind die Werte 1, 4, 8 und 24 (Bits pro Pixel) zulässig.

    Die Bildtiefe beeinflusst, wie LabVIEW die Werte in Bild und Farben interpretiert.

  • i1du8.png Bild —

    Bild ist ein Array aus Bytes, das die Farbe jedes Pixels in der Rastergrafik bestimmt. 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. Der Wert kann im Bereich von 0 bis 255 liegen.

    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.

  • i1du8.png Maske —

    Maske ist ein Array aus Bytes, in denen jedes Bit die Maskierung eines Pixels 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.

  • i1du32.png Farben —

    Farben ist ein Array der RGB-Werte, die den Werten in Bild entsprechen. Wie die Werte interpretiert werden, richtet sich nach der Bildtiefe. In Farben werden 32-Bit-RGB-Werte gespeichert, wobei das höchstwertige Bit 0 ist, gefolgt von den Werten für den Rot-, den Grün- und den Blau-Anteil. Der Wert kann im Bereich von 0 bis 255 liegen.

    Bei einer Bildtiefe von 24 wird dieser Eingang ignoriert.

    Bei einer Bildtiefe von 8 kann das Array 256 Elemente enthalten.

    Bei einer Bildtiefe von 4 kann das Array 16 Elemente enthalten.

    Bei einer Bildtiefe von 1 kann das Array 2 Elemente enthalten.

    Wenn das Array für eine andere Tiefe als 24 Bit pro Pixel leer ist, hat das Bild die Standardfarben der LabVIEW-Farbpalette.

  • inclst.png Rechteck —

    Rechteck ist ein Cluster mit den Koordinaten für den Bereich, in dem das Bild angezeigt werden soll.

    (Der Koordinatenursprung befindet sich in der linken unteren Ecke.)

  • ii16.png Links —

    Links ist die x-Koordinate des linken Rands des Rechtecks.

  • ii16.png Oben —

    Oben ist die y-Koordinate des oberen Rands des Rechtecks.

  • ii16.png rechts —

    Rechts ist die x-Koordinate des rechten Rands des Rechtecks.

  • ii16.png Unten —

    Unten ist die y-Koordinate des unteren Rands des Rechtecks.

    • Mit dem VI 2D-Pixmap nach 1D wird der für den Eingang Bilddaten benötigte Cluster erstellt. Verbinden Sie bei 4-, 8- oder 24-Bit-Grafiken eine Farbe mit dem Eingang Maskenfarbe. Handelt es sich um eine 1-Bit-Grafik, geben Sie am Eingang 1-Bit-Maskenwert einen Wert an.

    Beispiele

    Die folgenden Beispieldateien sind in LabVIEW enthalten.

    • labview\examples\Graphics and Sound\2D Picture Control\Using Mask with Picture.vi