Editing Documentation/Maemo 5 Developer Guide/Porting Software/Porting Existing GTK+ Application to Maemo 5
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
Warning: This page is 60 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
- | This section describes key aspects of the process of porting an application to the | + | = Porting Existing GTK+ Application to Maemo 5.0 = |
+ | |||
+ | This section describes key aspects of the process of porting an application to the maemo platform. When starting to port an application to maemo platform, the first step is to set up the development environment. The actual porting after that is described in this section. | ||
== Introduction == | == Introduction == | ||
- | Application that is used as an example for porting is [http://wingtk.sourceforge.net/ishan/sliders.html Sliders], a GTK+ | + | Application that is used as an example for porting is [http://wingtk.sourceforge.net/ishan/sliders.html Sliders], a GTK+ based game. |
The Sliders interface consists of the main window with board, menu and a couple of dialogs. See source mentioned above for game history and description. | The Sliders interface consists of the main window with board, menu and a couple of dialogs. See source mentioned above for game history and description. | ||
Line 9: | Line 11: | ||
== Autotools Usage == | == Autotools Usage == | ||
- | Sliders | + | Sliders doesn't use GNU autotools originally, so we need to add `configure.ac', `Makefile.am' and `autogen.sh' for simplicity. See [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/GNU_Build_System GNU Build System] for corresponding information. |
- | == User Interface Changes == | + | == User Interface Changes == |
Sliders game is not designed for usage in mobile devices, so we need to hildonize it in order to build effective touch interface for this simple game. | Sliders game is not designed for usage in mobile devices, so we need to hildonize it in order to build effective touch interface for this simple game. | ||
- | === Hildonizing Main View === | + | === Hildonizing Main View === |
Before using Hildon we need to initialize it. maemo-sliders/sliders.c | Before using Hildon we need to initialize it. maemo-sliders/sliders.c | ||
- | < | + | <tt> <span>''<span><font color="#9A1900">/* Initialize the GTK+ and hildon libraries */</font></span>''</span> |
- | /* Initialize the GTK+ and hildon libraries */ | + | <span>'''<span><font color="#000000">hildon_gtk_init</font></span>'''</span> <span><font color="#990000">(&</font></span>argc<span><font color="#990000">,</font></span> <span><font color="#990000">&</font></span>argv<span><font color="#990000">);</font></span></tt> |
- | hildon_gtk_init (&argc, &argv); | + | |
- | </ | + | |
- | After that we can create | + | After that we can create main window with all necessary content. maemo-sliders/sliders.c |
- | < | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span> |
- | static GtkWidget* | + | <span>'''<span><font color="#000000">create_main_window</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#009900">void</font></span><span><font color="#990000">)</font></span> |
- | create_main_window (void) | + | <span><font color="#FF0000">{</font></span> |
- | { | + | GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>main_window<span><font color="#990000"><nowiki>;</nowiki></font></span> |
- | + | <span>''<span><font color="#9A1900">/* Create the main window */</font></span>''</span> | |
- | + | main_window <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">hildon_stackable_window_new</font></span>'''</span> <span><font color="#990000">();</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_window_set_title</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_WINDOW</font></span>'''</span> <span><font color="#990000">(</font></span>main_window<span><font color="#990000">),</font></span> <span><font color="#FF0000">"Welcome to Sliders"</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* Create and set application menu */</font></span>''</span> | |
- | + | HildonAppMenu <span><font color="#990000"><nowiki>*</nowiki></font></span>menu <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">create_menu</font></span>'''</span> <span><font color="#990000">();</font></span> | |
- | + | <span>'''<span><font color="#000000">hildon_stackable_window_set_main_menu</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">HILDON_STACKABLE_WINDOW</font></span>'''</span> <span><font color="#990000">(</font></span>main_window<span><font color="#990000">),</font></span> menu<span><font color="#990000">);</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* Create and pack table, that contains sliders */</font></span>''</span> | |
- | + | appdata<span><font color="#990000">.</font></span>table <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">create_table</font></span>'''</span> <span><font color="#990000">();</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_container_add</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_CONTAINER</font></span>'''</span> <span><font color="#990000">(</font></span>main_window<span><font color="#990000">),</font></span> appdata<span><font color="#990000">.</font></span>table<span><font color="#990000">);</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* Exit from gtk_main on "delete_event" */</font></span>''</span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect</font></span>'''</span> <span><font color="#990000">((</font></span>gpointer<span><font color="#990000">)</font></span> main_window<span><font color="#990000">,</font></span> <span><font color="#FF0000">"delete_event"</font></span><span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>gtk_main_quit<span><font color="#990000">),</font></span> NULL<span><font color="#990000">);</font></span> | |
- | } | + | <span>'''<span><font color="#0000FF">return</font></span>'''</span> main_window<span><font color="#990000"><nowiki>;</nowiki></font></span> |
- | </ | + | <span><font color="#FF0000">}</font></span></tt> |
- | We have replaced | + | We have replaced original Sliders menu and toolbar with hildon application menu. |
- | + | ||
- | + | ||
+ | {| summary="Maemo Sliders Menu" | ||
+ | |+ align="BOTTOM" |'''Figure 16.12:''' Maemo Sliders Menu | ||
+ | |- | ||
+ | | | ||
+ | [[Image:maemo-sliders_app_menu.png|Image maemo-sliders_app_menu]] | ||
+ | |} | ||
maemo-sliders/sliders.c | maemo-sliders/sliders.c | ||
- | < | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> HildonAppMenu <span><font color="#990000"><nowiki>*</nowiki></font></span> |
- | static HildonAppMenu * | + | <span>'''<span><font color="#000000">create_menu</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#009900">void</font></span><span><font color="#990000">)</font></span> |
- | create_menu (void) | + | <span><font color="#FF0000">{</font></span> |
- | { | + | <span>''<span><font color="#9A1900">/*</font></span>''</span> |
- | + | <span>''<span><font color="#9A1900"> * Create menu buttons one by one, connect to appropriate callbacks and</font></span>''</span> | |
- | + | <span>''<span><font color="#9A1900"> * add to the menu.</font></span>''</span> | |
- | + | <span>''<span><font color="#9A1900"> */</font></span>''</span> | |
- | + | HildonSizeType button_size <span><font color="#990000"><nowiki>=</nowiki></font></span> HILDON_SIZE_FINGER_HEIGHT <span><font color="#990000"><nowiki>|</nowiki></font></span> HILDON_SIZE_AUTO_WIDTH<span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | HildonAppMenu <span><font color="#990000"><nowiki>*</nowiki></font></span>menu <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">HILDON_APP_MENU</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">hildon_app_menu_new</font></span>'''</span> <span><font color="#990000">());</font></span> | |
- | + | GtkButton <span><font color="#990000"><nowiki>*</nowiki></font></span>button<span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | button <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">hildon_gtk_button_new</font></span>'''</span> <span><font color="#990000">(</font></span>button_size<span><font color="#990000">));</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_button_set_label</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">,</font></span> <span><font color="#FF0000">"New"</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">G_OBJECT</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">),</font></span> <span><font color="#FF0000">"clicked"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>on_new_clicked<span><font color="#990000">),</font></span> NULL<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">hildon_app_menu_append</font></span>'''</span> <span><font color="#990000">(</font></span>menu<span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">));</font></span> | |
- | + | button <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">hildon_gtk_button_new</font></span>'''</span> <span><font color="#990000">(</font></span>button_size<span><font color="#990000">));</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_button_set_label</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">,</font></span> <span><font color="#FF0000">"Scores"</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">G_OBJECT</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">),</font></span> <span><font color="#FF0000">"clicked"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>on_scores_clicked<span><font color="#990000">),</font></span> NULL<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">hildon_app_menu_append</font></span>'''</span> <span><font color="#990000">(</font></span>menu<span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">));</font></span> | |
- | + | button <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">hildon_gtk_button_new</font></span>'''</span> <span><font color="#990000">(</font></span>button_size<span><font color="#990000">));</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_button_set_label</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">,</font></span> <span><font color="#FF0000">"Open"</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">G_OBJECT</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">),</font></span> <span><font color="#FF0000">"clicked"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>on_open_clicked<span><font color="#990000">),</font></span> NULL<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">hildon_app_menu_append</font></span>'''</span> <span><font color="#990000">(</font></span>menu<span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">));</font></span> | |
- | + | button <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">hildon_gtk_button_new</font></span>'''</span> <span><font color="#990000">(</font></span>button_size<span><font color="#990000">));</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_button_set_label</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">,</font></span> <span><font color="#FF0000">"Save"</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">G_OBJECT</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">),</font></span> <span><font color="#FF0000">"clicked"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>on_save_clicked<span><font color="#990000">),</font></span> NULL<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">hildon_app_menu_append</font></span>'''</span> <span><font color="#990000">(</font></span>menu<span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">));</font></span> | |
- | + | button <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">hildon_gtk_button_new</font></span>'''</span> <span><font color="#990000">(</font></span>button_size<span><font color="#990000">));</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_button_set_label</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">,</font></span> <span><font color="#FF0000">"About"</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">G_OBJECT</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">),</font></span> <span><font color="#FF0000">"clicked"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>on_about_clicked<span><font color="#990000">),</font></span> NULL<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">hildon_app_menu_append</font></span>'''</span> <span><font color="#990000">(</font></span>menu<span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span> <span><font color="#990000">(</font></span>button<span><font color="#990000">));</font></span> | |
- | + | <span>'''<span><font color="#0000FF">return</font></span>'''</span> menu<span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | <span><font color="#FF0000">}</font></span></tt> | |
- | + | ||
- | } | + | |
- | </ | + | |
- | |||
- | + | Sliders table buttons [localhost#fig:maemo-sliders_table 16.14] are maximized and wrapped with `hildon_gtk_button_new ()'. maemo-sliders/sliders.c | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | [[ | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span> |
+ | <span>'''<span><font color="#000000">create_table</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#009900">void</font></span><span><font color="#990000">)</font></span> | ||
+ | <span><font color="#FF0000">{</font></span> | ||
+ | GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>table<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | gint x<span><font color="#990000">,</font></span> y<span><font color="#990000">,</font></span> c <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#993399">0</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | appdata<span><font color="#990000">.</font></span>vacant_pos <span><font color="#990000"><nowiki>=</nowiki></font></span> SLIDERS_NUMBER<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | appdata<span><font color="#990000">.</font></span>move_no <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#993399">0</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | HildonSizeType button_size <span><font color="#990000"><nowiki>=</nowiki></font></span> HILDON_SIZE_FINGER_HEIGHT <span><font color="#990000"><nowiki>|</nowiki></font></span> HILDON_SIZE_AUTO_WIDTH<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span>''<span><font color="#9A1900">/* Create table for sliders */</font></span>''</span> | ||
+ | table <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">gtk_table_new</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#993399">4</font></span><span><font color="#990000">,</font></span> <span><font color="#993399">4</font></span><span><font color="#990000">,</font></span> FALSE<span><font color="#990000">);</font></span> | ||
+ | <span>''<span><font color="#9A1900">/*</font></span>''</span> | ||
+ | <span>''<span><font color="#9A1900"> * Create buttons, that represents sliders. Set "current_pos" key for each button</font></span>''</span> | ||
+ | <span>''<span><font color="#9A1900"> * and connect each button to appropriate callback.</font></span>''</span> | ||
+ | <span>''<span><font color="#9A1900"> */</font></span>''</span> | ||
+ | <span>'''<span><font color="#0000FF">for</font></span>'''</span> <span><font color="#990000">(</font></span>x <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#993399">0</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> x <span><font color="#990000"><</font></span> SLIDERS_NUMBER<span><font color="#990000"><nowiki>;</nowiki></font></span> x<span><font color="#990000">++)</font></span> | ||
+ | <span><font color="#FF0000">{</font></span> | ||
+ | gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>temp <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">g_strdup_printf</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%i"</font></span><span><font color="#990000">,</font></span> x<span><font color="#990000">+</font></span><span><font color="#993399">1</font></span><span><font color="#990000">);</font></span> | ||
+ | appdata<span><font color="#990000">.</font></span>buttons<span><font color="#990000">[</font></span>x<span><font color="#990000">]</font></span> <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">hildon_gtk_button_new</font></span>'''</span> <span><font color="#990000">(</font></span>button_size<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">gtk_button_set_label</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_BUTTON</font></span>'''</span><span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>buttons<span><font color="#990000">[</font></span>x<span><font color="#990000">]),</font></span> temp<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">g_object_set_data</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">G_OBJECT</font></span>'''</span><span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>buttons<span><font color="#990000">[</font></span>x<span><font color="#990000">]),</font></span> <span><font color="#FF0000">"current_pos"</font></span><span><font color="#990000">,</font></span> <span><font color="#990000">(</font></span>gpointer<span><font color="#990000">)</font></span> x<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">g_free</font></span>'''</span> <span><font color="#990000">(</font></span>temp<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">gtk_signal_connect</font></span>'''</span><span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_OBJECT</font></span>'''</span><span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>buttons<span><font color="#990000">[</font></span>x<span><font color="#990000">]),</font></span> <span><font color="#FF0000">"clicked"</font></span><span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">GTK_SIGNAL_FUNC</font></span>'''</span><span><font color="#990000">(</font></span>on_button_clicked<span><font color="#990000">),</font></span> NULL<span><font color="#990000">);</font></span> | ||
+ | <span><font color="#FF0000">}</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* Add sliders to table */</font></span>''</span> | ||
+ | <span>'''<span><font color="#0000FF">for</font></span>'''</span> <span><font color="#990000">(</font></span>x <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#993399">0</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> x <span><font color="#990000"><</font></span> <span><font color="#993399">4</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> x<span><font color="#990000">++)</font></span> | ||
+ | <span>'''<span><font color="#0000FF">for</font></span>'''</span> <span><font color="#990000">(</font></span>y <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#993399">0</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> y <span><font color="#990000"><</font></span> <span><font color="#993399">4</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> y<span><font color="#990000">++)</font></span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(!(</font></span>x <span><font color="#990000"><nowiki>==</nowiki></font></span> <span><font color="#993399">3</font></span> <span><font color="#990000">&&</font></span> y <span><font color="#990000"><nowiki>==</nowiki></font></span> <span><font color="#993399">3</font></span><span><font color="#990000">))</font></span> | ||
+ | <span>'''<span><font color="#000000">gtk_table_attach_defaults</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_TABLE</font></span>'''</span> <span><font color="#990000">(</font></span>table<span><font color="#990000">),</font></span> appdata<span><font color="#990000">.</font></span>buttons<span><font color="#990000">[</font></span>c<span><font color="#990000">++],</font></span> y<span><font color="#990000">,</font></span> y<span><font color="#990000">+</font></span><span><font color="#993399">1</font></span><span><font color="#990000">,</font></span> x<span><font color="#990000">,</font></span> x<span><font color="#990000">+</font></span><span><font color="#993399">1</font></span><span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> table<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span></tt> | ||
- | |||
- | |||
- | + | {| summary="Maemo Sliders Table" | |
- | + | |+ align="BOTTOM" |'''Figure 16.13:''' Maemo Sliders Table | |
- | + | |- | |
- | + | | | |
- | + | [[Image:maemo-sliders_table.png|Image maemo-sliders_table]] | |
- | } | + | |} |
- | + | ||
- | + | === Implementing Scores Window === | |
- | + | We have replaced original Sliders win picture by scores window [localhost#fig:maemo-sliders_table 16.14]<nowiki>, that appears in two cases. It's shown after ``Scores'' menu button clicked </nowiki>maemo-sliders/sliders.c | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | </ | + | |
- | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> <span><font color="#009900">void</font></span> | |
+ | <span>'''<span><font color="#000000">on_scores_clicked</font></span>'''</span> <span><font color="#990000">(</font></span>GtkMenuItem <span><font color="#990000"><nowiki>*</nowiki></font></span>menuitem<span><font color="#990000">,</font></span> gpointer user_data<span><font color="#990000">)</font></span> | ||
+ | <span><font color="#FF0000">{</font></span> | ||
+ | <span>'''<span><font color="#000000">scores_window</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#993399">0</font></span><span><font color="#990000">);</font></span> | ||
+ | <span><font color="#FF0000">}</font></span></tt> | ||
- | + | and when player has won. maemo-sliders/sliders.c | |
- | < | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> <span><font color="#009900">void</font></span> |
- | /* | + | <span>'''<span><font color="#000000">on_button_clicked</font></span>'''</span> <span><font color="#990000">(</font></span>GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>button<span><font color="#990000">,</font></span> gpointer user_data<span><font color="#990000">)</font></span> |
- | + | <span><font color="#FF0000">{</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | |
- | / | + | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span> <span>'''<span><font color="#000000">has_player_won</font></span>'''</span><span><font color="#990000">()</font></span> <span><font color="#990000">)</font></span> |
- | / | + | <span><font color="#FF0000">{</font></span> |
- | + | <span>'''<span><font color="#000000">scores_window</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#993399">1</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#000000">gtk_window_set_title</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_WINDOW</font></span>'''</span> <span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>main_window<span><font color="#990000">),</font></span> <span><font color="#FF0000">"Welcome to Sliders"</font></span><span><font color="#990000">);</font></span> | |
- | </ | + | appdata<span><font color="#990000">.</font></span>move_no <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#993399">0</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> |
+ | <span><font color="#FF0000">}</font></span> | ||
+ | <span>'''<span><font color="#0000FF">else</font></span>'''</span> | ||
+ | <span><font color="#FF0000">{</font></span> | ||
+ | gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>temp <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">g_strdup_printf</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"Move no.: %i"</font></span><span><font color="#990000">,</font></span> appdata<span><font color="#990000">.</font></span>move_no<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">gtk_window_set_title</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_WINDOW</font></span>'''</span> <span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>main_window<span><font color="#990000">),</font></span> temp<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">g_free</font></span>'''</span> <span><font color="#990000">(</font></span>temp<span><font color="#990000">);</font></span> | ||
+ | <span><font color="#FF0000">}</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | ||
+ | <span><font color="#FF0000">}</font></span></tt> | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | + | {| summary="Maemo Sliders Scores" | |
+ | |+ align="BOTTOM" |'''Figure 16.14:''' Maemo Sliders Scores | ||
+ | |- | ||
+ | | | ||
+ | [[Image:maemo-sliders_scores_window.png|Image maemo-sliders_scores_window]] | ||
+ | |} | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | + | Scores window contains pannable area with tree view maemo-sliders/sliders.c | |
- | + | <tt> <span>''<span><font color="#9A1900">/* Create a tree view that represents scores table and an area for it */</font></span>''</span> | |
+ | area <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">hildon_pannable_area_new</font></span>'''</span> <span><font color="#990000">();</font></span> | ||
+ | tree_view <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">create_treeview</font></span>'''</span> <span><font color="#990000">(</font></span>HILDON_UI_MODE_EDIT<span><font color="#990000">);</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | ||
+ | <span>''<span><font color="#9A1900">/* Pack tree view */</font></span>''</span> | ||
+ | <span>'''<span><font color="#000000">gtk_container_add</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_CONTAINER</font></span>'''</span> <span><font color="#990000">(</font></span>area<span><font color="#990000">),</font></span> tree_view<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">gtk_container_add</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_CONTAINER</font></span>'''</span> <span><font color="#990000">(</font></span>window<span><font color="#990000">),</font></span> area<span><font color="#990000">);</font></span></tt> | ||
- | + | and edit toolbar. maemo-sliders/sliders.c | |
- | < | + | <tt> <span>''<span><font color="#9A1900">/* Create a new edit toolbar */</font></span>''</span> |
- | + | toolbar <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">hildon_edit_toolbar_new_with_text</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"Choose scores to delete"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span><font color="#FF0000">"Delete"</font></span><span><font color="#990000">);</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | |
- | + | <span>''<span><font color="#9A1900">/* Add toolbar to the window */</font></span>''</span> | |
- | + | <span>'''<span><font color="#000000">hildon_window_set_edit_toolbar</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">HILDON_WINDOW</font></span>'''</span> <span><font color="#990000">(</font></span>window<span><font color="#990000">),</font></span> | |
- | + | <span>'''<span><font color="#000000">HILDON_EDIT_TOOLBAR</font></span>'''</span> <span><font color="#990000">(</font></span>toolbar<span><font color="#990000">));</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | |
- | + | <span>''<span><font color="#9A1900">/* Set callback for "Delete" button */</font></span>''</span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect</font></span>'''</span> <span><font color="#990000">(</font></span>toolbar<span><font color="#990000">,</font></span> <span><font color="#FF0000">"button-clicked"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>delete_selected_scores<span><font color="#990000">),</font></span> | |
- | + | tree_view<span><font color="#990000">);</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* Destroy scores window when upper corner arrow clicked */</font></span>''</span> | |
- | + | <span>'''<span><font color="#000000">g_signal_connect_swapped</font></span>'''</span> <span><font color="#990000">(</font></span>toolbar<span><font color="#990000">,</font></span> <span><font color="#FF0000">"arrow-clicked"</font></span><span><font color="#990000">,</font></span> | |
- | + | <span>'''<span><font color="#000000">G_CALLBACK</font></span>'''</span> <span><font color="#990000">(</font></span>gtk_widget_destroy<span><font color="#990000">),</font></span> | |
- | </ | + | window<span><font color="#990000">);</font></span></tt> |
- | + | Win banner is shown if `scores_window ()' called in case player has won. maemo-sliders/sliders.c | |
- | < | + | <tt> <span>''<span><font color="#9A1900">/* Additional actions for case, when player has won */</font></span>''</span> |
- | + | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>win<span><font color="#990000">)</font></span> | |
- | { | + | <span><font color="#FF0000">{</font></span> |
- | + | <span>''<span><font color="#9A1900">/* Show appropriate banner */</font></span>''</span> | |
- | + | <span>'''<span><font color="#000000">hildon_banner_show_informationf</font></span>'''</span> <span><font color="#990000">(</font></span>window<span><font color="#990000">,</font></span> NULL<span><font color="#990000">,</font></span> <span><font color="#FF0000">"Win! Score: %i"</font></span><span><font color="#990000">,</font></span> appdata<span><font color="#990000">.</font></span>move_no<span><font color="#990000">);</font></span> | |
- | + | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | |
- | + | <span><font color="#FF0000">}</font></span></tt> | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | } | + | |
- | </ | + | |
- | + | Other scores related code is quite straightforward and doesn't use Hildon specific features, see `scores_window ()' implementation for details. | |
- | + | == State Saving == | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | Maemo supports state saving feature, that we have used for current Sliders game saving. The application can later open this game with the same state as before. This section describes most important steps needed to make Sliders support state savings. | |
- | < | + | <nowiki> `state_save ()' is called when user presses menu's ``Save'' button. Saving data should be updated before it's called. </nowiki>maemo-sliders/sliders.c |
- | + | ||
- | + | ||
- | </ | + | |
- | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> <span><font color="#009900">void</font></span> | |
+ | <span>'''<span><font color="#000000">on_save_clicked</font></span>'''</span> <span><font color="#990000">(</font></span>GtkMenuItem <span><font color="#990000"><nowiki>*</nowiki></font></span>menuitem<span><font color="#990000">,</font></span> gpointer user_data<span><font color="#990000">)</font></span> | ||
+ | <span><font color="#FF0000">{</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* Save moves number, vacant position and board layout to "state" */</font></span>''</span> | ||
+ | state<span><font color="#990000">.</font></span>move_no <span><font color="#990000"><nowiki>=</nowiki></font></span> appdata<span><font color="#990000">.</font></span>move_no<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | state<span><font color="#990000">.</font></span>vacant_pos <span><font color="#990000"><nowiki>=</nowiki></font></span> appdata<span><font color="#990000">.</font></span>vacant_pos<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#009900">int</font></span> i<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span>'''<span><font color="#0000FF">for</font></span>'''</span> <span><font color="#990000">(</font></span>i <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#993399">0</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span> i <span><font color="#990000"><</font></span> SLIDERS_NUMBER<span><font color="#990000"><nowiki>;</nowiki></font></span> i<span><font color="#990000">++)</font></span> | ||
+ | state<span><font color="#990000">.</font></span>map<span><font color="#990000">[</font></span>i<span><font color="#990000">]</font></span> <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#990000">(</font></span>gint<span><font color="#990000">)</font></span> <span>'''<span><font color="#000000">gtk_object_get_data</font></span>'''</span><span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_OBJECT</font></span>'''</span><span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>buttons<span><font color="#990000">[</font></span>i<span><font color="#990000">]),</font></span> <span><font color="#FF0000">"current_pos"</font></span><span><font color="#990000">);</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* Call state saving method and process return value */</font></span>''</span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">state_save</font></span>'''</span> <span><font color="#990000">())</font></span> | ||
+ | <span>'''<span><font color="#000000">hildon_banner_show_information</font></span>'''</span> <span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>main_window<span><font color="#990000">,</font></span> NULL<span><font color="#990000">,</font></span> <span><font color="#FF0000">"Saved current game"</font></span><span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">else</font></span>'''</span> <span>'''<span><font color="#000000">hildon_banner_show_information</font></span>'''</span> <span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>main_window<span><font color="#990000">,</font></span> NULL<span><font color="#990000">,</font></span> <span><font color="#FF0000">"Can't save current game"</font></span><span><font color="#990000">);</font></span> | ||
+ | <span><font color="#FF0000">}</font></span></tt> | ||
- | + | Then `osso_state_write ()' can be called for correct data. maemo-sliders/sliders.c | |
- | + | <tt><span>'''<span><font color="#000000">state_save</font></span>'''</span><span><font color="#990000">(</font></span><span><font color="#009900">void</font></span><span><font color="#990000">)</font></span> | |
+ | <span><font color="#FF0000">{</font></span> | ||
+ | osso_state_t osso_state<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | osso_return_t ret<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | osso_state<span><font color="#990000">.</font></span>state_size <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#0000FF">sizeof</font></span>'''</span><span><font color="#990000">(</font></span>StateData<span><font color="#990000">);</font></span> | ||
+ | osso_state<span><font color="#990000">.</font></span>state_data <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#990000">&</font></span>state<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | ret <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">osso_state_write</font></span>'''</span><span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>osso_context<span><font color="#990000">,</font></span> <span><font color="#990000">&</font></span>osso_state<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>ret <span><font color="#990000"><nowiki>!=</nowiki></font></span> OSSO_OK<span><font color="#990000">)</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> FALSE<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> TRUE<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span></tt> | ||
- | < | + | <nowiki> `state_load ()' is called when user clicks ``Open'' menu button. It uses `osso_state_read ()' symmetric to `state_save ()'. </nowiki>maemo-sliders/sliders.c |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | <tt><span>'''<span><font color="#000000">state_load</font></span>'''</span><span><font color="#990000">(</font></span><span><font color="#009900">void</font></span><span><font color="#990000">)</font></span> | |
- | + | <span><font color="#FF0000">{</font></span> | |
- | + | osso_state_t osso_state<span><font color="#990000"><nowiki>;</nowiki></font></span> | |
+ | osso_return_t ret<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | osso_state<span><font color="#990000">.</font></span>state_size <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#0000FF">sizeof</font></span>'''</span><span><font color="#990000">(</font></span>StateData<span><font color="#990000">);</font></span> | ||
+ | osso_state<span><font color="#990000">.</font></span>state_data <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#990000">&</font></span>state<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | ret <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">osso_state_read</font></span>'''</span><span><font color="#990000">(</font></span>appdata<span><font color="#990000">.</font></span>osso_context<span><font color="#990000">,</font></span> <span><font color="#990000">&</font></span>osso_state<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>ret <span><font color="#990000"><nowiki>!=</nowiki></font></span> OSSO_OK<span><font color="#990000">)</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> FALSE<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> TRUE<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span></tt> | ||
- | + | Don't forget to initialize the library context before state saving usage. maemo-sliders/sliders.c | |
- | + | ||
- | + | <tt> <span>''<span><font color="#9A1900">/* Initialize maemo application */</font></span>''</span> | |
- | + | appdata<span><font color="#990000">.</font></span>osso_context <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">osso_initialize</font></span>'''</span><span><font color="#990000">(</font></span>OSSO_SERVICE<span><font color="#990000">,</font></span> VERSION<span><font color="#990000">,</font></span> TRUE<span><font color="#990000">,</font></span> NULL<span><font color="#990000">);</font></span></tt> | |
- | + | ||
- | + | ||
- | + | ||
- | + | The information saved by using state saving functions does not survive over power off of the device, so if you need to save some data more permanent you could use e.g. [http://xmlsoft.org/ libxml] as shown in next section for scores table. | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | == Scores Saving == | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | Scores data store is created, when `get_scores_store ()' called first. The store is populated from file saved under user's home directory. Document tree is parsed with node pointer starting from root element. maemo-sliders/sliders.c | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> GtkListStore <span><font color="#990000"><nowiki>*</nowiki></font></span> | |
- | + | <span>'''<span><font color="#000000">get_scores_store</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#009900">void</font></span><span><font color="#990000">)</font></span> | |
- | + | <span><font color="#FF0000">{</font></span> | |
- | + | <span>'''<span><font color="#0000FF">static</font></span>'''</span> GtkListStore <span><font color="#990000"><nowiki>*</nowiki></font></span>store <span><font color="#990000"><nowiki>=</nowiki></font></span> NULL<span><font color="#990000"><nowiki>;</nowiki></font></span> | |
+ | |||
+ | <span>''<span><font color="#9A1900">/* Return store if it has been created before */</font></span>''</span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>store <span><font color="#990000"><nowiki>!=</nowiki></font></span> NULL<span><font color="#990000">)</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> store<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Create store with 2 columns of specified types */</font></span>''</span> | ||
+ | store <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">gtk_list_store_new</font></span>'''</span> <span><font color="#990000">(</font></span>N_COLUMNS<span><font color="#990000">,</font></span> G_TYPE_STRING<span><font color="#990000">,</font></span> G_TYPE_INT<span><font color="#990000">);</font></span> | ||
+ | |||
+ | xmlDocPtr doc<span><font color="#990000"><nowiki>;</nowiki></font></span> <span>''<span><font color="#9A1900">/* the resulting document tree */</font></span>''</span> | ||
+ | xmlNodePtr cur<span><font color="#990000"><nowiki>;</nowiki></font></span> <span>''<span><font color="#9A1900">/* node pointer */</font></span>''</span> | ||
+ | xmlChar <span><font color="#990000"><nowiki>*</nowiki></font></span>attribute<span><font color="#990000"><nowiki>;</nowiki></font></span> <span>''<span><font color="#9A1900">/* node attribute name */</font></span>''</span> | ||
+ | <span><font color="#009900">char</font></span> <span><font color="#990000"><nowiki>*</nowiki></font></span>row_name<span><font color="#990000">,</font></span> <span><font color="#990000"><nowiki>*</nowiki></font></span>temp<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | gint row_score<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Parse an XML file from the filesystem */</font></span>''</span> | ||
+ | <span><font color="#009900">char</font></span> <span><font color="#990000"><nowiki>*</nowiki></font></span>slidersdir <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">g_strdup_printf</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s%s%s"</font></span><span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">getenv</font></span>'''</span><span><font color="#990000">(</font></span><span><font color="#FF0000">"HOME"</font></span><span><font color="#990000">),</font></span> SLIDERS_DIR<span><font color="#990000">,</font></span> SCORES_XML<span><font color="#990000">);</font></span> | ||
+ | doc <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">xmlReadFile</font></span>'''</span> <span><font color="#990000">(</font></span>slidersdir<span><font color="#990000">,</font></span> NULL<span><font color="#990000">,</font></span> XML_PARSE_NOERROR<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">g_free</font></span>'''</span> <span><font color="#990000">(</font></span>slidersdir<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>doc <span><font color="#990000"><nowiki>==</nowiki></font></span> NULL<span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> | ||
+ | <span>'''<span><font color="#000000">g_print</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s, %i: Failed to parse document %s</font></span><span><font color="#CC33CC">\n</font></span><span><font color="#FF0000">"</font></span><span><font color="#990000">,</font></span> __PRETTY_FUNCTION__<span><font color="#990000">,</font></span> __LINE__<span><font color="#990000">,</font></span> SCORES_XML<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> store<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Parse root element */</font></span>''</span> | ||
+ | cur <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">xmlDocGetRootElement</font></span>'''</span><span><font color="#990000">(</font></span>doc<span><font color="#990000">);</font></span> <span>''<span><font color="#9A1900">//scores</font></span>''</span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>cur <span><font color="#990000"><nowiki>==</nowiki></font></span> NULL<span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> | ||
+ | <span>'''<span><font color="#000000">g_print</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s, %i: Empty xml doc</font></span><span><font color="#CC33CC">\n</font></span><span><font color="#FF0000">"</font></span><span><font color="#990000">,</font></span> __PRETTY_FUNCTION__<span><font color="#990000">,</font></span> __LINE__<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">xmlFreeDoc</font></span>'''</span> <span><font color="#990000">(</font></span>doc<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> store<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Parse first row tag */</font></span>''</span> | ||
+ | cur <span><font color="#990000"><nowiki>=</nowiki></font></span> cur<span><font color="#990000">-></font></span>xmlChildrenNode<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>cur <span><font color="#990000"><nowiki>==</nowiki></font></span> NULL<span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> | ||
+ | <span>'''<span><font color="#000000">g_print</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s, %i: No row tag</font></span><span><font color="#CC33CC">\n</font></span><span><font color="#FF0000">"</font></span><span><font color="#990000">,</font></span> __PRETTY_FUNCTION__<span><font color="#990000">,</font></span> __LINE__<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#000000">xmlFreeDoc</font></span>'''</span> <span><font color="#990000">(</font></span>doc<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> store<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Parse row tags one by one */</font></span>''</span> | ||
+ | <span>'''<span><font color="#0000FF">while</font></span>'''</span> <span><font color="#990000">(</font></span>cur <span><font color="#990000"><nowiki>!=</nowiki></font></span> NULL<span><font color="#990000">)</font></span> | ||
+ | <span><font color="#FF0000">{</font></span> | ||
+ | <span>''<span><font color="#9A1900">/* ... */</font></span>''</span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Add new row to the store */</font></span>''</span> | ||
+ | <span>'''<span><font color="#000000">gtk_list_store_insert_with_values</font></span>'''</span> <span><font color="#990000">(</font></span>store<span><font color="#990000">,</font></span> NULL<span><font color="#990000">,</font></span> <span>'''<span><font color="#000000">gtk_tree_model_iter_n_children</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_TREE_MODEL</font></span>'''</span><span><font color="#990000">(</font></span>store<span><font color="#990000">),</font></span> NULL<span><font color="#990000">),</font></span> <span><font color="#993399">0</font></span><span><font color="#990000">,</font></span> row_name<span><font color="#990000">,</font></span> <span><font color="#993399">1</font></span><span><font color="#990000">,</font></span> row_score<span><font color="#990000">,</font></span> <span><font color="#990000">-</font></span><span><font color="#993399">1</font></span><span><font color="#990000">);</font></span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Parse next row element */</font></span>''</span> | ||
+ | <span>'''<span><font color="#000000">g_free</font></span>'''</span> <span><font color="#990000">(</font></span>row_name<span><font color="#990000">);</font></span> | ||
+ | cur <span><font color="#990000"><nowiki>=</nowiki></font></span> cur<span><font color="#990000">-></font></span>next<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span> | ||
+ | |||
+ | <span>''<span><font color="#9A1900">/* Free the resulting tree */</font></span>''</span> | ||
+ | <span>'''<span><font color="#000000">xmlFreeDoc</font></span>'''</span><span><font color="#990000">(</font></span>doc<span><font color="#990000">);</font></span> | ||
+ | <span>'''<span><font color="#0000FF">return</font></span>'''</span> store<span><font color="#990000"><nowiki>;</nowiki></font></span> | ||
+ | <span><font color="#FF0000">}</font></span></tt> | ||
- | + | 'scores_xml_save ()' is called before application quits. It uses xml text writer in order to save current data store to appropriate file. maemo-sliders/sliders.c | |
- | + | ||
- | + | <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> <span><font color="#009900">void</font></span> | |
- | + | <span>'''<span><font color="#000000">scores_xml_save</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#0000FF">const</font></span>'''</span> <span><font color="#009900">char</font></span> <span><font color="#990000"><nowiki>*</nowiki></font></span>uri<span><font color="#990000">)</font></span> | |
- | + | <span><font color="#FF0000">{</font></span> | |
- | + | <span><font color="#009900">int</font></span> rc<span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | xmlTextWriterPtr writer<span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | ||
- | + | <span>''<span><font color="#9A1900">/* Check if store have been created */</font></span>''</span> | |
- | + | GtkListStore <span><font color="#990000"><nowiki>*</nowiki></font></span>store <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">get_scores_store</font></span>'''</span> <span><font color="#990000">();</font></span> | |
- | + | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(!</font></span>store<span><font color="#990000">)</font></span> <span>'''<span><font color="#0000FF">return</font></span>'''</span><span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | </ | + | |
- | + | <span>''<span><font color="#9A1900">/* Create a new XmlWriter for uri, with no compression. */</font></span>''</span> | |
- | == | + | writer <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">xmlNewTextWriterFilename</font></span>'''</span><span><font color="#990000">(</font></span>uri<span><font color="#990000">,</font></span> <span><font color="#993399">0</font></span><span><font color="#990000">);</font></span> |
- | + | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>writer <span><font color="#990000"><nowiki>==</nowiki></font></span> NULL<span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> | |
- | + | <span>'''<span><font color="#000000">g_print</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s, %i: Error creating the xml writer for %s</font></span><span><font color="#CC33CC">\n</font></span><span><font color="#FF0000">"</font></span><span><font color="#990000">,</font></span> __PRETTY_FUNCTION__<span><font color="#990000">,</font></span> __LINE__<span><font color="#990000">,</font></span> SCORES_XML<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#0000FF">return</font></span>'''</span><span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | <span><font color="#FF0000">}</font></span> | |
- | + | ||
- | < | + | <span>''<span><font color="#9A1900">/* Start the document with the xml default for the version,</font></span>''</span> |
- | # | + | <span>''<span><font color="#9A1900"> * encoding UTF-8 and the default for the standalone</font></span>''</span> |
- | # | + | <span>''<span><font color="#9A1900"> * declaration. */</font></span>''</span> |
- | # | + | rc <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">xmlTextWriterStartDocument</font></span>'''</span><span><font color="#990000">(</font></span>writer<span><font color="#990000">,</font></span> NULL<span><font color="#990000">,</font></span> <span><font color="#FF0000">"UTF-8"</font></span><span><font color="#990000">,</font></span> NULL<span><font color="#990000">);</font></span> |
- | # | + | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>rc <span><font color="#990000"><</font></span> <span><font color="#993399">0</font></span><span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> |
- | + | <span>'''<span><font color="#000000">g_print</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s, %i: Error at xmlTextWriterStartDocument</font></span><span><font color="#CC33CC">\n</font></span><span><font color="#FF0000">"</font></span><span><font color="#990000">,</font></span> __PRETTY_FUNCTION__<span><font color="#990000">,</font></span> __LINE__<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#0000FF">return</font></span>'''</span><span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | <span><font color="#FF0000">}</font></span> | |
- | + | ||
- | / | + | <span>''<span><font color="#9A1900">/* Start an element named ROOT_ELEMENT. Since thist is the first</font></span>''</span> |
- | + | <span>''<span><font color="#9A1900"> * element, this will be the root element of the document. */</font></span>''</span> | |
- | + | rc <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">xmlTextWriterStartElement</font></span>'''</span><span><font color="#990000">(</font></span>writer<span><font color="#990000">,</font></span> BAD_CAST ROOT_ELEMENT<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>rc <span><font color="#990000"><</font></span> <span><font color="#993399">0</font></span><span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> | |
- | + | <span>'''<span><font color="#000000">g_print</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s, %i: Error at xmlTextWriterStartElement</font></span><span><font color="#CC33CC">\n</font></span><span><font color="#FF0000">"</font></span><span><font color="#990000">,</font></span> __PRETTY_FUNCTION__<span><font color="#990000">,</font></span> __LINE__<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#0000FF">return</font></span>'''</span><span><font color="#990000"><nowiki>;</nowiki></font></span> | |
- | + | <span><font color="#FF0000">}</font></span> | |
- | + | ||
- | + | <span>''<span><font color="#9A1900">/* Save each score row from store. */</font></span>''</span> | |
- | + | <span>'''<span><font color="#000000">gtk_tree_model_foreach</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_TREE_MODEL</font></span>'''</span><span><font color="#990000">(</font></span>store<span><font color="#990000">),</font></span> scores_xml_save_score<span><font color="#990000">,</font></span> <span><font color="#990000">&</font></span>writer<span><font color="#990000">);</font></span> | |
- | </ | + | |
- | + | <span>''<span><font color="#9A1900">/* Here we could close the element named ROOT_ELEMENT using the</font></span>''</span> | |
- | + | <span>''<span><font color="#9A1900"> * function xmlTextWriterEndElement, but since we do not want to</font></span>''</span> | |
- | + | <span>''<span><font color="#9A1900"> * write any other elements, we simply call xmlTextWriterEndDocument,</font></span>''</span> | |
- | < | + | <span>''<span><font color="#9A1900"> * which will do all the work. */</font></span>''</span> |
- | + | rc <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">xmlTextWriterEndDocument</font></span>'''</span><span><font color="#990000">(</font></span>writer<span><font color="#990000">);</font></span> | |
- | + | <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>rc <span><font color="#990000"><</font></span> <span><font color="#993399">0</font></span><span><font color="#990000">)</font></span> <span><font color="#FF0000">{</font></span> | |
- | + | <span>'''<span><font color="#000000">g_print</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s, %i: Error at xmlTextWriterEndDocument</font></span><span><font color="#CC33CC">\n</font></span><span><font color="#FF0000">"</font></span><span><font color="#990000">,</font></span> __PRETTY_FUNCTION__<span><font color="#990000">,</font></span> __LINE__<span><font color="#990000">);</font></span> | |
- | + | <span><font color="#FF0000">}</font></span> | |
- | + | ||
- | + | <span>'''<span><font color="#000000">xmlFreeTextWriter</font></span>'''</span><span><font color="#990000">(</font></span>writer<span><font color="#990000">);</font></span> | |
- | + | <span><font color="#FF0000">}</font></span></tt> | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | </ | + | |
- | + | ||
- | == | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | < | + | |
- | + | ||
- | </ | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | < | + | |
- | # | + | |
- | # | + | |
- | </ | + | |
- | + | ||
- | + | ||
- | + | ||
- | < | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | </ | + | |
- | + | ||
- | === | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | < | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | </ | + | |
- | + | ||
- | + | ||
- | + | ||
- | < | + | |
- | + | ||
- | + | ||
- | </ | + | |
- | + | ||
- | + | ||
- | + | ||
- | < | + | |
- | + | ||
- | </ | + | |
== Integration to Menu == | == Integration to Menu == | ||
- | Application integration | + | Application integration to menu needs .desktop file. This section describes the needed additions and changes. |
- | Sliders | + | Sliders doesn't have appropriate .desktop file, so we need to generate it from `maemo-sliders.desktop.in' with `configure' script. maemo-sliders.desktop.in |
- | [Desktop Entry] | + | <code>[Desktop Entry] |
Encoding=UTF-8 | Encoding=UTF-8 | ||
Version=@VERSION@ | Version=@VERSION@ | ||
Line 476: | Line 403: | ||
Name=Maemo Sliders | Name=Maemo Sliders | ||
Exec=@prefix@/bin/maemo-sliders | Exec=@prefix@/bin/maemo-sliders | ||
+ | Icon=hello</code> | ||
== Application Packaging == | == Application Packaging == | ||
- | + | `dh_make' tool have been used for Sliders debianization | |
- | + | ||
- | + | ||
- | + | ||
- | + |
Learn more about Contributing to the wiki.