Funktionsbaustein

FB_Pixel_LED

Inputs

Name	Typ	Beschreibung
tTimeout	TIME	Timout für den Übertragungsprozess zur Klemme
bShow	BOOL	Steigende Flanke startet die Übertragung und Anzeige der Daten

Outputs

Name	Typ	Beschreibung
bBusy	BOOL	Ist TRUE, wenn der FB Daten an die Klemme überträgt. Daten können in dieser Zeit nicht geändert werden

Definition von Konstanten

Folgende Konstanten müssen vor dem Start des Programms im Funktionsbaustein definiert werden:

Name	Typ	Beschreibung
nWidth	INT	Breite der gesamten Matrix
nHeigth	INT	Höhe der gesamten Matrix
XTiles	INT	Anzahl der einzelnen Matrizen in X-Richtung (Breite)
YTiles	INT	Anzahl der einzelnen Matrizen in Y-Richtung (Höhe)
bMatrixSerpentineLayout	INT(0..1)	Layout-Typ (siehe M_CursorToIndex)
bMatrixVertical	INT(0..1)	Layout der LED-Zeilen ist vertikal (siehe M_CursorToIndex)
nNumberofChannels	INT	Anzahl der verwendeten EL2574-Kanäle

Methoden

• M_ClearAll

Mit dieser Methode können alle Elemente des Arrays auf den Wert 0 gesetzt werden.

• M_Clear

Mit dieser Methode können alle Elemente des Arrays in einem vorgegebenen Rechteck auf den Wert 0 gesetzt werden.

Inputs

Name	Typ	Beschreibung
nX1	INT	Startposition der zu löschenden Pixel in X Richtung
nY1	INT	Startposition der zu löschenden Pixel in Y Richtung
nX2	INT	Endposition der zu löschenden Pixel in X Richtung
nY2	INT	Endposition der zu löschenden Pixel in Y Richtung

• M_DrawImage

Mit dieser Methode kann ein Bild statisch auf einer Matrix angezeigt werden.

Inputs

Name	Typ	Beschreibung
nXPosition	INT	Startposition zum anzeigen des Bildes in X Richtung
nYPosition	INT	Startposition zum anzeigen des Bildes in Y Richtung
pImageArray	POINTER TO ARRAY [0..0] OF DWORD	Pointer auf das Array, das die Bilddaten enthält
pImageWidth	POINTER TO INT	Pointer auf die Breite des Bildes
pImageHeight	POINTER TO INT	Pointer auf die Höhe des Bildes

Um Bilder anzuzeigen, kann die mitgelieferte HTML-Seite ImageConverter.html (s. Kapitel „ImageConverter.html“) verwendet werden. Das dort hochgeladene Bild sollte die Auflösung der Pixelmatrix nicht überschreiten, kleinere Bilder können ohne Einschränkung verwendet werden. Nach dem Hochladen einer Bilddatei wird die Webseite eine Textdatei herunterladen. Diese Datei enthält SPS-Variablendefinitionen, die in das SPS-Projekt aufgenommen werden müssen. Dies kann z.B. durch Kopieren des Inhalts in eine GVL geschehen. Mit der Methode „M_DrawImage“ kann das Bild auf der Matrix dargestellt werden, indem die Adressen der kopierten Variablen den Eingabezeigern der Methode zugewiesen werden.

• M_DrawText

Mit dieser Methode kann einen String statisch auf einer Matrix angezeigt werden.

Inputs

Name	Typ	Beschreibung
nXPosition	INT	Startposition zum anzeigen des Texts in X Richtung
nYPosition	INT	Startposition zum anzeigen des Texts in Y Richtung
nColor	DWORD	Textfarbe (0xWWBBGGRR)
sText	STRING	Anzeigetext

In dem Funktionsbaustein ist eine Basisschriftart im Deklarationsbereich der Konstanten hinterlegt. Um eine andere Schriftart und / oder Schriftgröße zu verwenden, kann die mitgelieferte HTML-Seite FontConverter.html (s. Kapitel „FontConverter.html“) verwendet werden.

• M_ScrollText

Mit dieser Methode kann ein String von rechts nach links durchlaufend auf einer Matrix angezeigt werden.

Inputs

Name	Typ	Beschreibung
nXPosition	INT	Startposition zum anzeigen des Texts in X Richtung
nYPosition	INT	Startposition zum anzeigen des Texts in Y Richtung
nXEndPosition	INT	Endposition zum anzeigen des Texts in X Richtung Hinweis: Ist nXEndPosition = -1 wird der Text ab der Startposition über die gesamte Breite der Matrix ausgegeben
nScrollPosition	POINTER TO INT	Zeiger auf Hilfsvariable, um die Scrollposition zu verfolgen (für jeden Text wird eine Hilfsvariable benötigt)
nColor	DWORD	Textfarbe (0xWWBBGGRR)
sText	STRING	Anzeigetext

In dem Funktionsbaustein ist eine Basisschriftart im Deklarationsbereich der Konstanten hinterlegt. Um eine andere Schriftart und / oder Schriftgröße zu verwenden kann die mitgelieferte HTML-Seite FontConverter.html (s. Kapitel 6.3.2) verwendet werden.

• M_RotateAll

Mit dieser Methode wird der gesamte Inhalt der Matrix in eine vorgegebene Richtung rotiert.

Inputs

Name

Typ

Beschreibung

nDirection

INT(0…3)

Richtungsvorgabe

0: Links, 1: Rechts, 2: Hoch, 3: Runter

• M_Rotate

Mit dieser Methode wird der Inhalt der Matrix in einem vorgegebenen Rechteck in eine vorgegebene Richtung rotiert.

Inputs

Name	Typ	Beschreibung
nDirection	INT(0…3)	Richtungsvorgabe 0: Links, 1: Rechts, 2: Hoch, 3: Runter
nX1	INT	Startposition der zu rotierenden Pixel in X Richtung
nY1	INT	Startposition der zu rotierenden Pixel in Y Richtung
nX2	INT	Endposition der zu rotierenden Pixel in X Richtung Hinweis: Ist nX2 = -1 wird ab nX1 über die gesamte Breite der Matrix rotiert
nY2	INT	Endposition der zu rotierenden Pixel in Y Richtung Hinweis: Ist nY2 = -1 wird ab nY1 über die gesamte Höhe der Matrix rotiert

• M_SetPixel

Mit dieser Methode können einzelne Pixel in einer vorgegebenen Farbe eingeschaltet werden.

Inputs

Name	Typ	Beschreibung
nXPosition	INT	Pixelposition in X Richtung
nYPosition	INT	Pixelposition in Y Richtung
nColor	DWORD	Farbe des Pixels (0xWWBBGGRR)

• M_GetPixel

Mit dieser Methode kann die Farbe eines Pixels an einer vorgegebenen Stelle aus dem Buffer ausgelesen werden.

Inputs

Name	Typ	Beschreibung
nXPosition	INT	Pixelposition in X Richtung
nYPosition	INT	Pixelposition in Y Richtung
nColor	DWORD	Farbe des Pixels (0xWWBBGGRR)

Outputs

Name	Typ	Beschreibung
M_GetPixel	DWORD	Farbe des Pixels (0xWWBBGGRR)