Mit dieser Funktion wird ein Wert in Form eines Balkens dargestellt. Die Funktion erwartet folgende Parameter:
GfxMode | TxtMode | Parameter | Beschreibung | Wert |
| | Mode | Ausrichtung des Balkens | Horizontal, Vertical |
| | Width | Dimension des Balkens | Zahl |
| | Height | Höhe des Balkens | Zahl |
| | Min | Minimum | Zahl |
| | Max | Maximum | Zahl |
| | Current | aktueller Wert | Zahl |
| | CChars | Anzahl an verwendeten Custom Chars (Auflösung, >= 4) | Zahl |
| | CCharList | CustomChars 1-CChars | CustomChar |
| | FrameWidth | Breite des Balkenrahmens | Zahl |
| | FrameBorder | Platz zwischen Balkenrahmen und Balkeninhalt | Zahl |
| | XPos | X-Position der linken obere Ecke des Balkens auf dem LCD | Zahl |
| | YPos | Y-Position der linken obere Ecke des Balkens auf dem LCD | Zahl |
Es ist auch möglich
CCharList wegzulassen. Dadurch werden die Custom Chars nach der Anordnung im Custom Char File in den Speicher des LCD geschrieben. Die zusätzliche Angabe der CustomChar Codes entfällt dadurch.
Beispiel TxtMode:
%Format.Bar(Horizontal,20,0,20,10,4,
%LCD.CustomChar(0),
%LCD.CustomChar(1),
%LCD.CustomChar(2),
%LCD.CustomChar(3))
Dieser Funktionsaufruf berechnet aus den Werten einen Balken und gibt diesen auf dem LCD aus. Der Balken wird in horizontaler Richtung gezeichnet, hat eine Größe von 20 Zeichen, das Minimum des Balkens ist 0, das Maximum ist 20 und der derzeitige Wert ist 10.
Dabei werden die Custom Chars 0 bis 3 zur Darstellung des Balkens verwendet.
Beispiel GfxMode:
%Format.Bar(Horizontal,100,5,0,20,10,1,1,1,1)