LCD Menu Hauptseite - Versionsgeschichte

Mat: /* Spenden */

2017-08-31T03:21:09Z

‎Spenden

Mat: /* Programmierinterface */

2011-07-17T03:45:12Z

‎Programmierinterface

Mat: /* Download */

2011-07-11T20:15:29Z

‎Download

Mat: /* Donate */

2011-07-11T20:13:18Z

‎Donate

Mat: /* Samples */

2011-07-11T20:12:32Z

‎Samples

Mat am 11. Juli 2011 um 20:05 Uhr

2011-07-11T20:05:00Z

Mat: /* How to use it */

2011-07-11T18:55:27Z

‎How to use it

Mat: Created page with "== Übersicht == Das ist ein Menü-System für alphanumerische Standard-LCDs mit mindestens 2 Zeilen. Um durch das Menü zu navigieren benötigt man nur 3 Tasten (+, -, Enter) o..."

2011-07-11T02:05:42Z

Created page with "== Übersicht == Das ist ein Menü-System für alphanumerische Standard-LCDs mit mindestens 2 Zeilen. Um durch das Menü zu navigieren benötigt man nur 3 Tasten (+, -, Enter) o..."

Neue Seite

== Übersicht ==
Das ist ein Menü-System für alphanumerische Standard-LCDs mit mindestens 2 Zeilen.

Um durch das Menü zu navigieren benötigt man nur 3 Tasten (+, -, Enter) oder einen Drehencoder mit eingebautem Taster.

Die Menü-Struktur kann beliebig tief verschachtelt sein, versteckte Sub-Menüs sind möglich (aber noch nicht vom Designer unterstützt).
Weiters kann man durch einen Menüeintrag eine beliebige Funktion ausführen oder Variableninhalte anzeigen und editieren (Alle Bascom-Typen werden unterstützt).

Die Menü-Struktur und damit verknüpfte Daten werden aus dem Flash geladen zur Laufzeit in Arrays verwaltet, die Menüpunkte werden mithilfe ihrer Indexes verknüpft.

Numerische Variableninhalte werden gleichzeitig als Zahl und grafisch mit einem [[LCD Bargraph with different styles|Bargraph]], welcher die momentane Position innerhalb des spezifizierten Intervalls darstellt, angezeigt.

Bit Variablen können auf On/Off (oder einen anderen beliebigen Text) gesetzt werden, numerische Werte werden mit der eingestellten Schrittgröße in- oder dekrementiert und Strings können mithilfe einer wählbaren Zeichentabelle (und 2 Spezialzeichen zum Löschen/Bestätigen) editiert werden.

Um Flash-Speicher zu sparen werden nur benötigte Code-Teile kompiliert. Am wenigsten Speicherplatz wird benötigt, wenn nur Links und Funktionen verwendet werden. Der Speicherverbrauch steigt jeweils mit der Verwendung von Read-Only Werten, editierbaren Werten oder beiden und zusätzlich für jeden im Menü verwendeten Datentyp.

