GUI - Versionsgeschichte

GooPie4o: /* Einbindung eigener Menüs */

2011-01-07T10:22:28Z

‎Einbindung eigener Menüs

GooPie4o am 7. Jänner 2011 um 10:20 Uhr

2011-01-07T10:20:34Z

FordPrfkt am 5. Jänner 2011 um 14:17 Uhr

2011-01-05T14:17:59Z

FordPrfkt: Die Seite wurde neu angelegt: Zur Erstellung von grafischen Benutzeroberflächen enthält Ethersex die MenuDesigner Bibliothek von Malte Marwedel. http://sourceforge.net/projects/menudesigner/ ==Gr...

2011-01-05T14:13:24Z

Die Seite wurde neu angelegt: Zur Erstellung von grafischen Benutzeroberflächen enthält Ethersex die MenuDesigner Bibliothek von Malte Marwedel. http://sourceforge.net/projects/menudesigner/ ==Gr...

Neue Seite

Zur Erstellung von grafischen Benutzeroberflächen enthält Ethersex die MenuDesigner Bibliothek von Malte Marwedel.
http://sourceforge.net/projects/menudesigner/

==Grundlagen==
MenuDesigner ist eine GUI Bibliothek zur Erstellung und Darstellung von grafischen Menüs.
Sie ist auf Systeme mit sehr beschränkten Ressourcen zugeschnitten und benötigt vergleichsweise
wenig Flash und RAM.
Folgende Widgets werden zur Zeit Unterstützt:
*Windows
*Subwindows
*Box (ein einfaches Rechteck)
*Buttons
*Label
*Checkbox
*Radiobutton
*Listen (scrollbar)
*Grafiken
Alle Texte können zur Laufzeit geändert werden.

Es stehen Events zur Verfügung, die Ausgelöst werden wenn der Benutzer eine Aktion durchführt (Button angeklickt, Radiobutton ausgewählt, etc.)