== Video Demo ==
In diesem [http://www.vimeo.com/25921689 Video] ist das Menü in Aktion zu sehen.

== How to use it ==
=== Setup ===
Include the menu structure created with the designer and the menu functions:
<pre>Macro Menu_include_data
$include "inc\menu_data.bas"
End Macro
$include "inc\menu.bas"</pre>

=== Dimension used Variables ===
Between the function include and the initialisation you have to dimension the variables used to display or edit in the menu:
<pre>Dim Test_bit As Byte
Dim Test_byte As Byte
Dim Test_word As Word
Dim Test_integer As Integer
Dim Test_dword As Dword
Dim Test_long As Long
Dim Test_single As Single
Dim Test_double As Double
Dim Test_string As String * Menu_value_string_width</pre>
Bit data types have to be defined as a byte.
Note that a constant was created containing the maximum string size.

=== Initialisation ===
<pre>Menu_init</pre>

=== Main Loop ===
<pre>Do
If Switch_minus = 1 Then Menu_backward() ' back button pressed
If Switch_plus = 1 Then Menu_forward() ' forward button pressed
If Switch_enter = 1 Then ' enter button pressed
Select Case Menu_enter()
Case Menu_exit: ' Exit entry selected
...
Case 2-255: ' Function call
...
End Select
End If
Menu ' Main function
...
Loop</pre>

== Interface description ==
<pre>Const Menu_default_entry</pre>
ID of the default entry

<pre>Const Menu_value_string_width</pre>
size for strings used to display

<pre>Macro Menu_init</pre>
loads the menu data

<pre>Macro Menu_check_update</pre>
call this macro in the time interval you wish to update read-only values

<pre>Declare Sub Menu()</pre>
Main function, called in Main Loop

<pre>Declare Sub Menu_forward()</pre>
Goes one step forward in the menu or while in edit mode, bit values are set to true, numerical values are increased by the step size and for strings, the following character in the table will be selected.

<pre>Declare Sub Menu_backward()</pre>
Goes one step backward in the menu or while in edit mode, bit values are set to false, numerical values are decreased by the step size and for strings, the preceeding character in the table will be selected.

<pre>Declare Function Menu_enter() As Byte</pre>
Shows the menu if inactive, follows a link, enters/exits the edit mode, adds a character in string edit mode or selects a function

<pre>Declare Sub Menu_show(byval Entry_id As Byte)</pre>
Displays the menu with the provided entry id, if 0, the default entry is selected

<pre>Declare Sub Menu_hide()</pre>
hides the menu

== LCD Menu Designer ==
=== Global Settings ===
[[File:Menu_designer_settings.jpg|frameless|Global menu settings]]

When the first entry in the menu tree is selected, the global settings are visible. Here you can select the LCD character width, the visual style for the [[LCD Bargraph with different styles|bargraph]], edit the character table used in string edit mode and choose the texts to display for bit values (Default is On/Off, you can set it for example to Yes/No or High/Low etc.).

=== Link ===
[[File:Menu_designer_link.jpg|frameless|Entry is a link, select the target]]

With links you can jump to another entry in the menu, just select it in the right menu tree.
Submenu- and Back entries are also links, but the target is created automatically.

=== Value ===
[[File:Menu_designer_value.jpg|frameless|Value settings]]

Select the variable type (all Bascom types are supported) and choose if the value should be editable or read-only.
In the "Associated variable" field enter the Variable name you declared in your code.
Then set the range of the value (lowest and highest possible value).
If the value is editable, you further have to set its initial value (will be set in Menu_init) and, if its a numerical value, the step size (positive, > 0).

=== Function ===
[[File:Menu_designer_function.jpg|frameless|Function ID select]]

Select a function ID between 2 and 255. When this entry is selected, the menu hides and the Menu()-function returns the ID.

=== Tool: Character Table ===
[[File:Menu_designer_character_table.jpg|frameless|Tool: interactive LCD character table]]

With this little tool it is easy to get the corresponding code for characters supported by alphanumerical LCDs.
Click on the desired character, the calculated code, formatted ready to use in Bascom strings, appears in the text field below.

== Samples ==
=== Sample 1: Small menu ===
[[LCD Menu Sample 1]]

=== Sample 2: All functions ===
[[LCD Menu Sample 2]]

== Donate ==
This Software is [http://en.wikipedia.org/wiki/Donationware Donationware].
<paypal>1</paypal>
[[About|See here]] for more informations

== Download ==
* [http://www.braunecker.at/downloads/lcd_menu_1_1.zip LCD Menu Version 1.1]
To install the Menu Designer, run setup.exe with administrator privileges.

← Nächstältere Version		Version vom 17. Juli 2011, 03:45 Uhr
Zeile 87:		Zeile 87:
	<pre>Declare Sub Menu_backward()</pre>		<pre>Declare Sub Menu_backward()</pre>
	Geht einen Schritt in der Menüstruktur zurück, oder ändert Variablenwerte. Bits werden auf False (0) gesetzt, numerische Variablen werden mit der gewählten Schrittgröße dekrementiert und bei Strings wird das vorige Zeichen aus der Zeichentabelle ausgewählt.		Geht einen Schritt in der Menüstruktur zurück, oder ändert Variablenwerte. Bits werden auf False (0) gesetzt, numerische Variablen werden mit der gewählten Schrittgröße dekrementiert und bei Strings wird das vorige Zeichen aus der Zeichentabelle ausgewählt.
−	Goes one step backward in the menu or while in edit mode, bit values are set to false, numerical values are decreased by the step size and for strings, the preceeding character in the table will be selected.

@@ Zeile 137: / Zeile 137: @@
 === Beispiel 2: Alle Funktionen ===
 [[LCD Menu Sample 2]]
 == Download ==
 * [http://www.braunecker.at/downloads/lcd_menu_1_1.zip LCD Menu Version 1.1]
 Um den Designer zu installieren muss die Setup.exe mit Administratorrechten ausgeführt werden.

@@ Zeile 139: / Zeile 139: @@
 [[LCD Menu Sample 2]]
-== Donate ==
+== Spenden ==
-This Software is [http://en.wikipedia.org/wiki/Donationware Donationware].
+Diese Software ist [http://de.wikipedia.org/wiki/Donationware Donationware].
 <paypal>1</paypal>
-[[About|See here]] for more informations
+[[About|Hier klicken]] für mehr Informationen
 == Download ==
 * [http://www.braunecker.at/downloads/lcd_menu_1_1.zip LCD Menu Version 1.1]
 To install the Menu Designer, run setup.exe with administrator privileges.

@@ Zeile 132: / Zeile 132: @@
 Mit diesem kleinen Tool kann man einfach den Code für ein bestimmtes Zeichen, welches von alphanumerischen Standard-Displays angezeigt werden kann, herausfinden. Dazu einfach auf das gewünschte Zeichen klicken, der betreffende Code wird zur Verwendung in Bascom Strings formatiert "{xxx}" und im Textfeld angezeigt.
-== Samples ==
+== Beispiele ==
-=== Sample 1: Small menu ===
+=== Beispiel 1: Einfaches Menü ===
 [[LCD Menu Sample 1]]
-=== Sample 2: All functions ===
+=== Beispiel 2: Alle Funktionen ===
 [[LCD Menu Sample 2]]

@@ Zeile 40: / Zeile 40: @@
 Außerdem wird eine Konstante erstellt, die die maximale Länge für Strings angibt.
-=== Initialisation ===
+=== Initialisierung ===
 <pre>Menu_init</pre>
-=== Main Loop ===
+=== Hauptschleife ===
 <pre>Do
-    If Switch_minus = 1 Then Menu_backward()            ' back button pressed
+    If Switch_minus = 1 Then Menu_backward()            ' -/Zurück gedrückt
-    If Switch_plus = 1 Then Menu_forward()              ' forward button pressed
+    If Switch_plus = 1 Then Menu_forward()              ' +/Vorwärts gedrückt
-    If Switch_enter = 1 Then                            ' enter button pressed
+    If Switch_enter = 1 Then                            ' Enter gedrückt
        Select Case Menu_enter()
-       Case Menu_exit:                                  ' Exit entry selected
+       Case Menu_exit:                                  ' Menü wurde über Exit verlassen
           ...
-       Case 2-255:                                      ' Function call
+       Case 2-255:                                      ' Funktionsaufruf
           ...
        End Select
     End If
-    Menu                                                ' Main function
+    Menu                                                ' Menü Hauptfunktion
     ...
 Loop</pre>
-== Interface description ==
+== Programmierinterface ==
 <pre>Const Menu_default_entry</pre>
-ID of the default entry
+Index des Default-Eintrags
 <pre>Const Menu_value_string_width</pre>
-size for strings used to display
+Maximale Größe für Strings in Verwendung mit dem Menü
 <pre>Macro Menu_init</pre>
-loads the menu data
+Lädt die Menüdaten aus dem Flash-Speicher
 <pre>Macro Menu_check_update</pre>
-call this macro in the time interval you wish to update read-only values
+Werden Read-Only Variablen verwendet, muss diese Funktion im gewünschten Intervall aufgerufen zu werden um eine Aktualisierung der Anzeige zu erzwingen.
 <pre>Declare Sub Menu()</pre>
-Main function, called in Main Loop
+Hauptfunktion, wird regelmäßig aus der Hauptschleife aufgerufen
 <pre>Declare Sub Menu_forward()</pre>
-Goes one step forward in the menu or while in edit mode, bit values are set to true, numerical values are increased by the step size and for strings, the following character in the table will be selected.
+Geht einen Schritt in der Menüstruktur weiter, oder ändert Variablenwerte. Bits werden auf True (1) gesetzt, numerische Variablen werden mit der gewählten Schrittgröße inkrementiert und bei Strings wird das nächste Zeichen aus der Zeichentabelle ausgewählt.
 <pre>Declare Sub Menu_backward()</pre>
 Goes one step backward in the menu or while in edit mode, bit values are set to false, numerical values are decreased by the step size and for strings, the preceeding character in the table will be selected.
 <pre>Declare Function Menu_enter() As Byte</pre>
-Shows the menu if inactive, follows a link, enters/exits the edit mode, adds a character in string edit mode or selects a function
+Zeigt das Menü an falls es nicht aktiv ist, folgt einem Link (gewünschter Eintrag wird angezeigt), startet/beendet den Editiermodus oder ruft eine Funktion auf.
 <pre>Declare Sub Menu_show(byval Entry_id As Byte)</pre>
-Displays the menu with the provided entry id, if 0, the default entry is selected
+Zeigt das Menü mit dem übergegebenen Eintrag an, falls 0 übergeben wird, wird der Standardeintrag ausgewählt.
 <pre>Declare Sub Menu_hide()</pre>
-hides the menu
+Schließt das Menü.
 == LCD Menu Designer ==
-=== Global Settings ===
+=== Allgemeine Einstellungen ===
-[[File:Menu_designer_settings.jpg|frameless|Global menu settings]]
+[[File:Menu_designer_settings.jpg|frameless|Allgemeine Einstellungen]]
-When the first entry in the menu tree is selected, the global settings are visible. Here you can select the LCD character width, the visual style for the [[LCD Bargraph with different styles|bargraph]], edit the character table used in string edit mode and choose the texts to display for bit values (Default is On/Off, you can set it for example to Yes/No or High/Low etc.).
+Die allgemeinen Einstellungen werden angezeigt, wenn der oberste Eintrag ausgewählt wird. Hier kann die Zeichenbreite des Displays und der Anzeigestil für den [[LCD Bargraph with different styles|Bargraph]] eingestellt werden, die Zeichentabelle für den String-Editiermodus bearbeitet und der Anzeigetext (Standard ist On/Off, aber An/Aus, High/Low etc. ist genauso möglich) für Bitvariablen gewählt werden.
 === Link ===
-[[File:Menu_designer_link.jpg|frameless|Entry is a link, select the target]]
+[[File:Menu_designer_link.jpg|frameless|Dieser Eintrag ist ein Link, das Ziel auswählen]]
-With links you can jump to another entry in the menu, just select it in the right menu tree.
+Mit Links kann zu einem anderen Menüeintrag gesprungen werden, das Ziel muss in der rechten Baumansicht ausgewählt werden.
-Submenu- and Back entries are also links, but the target is created automatically.
+Intern werden Submenüs und "Back"-Einträge als Links verwaltet, das Ziel wird hierbei automatisch gesetzt.
 === Value ===
-[[File:Menu_designer_value.jpg|frameless|Value settings]]
+[[File:Menu_designer_value.jpg|frameless|Value Einstellungen]]
-Select the variable type (all Bascom types are supported) and choose if the value should be editable or read-only.
-In the "Associated variable" field enter the Variable name you declared in your code.
+Zuerst muss der Typ der Variable (Alle Bascom-Datentypen werden unterstützt) ausgewählt und bestimmt werden, ob der Inhalt nur angezeigt wird (Read-Only) oder auch editierbar ist. Im Feld "Associated variable" wird der Name der Variable, wie in Bascom deklariert, eingetragen.
-Then set the range of the value (lowest and highest possible value).
+Für alle Typen muss im Editiermodus ein Startwert bestimmt werden.
-If the value is editable, you further have to set its initial value (will be set in Menu_init) and, if its a numerical value, the step size (positive, > 0).
+Bei numerischen Variablen muss das Intervall (größter bzw. kleinster mögliche Wert) gesetzt sowie zusätzlich für den Editiermodus die Schrittweite (>0)angegeben werden.
 === Function ===
 [[File:Menu_designer_function.jpg|frameless|Function ID select]]
-Select a function ID between 2 and 255. When this entry is selected, the menu hides and the Menu()-function returns the ID.
+Die Funktion, die der Menüpunkt ausführen soll, wird durch eine beliebige ID zwischen 2 und 255 gekennzeichnet.
-=== Tool: Character Table ===
+=== Tool: Zeichentabelle ===
 [[File:Menu_designer_character_table.jpg|frameless|Tool: interactive LCD character table]]
-With this little tool it is easy to get the corresponding code for characters supported by alphanumerical LCDs.
+Mit diesem kleinen Tool kann man einfach den Code für ein bestimmtes Zeichen, welches von alphanumerischen Standard-Displays angezeigt werden kann, herausfinden. Dazu einfach auf das gewünschte Zeichen klicken, der betreffende Code wird zur Verwendung in Bascom Strings formatiert "{xxx}" und im Textfeld angezeigt.
 == Samples ==

@@ Zeile 18: / Zeile 18: @@
 In diesem [http://www.vimeo.com/25921689 Video] ist das Menü in Aktion zu sehen.
-== How to use it ==
+== Einbinden ins Programm ==
 === Setup ===
-Include the menu structure created with the designer and the menu functions:
+Die vom Designer erstellten Daten und die Funktionen fürs Menü inkludieren:
 <pre>Macro Menu_include_data
     $include "inc\menu_data.bas"
@@ Zeile 26: / Zeile 26: @@
 $include "inc\menu.bas"</pre>
-=== Dimension used Variables ===
+=== Dimensionierung der Variablen ===
-Between the function include and the initialisation you have to dimension the variables used to display or edit in the menu:
+Zwischen dem Include und dem Aufruf der Init-Funktion müssen die Variablen (die im Menü angezeigt oder editiert werden) dimensioniert werden.
 <pre>Dim Test_bit As Byte
 Dim Test_byte As Byte
@@ Zeile 37: / Zeile 37: @@
 Dim Test_double As Double
 Dim Test_string As String * Menu_value_string_width</pre>
-Bit data types have to be defined as a byte.
+Bit Datentypen müssen als Byte deklariert werden.
-Note that a constant was created containing the maximum string size.
+Außerdem wird eine Konstante erstellt, die die maximale Länge für Strings angibt.
 === Initialisation ===
@@ Zeile 58: / Zeile 58: @@
     ...
 Loop</pre>
 == Interface description ==