Für eine genaue Beschreibung verweise ich auf [http://www.mikrocontroller.net/articles/MenuDesigner Mikrocontroller.net] und [http://menudesigner.sourceforge.net/ SourceForge]

==Einbindung in Ethersex==
Ethersex enthält einen Wrapper (''services/glcdmenu/'') für das eigentliche Menüsystem, der vom Anzeigemedium abstrahiert und Events über das HOOK-System von Ethsersex weiterleitet.

===Aktiverung===
in menuconfig unter ''Applications -> Graphic Menu''

====Display====
Das Menusystem benötigt ein Grafikdisplay (oh Wunder!). Zur Zeit wird nur der S1D13305 Controller unterstützt.

===Schnittstellen===
Zur Ansteuerung des Menüs in der eigenen Applikation genügt es, die ''glcdmenu.h'' einzubinden.
Es werden Funktionen zum setzen und lesen von Checkbox- und Radiobutton-Zuständen, zum Abfragen von Listen (aktuelle Auswahl, beliebiges Listenelement)
und zum setzen aller dynamischen Texte (auch Listeninhalte) bereitgestellt.
Diese Funktionen erwarten jeweils die ID des jeweiligen grafischen Elements, diese wird bei der Erstellung des Menus vergeben (siehe unten).
Für eine genaue Beschreibung der Funktionen siehe die Kommentare in ''glcdmenu.c''.
Weiterhin lässt sich mittels
<source lang="C">
glcdmenuKeypress(unsigned char key_uc)
</source>
ein Tastendruck an die GUI weiterleiten, mit
<source lang="C">
glcdmenuMouseEvent(uint16_t xPos_ui16, uint16_t yPos_ui16, unsigned char button_uc)
</source>
ein Mausereignis (Klick, Mausbewegung, noch ungetestet) und mit
<source lang="C">
glcdmenuRedraw(void)
</source>
wird ein Neuzeichnen der Benutzeroberfläche ausgelöst.

===Hooks===
Mittels Hooks kann sich die eigene Applikation bei Menuereignissen (Button gedrückt, etc.) aufrufen lassen. Dazu ist folgendes nötig:
In der eigenen Applikation eine Handler-Funktion definieren:
<source lang="C">
void menu_hook_handler(uint8_t menuAction) {
debug_printf("hook: %d\n", menuAction);
/* Do something here */
}
</source>
Und in der Init-Funktion für den Hook registrieren:
<source lang="C">
int myApp_init() {
hook_menu_action_register(menu_hook_handler);
}
</source>

===Einbindung eigener Menüs===
Im Git-repository ist ein Beispiel-Menu enthalten, das zum Testen verwendet werden kann.
Eigene Menus erstellt man mit dem MenuEditor (siehe unten).
Die Ausgabe des MenuEditors zum schluss sind die Dateien ''menudata-progmem.c'' und ''menuinterpreter-config.h''. Diese enthalten die Konfiguration
des Menus und müssen unter ''/services/glcdmenu/menu-interpreter/'' abgelegt werden. (Die dort vorhandenen Dateien ersetzen).

==Der MenuEditor==
Der MenuEditor ist das grafische Tool zum Zeichnen von Benutzeroberflächen.
Das Tool ist zu finden unter ''/contrib/menuEditor''. Aus Platzgründen (und wegen der Plattformunabhängigkeit) ist es im Quelltext abgelegt um muss zuerst übersetzt werden. Dazu ist [http://www.lazarus.freepascal.org/ Lazarus] notwendig. Das Projekt in Lazarus öffnen und einmal compilieren, dann sollte es laufen.

--- Weitere Beschreibung folgt ----

==TODO==
* VNC Support
* Weitere Grafikcontroller unterstützen
* Maus-Funktion testen

[[Category:Ethersex]]
[[Category:GUI]]
[[Category:LCD]]

@@ Zeile 77: / Zeile 77: @@
 Eigene Menus erstellt man mit dem MenuEditor (siehe unten).
-Die Ausgabe des MenuEditors zum schluss sind die Dateien ''menudata-progmem.c'' und ''menuinterpreter-config.h''.
+Die MenuEditors generiert die Dateien ''menudata-progmem.c'' und ''menuinterpreter-config.h''. Diese enthalten die Konfiguration des Menus und müssen nach ''/services/glcdmenu/menu-interpreter/'' kopiert werden und ersetzen somit vorhandenen Dateien.
 ==Der MenuEditor==

@@ Zeile 34: / Zeile 34: @@
 ===Schnittstellen===
 Zur Ansteuerung des Menüs in der eigenen Applikation genügt es, die ''glcdmenu.h'' einzubinden.
-Es werden Funktionen zum setzen und lesen von Checkbox- und Radiobutton-Zuständen,
+Es werden Funktionen zum Setzen und Lesen von Checkbox- und Radiobutton-Zuständen,
-zum Abfragen von Listen (aktuelle Auswahl, beliebiges Listenelement) und zum setzen aller
+zum Abfragen von Listen (aktuelle Auswahl, beliebiges Listenelement) und zum Setzen aller
 dynamischen Texte (auch Listeninhalte) bereitgestellt.

@@ Zeile 1: / Zeile 1: @@
 Zur Erstellung von grafischen Benutzeroberflächen enthält Ethersex die MenuDesigner Bibliothek von Malte Marwedel.
 http://sourceforge.net/projects/menudesigner/
@@ Zeile 33: / Zeile 34: @@
 ===Schnittstellen===
 Zur Ansteuerung des Menüs in der eigenen Applikation genügt es, die ''glcdmenu.h'' einzubinden.
-Es werden Funktionen zum setzen und lesen von Checkbox- und Radiobutton-Zuständen, zum Abfragen von Listen (aktuelle Auswahl, beliebiges Listenelement)
+Es werden Funktionen zum setzen und lesen von Checkbox- und Radiobutton-Zuständen,
-und zum setzen aller dynamischen Texte (auch Listeninhalte) bereitgestellt.
+zum Abfragen von Listen (aktuelle Auswahl, beliebiges Listenelement) und zum setzen aller
-Diese Funktionen erwarten jeweils die ID des jeweiligen grafischen Elements, diese wird bei der Erstellung des Menus vergeben (siehe unten).
+dynamischen Texte (auch Listeninhalte) bereitgestellt.
 Für eine genaue Beschreibung der Funktionen siehe die Kommentare in ''glcdmenu.c''.
 Weiterhin lässt sich mittels
 <source lang="C">
@@ Zeile 52: / Zeile 58: @@
 ===Hooks===
-Mittels Hooks kann sich die eigene Applikation bei Menuereignissen (Button gedrückt, etc.) aufrufen lassen. Dazu ist folgendes nötig:
+Mittels Hooks kann sich die eigene Applikation bei Menuereignissen (Button gedrückt, etc.) aufrufen lassen. Dazu ist es nötig,
-In der eigenen Applikation eine Handler-Funktion definieren:
+in der eigenen Applikation eine Handler-Funktion definieren:
 <source lang="C">
 void menu_hook_handler(uint8_t menuAction) {
@@ Zeile 60: / Zeile 66: @@
+}
 </source>
-Und in der Init-Funktion für den Hook registrieren:
+Und in der Init-Funktion für den Hook zu registrieren:
 <source lang="C">
 int myApp_init() {
@@ Zeile 70: / Zeile 76: @@
 Im Git-repository ist ein Beispiel-Menu enthalten, das zum Testen verwendet werden kann.
 Eigene Menus erstellt man mit dem MenuEditor (siehe unten).
 Die Ausgabe des MenuEditors zum schluss sind die Dateien ''menudata-progmem.c'' und ''menuinterpreter-config.h''. Diese enthalten die Konfiguration
-des Menus und müssen unter ''/services/glcdmenu/menu-interpreter/'' abgelegt werden. (Die dort vorhandenen Dateien ersetzen).
+Die Ausgabe des MenuEditors zum schluss sind die Dateien ''menudata-progmem.c'' und ''menuinterpreter-config.h''.
 ==Der MenuEditor==