Legacy Maemo 5 Documentation/Graphical UI Tutorial/Introduction - Revision history

amigadave: wikify slightly

2010-10-15T08:10:51Z

wikify slightly

tapio at 11:40, 12 February 2010

2010-02-12T11:40:20Z

← Older revision		Revision as of 11:40, 12 February 2010
Line 5:		Line 5:
	The following code examples are used in this chapter:		The following code examples are used in this chapter:

-	* [https://~~garage~~.maemo.org/svn/maemoexamples/~~trunk~~/hildon-examples/ hildon-examples]	+	* [https://vcs.maemo.org/svn/maemoexamples/tags/maemo_5.0/hildon-examples/ hildon-examples]

	Maemo platform's basic starting point for graphical user interface programming is [http://live.gnome.org/Hildon/ Hildon], an application framework comprising of a lightweight desktop, a set of widgets optimized for handheld devices, a set of theming tools and other complementary libraries and applications.		Maemo platform's basic starting point for graphical user interface programming is [http://live.gnome.org/Hildon/ Hildon], an application framework comprising of a lightweight desktop, a set of widgets optimized for handheld devices, a set of theming tools and other complementary libraries and applications.

amigadave: {{Legacy documentation}}

2010-02-12T09:44:41Z

← Older revision		Revision as of 09:44, 12 February 2010
Line 1:		Line 1:
		+	{{Legacy documentation}}
		+
	=Introduction=		=Introduction=

urih: /* "Because Maemo version 5.0" is not a sentence. */

2009-12-29T17:56:24Z

"Because Maemo version 5.0" is not a sentence.

← Older revision		Revision as of 17:56, 29 December 2009
Line 11:		Line 11:
	Hildon is a user interface toolkit based on GTK that targets mobile devices. Hildon was originally developed by Nokia for the Maemo operating system that powered its Internet Tablet devices.		Hildon is a user interface toolkit based on GTK that targets mobile devices. Hildon was originally developed by Nokia for the Maemo operating system that powered its Internet Tablet devices.

-	Because Maemo version 5.0 (also known as Fremantle), Hildon widgets are specially designed to be finger-friendly, that is, easily used on touch-screen devices. Hildon is published under the LGPL license which gives you the right to develop free and open source, as well as commercial software with Hildon without being charged for licenses or royalties.	+	Because of Maemo version 5.0 (also known as Fremantle), Hildon widgets are specially designed to be finger-friendly, that is, easily used on touch-screen devices. Hildon is published under the LGPL license which gives you the right to develop free and open source, as well as commercial software with Hildon without being charged for licenses or royalties.

	Because Hildon is based on GTK, it offers an object-oriented API, although written in C.		Because Hildon is based on GTK, it offers an object-oriented API, although written in C.

msoini: Documentation/Maemo 5 Developer Guide/Graphical UI Tutorial/Introduction moved to Legacy Maemo 5 Documentation/Graphical UI Tutorial/Introduction: Phase out from Maemo Developer Guide, superceded by Official Nokia Forum documentation

2009-10-14T09:26:20Z

Documentation/Maemo 5 Developer Guide/Graphical UI Tutorial/Introduction moved to Legacy Maemo 5 Documentation/Graphical UI Tutorial/Introduction: Phase out from Maemo Developer Guide, superceded by Official Nokia Forum documentation

← Older revision

Revision as of 09:26, 14 October 2009

msoini at 09:25, 14 October 2009

2009-10-14T09:25:22Z

← Older revision		Revision as of 09:25, 14 October 2009
Line 19:		Line 19:
	This document is intended for developers and covers the usage of Hildon to create graphical user interfaces. It starts from a simple "Hello World" program and expands to more complex examples, presenting a number of widgets and their usage to accomplish some tasks from a technical point of view. It enables you to understand the process of graphical user interface programming and build effective touch interfaces for mobile devices with Hildon.		This document is intended for developers and covers the usage of Hildon to create graphical user interfaces. It starts from a simple "Hello World" program and expands to more complex examples, presenting a number of widgets and their usage to accomplish some tasks from a technical point of view. It enables you to understand the process of graphical user interface programming and build effective touch interfaces for mobile devices with Hildon.

-	This topic assumes a good knowledge of the C programming language. Previous experience in creating graphical user interfaces with GTK will be helpful but not mandatory. This topic targets the development of graphical user interfaces, not the design of such. For more information on designing interfaces with regard to usability and user experience, see the topic on [[~~Documentation/~~Maemo 5 ~~Developer Guide~~/Human Interface Guidelines \| Hildon Human Interface Guidelines]].	+	This topic assumes a good knowledge of the C programming language. Previous experience in creating graphical user interfaces with GTK will be helpful but not mandatory. This topic targets the development of graphical user interfaces, not the design of such. For more information on designing interfaces with regard to usability and user experience, see the topic on [[Legacy Maemo 5 Documentation/Human Interface Guidelines \| Hildon Human Interface Guidelines]].

	== Desktop overview==		== Desktop overview==
Line 28:		Line 28:
	* A: Task switcher button. Tapping on it, the application is put into in the background and the desktop is quickly shown allowing you to choose any running application, as well as the application you had on before. To access the home view from this new view, press the dimmed area around the applications' thumbnails or launch another task by tapping the task switcher button which in this view becomes a task launcher button.		* A: Task switcher button. Tapping on it, the application is put into in the background and the desktop is quickly shown allowing you to choose any running application, as well as the application you had on before. To access the home view from this new view, press the dimmed area around the applications' thumbnails or launch another task by tapping the task switcher button which in this view becomes a task launcher button.
	* B: Status area button. Provides information about the status of the device or applications. A status view can be accessed by pressing the status area.		* B: Status area button. Provides information about the status of the device or applications. A status view can be accessed by pressing the status area.
-	* C: Close button. Closes the application. Note that if the current application's window is a subview (for more information, see [[~~Documentation/~~Maemo 5 ~~Developer Guide~~/Graphical UI Tutorial/Windows and dialogs \| Windows and dialogs]]), a back button is displayed instead of a close button. The back button also closes the window but instead of closing the application, it goes back to a previous view.	+	* C: Close button. Closes the application. Note that if the current application's window is a subview (for more information, see [[Legacy Maemo 5 Documentation/Graphical UI Tutorial/Windows and dialogs \| Windows and dialogs]]), a back button is displayed instead of a close button. The back button also closes the window but instead of closing the application, it goes back to a previous view.
	* D: Title area. Shows an identifier of the application's current task, usually its name but may also be a document's name, and so on. Tapping on it calls the application's menu.		* D: Title area. Shows an identifier of the application's current task, usually its name but may also be a document's name, and so on. Tapping on it calls the application's menu.
	* F: Application area. Shows the actual application's contents.		* F: Application area. Shows the actual application's contents.

kimmos: Added link to next page

2009-10-12T14:12:50Z

Added link to next page

← Older revision		Revision as of 14:12, 12 October 2009
Line 54:		Line 54:

	There are some caveats related to API changes between major GTK+ versions, so do not copy paste existing codes blindly.		There are some caveats related to API changes between major GTK+ versions, so do not copy paste existing codes blindly.
		+
		+	<hr/>
		+	<table width=100%>
		+	<tr><td width=30% align=left></td>
		+	<td align=center>Up: [[{{BASEPAGENAME}}\|Table of Contents]]</td>
		+	<td width=30% align=right>
		+	Next: [[{{BASEPAGENAME}}/Getting_started\|Getting Started]]</td>
		+	</tr></table>

liox_lang_valid: /* Introduction */

2009-09-24T11:07:18Z

Introduction

tatiana: /* Introduction */

2009-09-11T12:23:07Z

Introduction

← Older revision		Revision as of 12:23, 11 September 2009
Line 1:		Line 1:
-	==Introduction==	+	=Introduction=

	The following code examples are used in this chapter:		The following code examples are used in this chapter:
Line 21:		Line 21:
	This topic assumes a good knowledge of the C programming language. Previous experience in creating graphical user interfaces with GTK will be helpful but not mandatory. This topic targets the development of graphical user interfaces, not the design of such. For more information on designing interfaces with regard to usability and user experience, see the topic on [[Documentation/Maemo 5 Developer Guide/Human Interface Guidelines \| Hildon Human Interface Guidelines]].		This topic assumes a good knowledge of the C programming language. Previous experience in creating graphical user interfaces with GTK will be helpful but not mandatory. This topic targets the development of graphical user interfaces, not the design of such. For more information on designing interfaces with regard to usability and user experience, see the topic on [[Documentation/Maemo 5 Developer Guide/Human Interface Guidelines \| Hildon Human Interface Guidelines]].

-	=== Desktop overview===	+	== Desktop overview==
	This section gives a brief overview of the Hildon desktop area in order to give you a better understanding of the application domains and layout.		This section gives a brief overview of the Hildon desktop area in order to give you a better understanding of the application domains and layout.

tatiana: dropped links to examples, that not used in this chapter

2009-09-11T09:18:57Z

dropped links to examples, that not used in this chapter

← Older revision		Revision as of 09:18, 11 September 2009
Line 1:		Line 1:
-	~~= Application Development =~~
-
	==Introduction==		==Introduction==

	The following code examples are used in this chapter:		The following code examples are used in this chapter:

-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_hildonprogram.c example_hildonprogram.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_menu.c example_menu.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_toolbar.c example_toolbar.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_findtoolbar.c example_findtoolbar.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_file_chooser.c example_file_chooser.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_color_chooser.c example_color_chooser.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_font_selector.c example_font_selector.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_file_details.c example_file_details.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_banner.c example_banner.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_context.c example_context.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_hard_keys.c example_hard_keys.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_libosso.desktop example_libosso.desktop]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_libosso.service example_libosso.service]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_libosso.c example_libosso.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_message.c example_message.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/example_gconf.c example_gconf.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemo-examples/libapplet.c libapplet.c]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/hello-world-app/ Hildon Desktop Plug-ins sample]
-	* [https://garage.maemo.org/svn/maemoexamples/trunk/maemopad MaemoPad]
	* [https://garage.maemo.org/svn/maemoexamples/trunk/hildon-examples/ hildon-examples]		* [https://garage.maemo.org/svn/maemoexamples/trunk/hildon-examples/ hildon-examples]

← Older revision		Revision as of 08:10, 15 October 2010
Line 1:		Line 1:
	{{Legacy documentation}}		{{Legacy documentation}}
-
-	~~=Introduction=~~

	The following code examples are used in this chapter:		The following code examples are used in this chapter:
Line 11:		Line 9:
	Hildon is based on [http://www.gnome.org/ GNOME] technologies to a great extent. Compared to a GNOME desktop from a user interface point of view, Hildon is designed to provide a new desktop for mobile embedded devices. Therefore, it uses, for example, a lighter window manager called [http://matchbox-project.org/ Matchbox].		Hildon is based on [http://www.gnome.org/ GNOME] technologies to a great extent. Compared to a GNOME desktop from a user interface point of view, Hildon is designed to provide a new desktop for mobile embedded devices. Therefore, it uses, for example, a lighter window manager called [http://matchbox-project.org/ Matchbox].

-	Hildon is a user interface toolkit based on GTK that targets mobile devices. Hildon was originally developed by Nokia for the Maemo operating system that powered its Internet Tablet devices.	+	Hildon is a user interface toolkit based on GTK+ that targets mobile devices. Hildon was originally developed by Nokia for the Maemo operating system that powered its Internet Tablet devices.

	Because of Maemo version 5.0 (also known as Fremantle), Hildon widgets are specially designed to be finger-friendly, that is, easily used on touch-screen devices. Hildon is published under the LGPL license which gives you the right to develop free and open source, as well as commercial software with Hildon without being charged for licenses or royalties.		Because of Maemo version 5.0 (also known as Fremantle), Hildon widgets are specially designed to be finger-friendly, that is, easily used on touch-screen devices. Hildon is published under the LGPL license which gives you the right to develop free and open source, as well as commercial software with Hildon without being charged for licenses or royalties.
Line 17:		Line 15:
	Because Hildon is based on GTK, it offers an object-oriented API, although written in C.		Because Hildon is based on GTK, it offers an object-oriented API, although written in C.

-	GTK is a library for creating user interfaces that is used in a number of important projects like GNOME. This topic includes many references to GTK and Glib. Glib is a library that offers functions to manage memory and data structures, as well as some replacements for standard calls in order to increase portability. For more information on GTK and Glib, see [http://www.gtk.org/documentation.html GTK and Glib documentation].	+	GTK+ is a library for creating user interfaces that is used in a number of important projects like GNOME. This topic includes many references to GTK and Glib. Glib is a library that offers functions to manage memory and data structures, as well as some replacements for standard calls in order to increase portability. For more information on GTK and Glib, see [http://www.gtk.org/documentation.html GTK and Glib documentation].

	This document is intended for developers and covers the usage of Hildon to create graphical user interfaces. It starts from a simple "Hello World" program and expands to more complex examples, presenting a number of widgets and their usage to accomplish some tasks from a technical point of view. It enables you to understand the process of graphical user interface programming and build effective touch interfaces for mobile devices with Hildon.		This document is intended for developers and covers the usage of Hildon to create graphical user interfaces. It starts from a simple "Hello World" program and expands to more complex examples, presenting a number of widgets and their usage to accomplish some tasks from a technical point of view. It enables you to understand the process of graphical user interface programming and build effective touch interfaces for mobile devices with Hildon.
Line 24:		Line 22:

	== Desktop overview==		== Desktop overview==
		+
	This section gives a brief overview of the Hildon desktop area in order to give you a better understanding of the application domains and layout.		This section gives a brief overview of the Hildon desktop area in order to give you a better understanding of the application domains and layout.

Line 34:		Line 33:
	* F: Application area. Shows the actual application's contents.		* F: Application area. Shows the actual application's contents.

-	[[Image: desktop_overview.png\|~~400px~~]]	+	[[Image:desktop_overview.png\|frame\|center\|alt=Screenshot of desktop\|Desktop overview]]

	Note that the above explanation refers to the normal view of an application. When using an application on fullscreen mode, only the application area is shown. Also note that if an application has a toolbar widget, it is displayed at the very bottom of the application's area, both in normal and in fullscreen views.		Note that the above explanation refers to the normal view of an application. When using an application on fullscreen mode, only the application area is shown. Also note that if an application has a toolbar widget, it is displayed at the very bottom of the application's area, both in normal and in fullscreen views.

	== Typical Maemo GUI Application ==		== Typical Maemo GUI Application ==
		+
	The following shows the components making up a typical GUI application developed for Maemo (starting from the bottom):		The following shows the components making up a typical GUI application developed for Maemo (starting from the bottom):

-	* '''C library'''~~<nowiki>~~: Implements wrappers around the system calls to the kernel and a lot of other useful things. However, the libraries presented below also provide their own APIs to similar functions, so always check whether they can be used directly, and avoid doing POSIX-level and system-level calls if possible. This makes the application easier to debug, and in some cases easier understand. This library is used (indirectly at least) by every application running on any Linux-based system. ~~</nowiki>~~	+	* '''C library''': Implements wrappers around the system calls to the kernel and a lot of other useful things. However, the libraries presented below also provide their own APIs to similar functions, so always check whether they can be used directly, and avoid doing POSIX-level and system-level calls if possible. This makes the application easier to debug, and in some cases easier understand. This library is used (indirectly at least) by every application running on any Linux-based system.
-	* '''Xlib'''~~<nowiki>~~: A library that allows an application to send graphics-related commands to the X server, and receive HID events from the server. Normally an application does not use Xlib API directly, but uses some easier toolkit instead, which in turn uses Xlib. ~~</nowiki>~~	+	* '''Xlib''': A library that allows an application to send graphics-related commands to the X server, and receive HID events from the server. Normally an application does not use Xlib API directly, but uses some easier toolkit instead, which in turn uses Xlib.
-	* '''GLib'''~~<nowiki>~~: A utility library that provides portable types, an object-oriented framework (GObject/GType), a general event mechanism (sometimes referred to as GSignal), common abstract data structure types like hash tables, linked lists, etc. ~~</nowiki>~~	+	* '''GLib''': A utility library that provides portable types, an object-oriented framework (GObject/GType), a general event mechanism (sometimes referred to as <code>GSignal</code>), common abstract data structure types like hash tables, linked lists, etc.
-	* '''GDK'''~~<nowiki>~~: A library that abstracts the Xlib and provides a lot of convenience code to implement most common graphical operations. Used by an application wanting to implement drawing directly, for example in order to implement custom widgets. In theory, GDK is meant to be independent of graphics systems, which it mostly is. Complete abstraction, however, is not yet complete, but for now, the original Xlib target is enough. GDK uses GLib internally. ~~</nowiki>~~	+	* '''GDK''': A library that abstracts the Xlib and provides a lot of convenience code to implement most common graphical operations. Used by an application wanting to implement drawing directly, for example in order to implement custom widgets. In theory, GDK is meant to be independent of graphics systems, which it mostly is. Complete abstraction, however, is not yet complete, but for now, the original Xlib target is enough. GDK uses GLib internally.
-	* '''Pango'''~~<nowiki>~~: A portable library designed to implement correct and flexible text layout for all languages. This is necessary to support the different text entry directions. Uses GLib and GDK. Used by GTK+ for all displayed text. ~~</nowiki>~~	+	* '''Pango''': A portable library designed to implement correct and flexible text layout for all languages. This is necessary to support the different text entry directions. Uses GLib and GDK. Used by GTK+ for all displayed text.
-	* '''ATK'''~~<nowiki>~~: The Accessibility ToolKit. Provides generic methods by which an application can support people with special needs with respect to using computers. ~~</nowiki>~~	+	* '''ATK''': The Accessibility ToolKit. Provides generic methods by which an application can support people with special needs with respect to using computers.
-	* '''GTK+'''~~<nowiki>~~: A library that provides a portable set of graphical elements, graphical area layout capabilities and interaction functions for applications. Graphical elements in GTK+ are called widgets. GTK+ also supports the notion of themes, which are user-switchable sets of graphics and behavior models. These are called skins in some other systems. Uses GLib, GDK, Pango and ATK. ~~</nowiki>~~	+	* '''GTK+''': A library that provides a portable set of graphical elements, graphical area layout capabilities and interaction functions for applications. Graphical elements in GTK+ are called widgets. GTK+ also supports the notion of themes, which are user-switchable sets of graphics and behavior models. These are called skins in some other systems. Uses GLib, GDK, Pango and ATK.
-	* '''Hildon'''~~<nowiki>~~: A library containing widgets and themes designed specifically for Maemo. This is necessary because the screen has very high PPI (compared to PCs), and applications are sometimes controlled with a stylus. Uses all of the libraries above. ~~</nowiki>~~	+	* '''Hildon''': A library containing widgets and themes designed specifically for Maemo. This is necessary because the screen has very high PPI (compared to PCs), and applications are sometimes controlled with a stylus. Uses all of the libraries above.
	* Other support libraries of interest:		* Other support libraries of interest:
-	** '''GConf'''~~<nowiki>~~: A library from the GNOME project that allows applications to store and retrieve their settings in a consistent manner (in a way, similar to the registry in Windows). Uses GLib. ~~</nowiki>~~	+	** '''GConf''': A library from the GNOME project that allows applications to store and retrieve their settings in a consistent manner (in a way, similar to the registry in Windows). Uses GLib.
-	** '''GnomeVFS'''~~<nowiki>~~: A library that provides a coherent set of file access functions, and implements those functions using plug-in libraries for different kinds of files and devices. Allows the application to ignore the semantics of implementations between different kinds of devices and services. By using GnomeVFS, an application does not need to care whether it reads a file from a web server (URLs are supported), from a compressed file archive (.zip, .rpm, .tar.gz, etc.) or from a memory card. Modeled to follow POSIX-style file and directory operations. ~~</nowiki>~~	+	** '''GnomeVFS''': A library that provides a coherent set of file access functions, and implements those functions using plug-in libraries for different kinds of files and devices. Allows the application to ignore the semantics of implementations between different kinds of devices and services. By using GnomeVFS, an application does not need to care whether it reads a file from a web server (URLs are supported), from a compressed file archive (.zip, .rpm, .tar.gz, etc.) or from a memory card. Modeled to follow POSIX-style file and directory operations.
-	** '''GDK-Pixbuf'''~~<nowiki>~~: A library that implements various graphical bitmap formats and also alpha-channeled blending operations using 32-bit pixels (RGBA). The Application Framework uses pixbufs to implement the shadows and background picture scaling if necessary. Uses GLib and GDK. ~~</nowiki>~~	+	** '''GDK-Pixbuf''': A library that implements various graphical bitmap formats and also alpha-channeled blending operations using 32-bit pixels (RGBA). The Application Framework uses pixbufs to implement the shadows and background picture scaling if necessary. Uses GLib and GDK.
-	** '''LibOSSO'''~~<nowiki>~~: A library specific to the Maemo platform, allowing an application to connect to D-Bus in a simple and consistent manner. Also provides an application state serialization mechanism. This mechanism can be used by an application to store its state, so that it can continue from the exact point in time when the user switched to another application. Useful to conserve battery life on portable devices. ~~</nowiki>~~	+	** '''LibOSSO''': A library specific to the Maemo platform, allowing an application to connect to D-Bus in a simple and consistent manner. Also provides an application state serialization mechanism. This mechanism can be used by an application to store its state, so that it can continue from the exact point in time when the user switched to another application. Useful to conserve battery life on portable devices.

-	There are some caveats related to API changes between major GTK+ versions, so do not copy paste existing ~~codes~~ blindly.	+	There are some caveats related to API changes between major GTK+ versions, so do not copy and paste existing code blindly.

	<hr/>		<hr/>

← Older revision		Revision as of 11:07, 24 September 2009
Line 5:		Line 5:
	* [https://garage.maemo.org/svn/maemoexamples/trunk/hildon-examples/ hildon-examples]		* [https://garage.maemo.org/svn/maemoexamples/trunk/hildon-examples/ hildon-examples]

-	~~The~~ Maemo platform's basic starting point for graphical user interface programming is [http://live.gnome.org/Hildon/ Hildon], an application framework comprising of a lightweight desktop, a set of widgets optimized for handheld devices, a set of theming tools and other complementary libraries and applications.	+	Maemo platform's basic starting point for graphical user interface programming is [http://live.gnome.org/Hildon/ Hildon], an application framework comprising of a lightweight desktop, a set of widgets optimized for handheld devices, a set of theming tools and other complementary libraries and applications.

-	Hildon is based on [http://www.gnome.org/ GNOME] technologies to a great extent. Compared to a GNOME desktop from a user interface point of view, Hildon is designed to provide a new desktop for mobile embedded devices. Therefore it uses, for example, a lighter window manager called [http://matchbox-project.org/ Matchbox].	+	Hildon is based on [http://www.gnome.org/ GNOME] technologies to a great extent. Compared to a GNOME desktop from a user interface point of view, Hildon is designed to provide a new desktop for mobile embedded devices. Therefore, it uses, for example, a lighter window manager called [http://matchbox-project.org/ Matchbox].

	Hildon is a user interface toolkit based on GTK that targets mobile devices. Hildon was originally developed by Nokia for the Maemo operating system that powered its Internet Tablet devices.		Hildon is a user interface toolkit based on GTK that targets mobile devices. Hildon was originally developed by Nokia for the Maemo operating system that powered its Internet Tablet devices.

-	~~Since~~ Maemo version 5.0 (also known as Fremantle), Hildon widgets are specially designed to be finger-friendly, that is, easily used on touch-screen devices. Hildon is published under the LGPL license which gives you the right to develop free and open source, as well as commercial software with Hildon without being charged for licenses or royalties.	+	Because Maemo version 5.0 (also known as Fremantle), Hildon widgets are specially designed to be finger-friendly, that is, easily used on touch-screen devices. Hildon is published under the LGPL license which gives you the right to develop free and open source, as well as commercial software with Hildon without being charged for licenses or royalties.

	Because Hildon is based on GTK, it offers an object-oriented API, although written in C.		Because Hildon is based on GTK, it offers an object-oriented API, although written in C.

-	GTK is a library for creating user interfaces that is used in a number of important projects like GNOME. This topic includes many references to GTK and Glib. Glib is a library that offers functions to manage memory and data structures, as well as some replacements for standard calls in order to increase portability. For more information on GTK and Glib, ~~refer to~~ [http://www.gtk.org/documentation.html GTK and Glib documentation].	+	GTK is a library for creating user interfaces that is used in a number of important projects like GNOME. This topic includes many references to GTK and Glib. Glib is a library that offers functions to manage memory and data structures, as well as some replacements for standard calls in order to increase portability. For more information on GTK and Glib, see [http://www.gtk.org/documentation.html GTK and Glib documentation].

	This document is intended for developers and covers the usage of Hildon to create graphical user interfaces. It starts from a simple "Hello World" program and expands to more complex examples, presenting a number of widgets and their usage to accomplish some tasks from a technical point of view. It enables you to understand the process of graphical user interface programming and build effective touch interfaces for mobile devices with Hildon.		This document is intended for developers and covers the usage of Hildon to create graphical user interfaces. It starts from a simple "Hello World" program and expands to more complex examples, presenting a number of widgets and their usage to accomplish some tasks from a technical point of view. It enables you to understand the process of graphical user interface programming and build effective touch interfaces for mobile devices with Hildon.
Line 29:		Line 29:
	* B: Status area button. Provides information about the status of the device or applications. A status view can be accessed by pressing the status area.		* B: Status area button. Provides information about the status of the device or applications. A status view can be accessed by pressing the status area.
	* C: Close button. Closes the application. Note that if the current application's window is a subview (for more information, see [[Documentation/Maemo 5 Developer Guide/Graphical UI Tutorial/Windows and dialogs \| Windows and dialogs]]), a back button is displayed instead of a close button. The back button also closes the window but instead of closing the application, it goes back to a previous view.		* C: Close button. Closes the application. Note that if the current application's window is a subview (for more information, see [[Documentation/Maemo 5 Developer Guide/Graphical UI Tutorial/Windows and dialogs \| Windows and dialogs]]), a back button is displayed instead of a close button. The back button also closes the window but instead of closing the application, it goes back to a previous view.
-	* D: Title area. Shows an identifier of the application's current task, usually its name but may also be a document's name, ~~etc~~. Tapping on it calls the application's menu.	+	* D: Title area. Shows an identifier of the application's current task, usually its name but may also be a document's name, and so on. Tapping on it calls the application's menu.
	* F: Application area. Shows the actual application's contents.		* F: Application area. Shows the actual application's contents.

Line 39:		Line 39:
	The following shows the components making up a typical GUI application developed for Maemo (starting from the bottom):		The following shows the components making up a typical GUI application developed for Maemo (starting from the bottom):

-	* '''C library'''<nowiki>: Implements wrappers around the system calls to the kernel and a lot of other useful things. However, the libraries presented below also provide their own APIs to similar functions, so ~~it should~~ always ~~be checked~~ whether they can be used directly, and avoid doing POSIX-level and system-level calls if possible. This makes the application easier to debug, and in some cases easier understand. This library is used (indirectly at least) by every application running on any Linux-based system. </nowiki>	+	* '''C library'''<nowiki>: Implements wrappers around the system calls to the kernel and a lot of other useful things. However, the libraries presented below also provide their own APIs to similar functions, so always check whether they can be used directly, and avoid doing POSIX-level and system-level calls if possible. This makes the application easier to debug, and in some cases easier understand. This library is used (indirectly at least) by every application running on any Linux-based system. </nowiki>
	* '''Xlib'''<nowiki>: A library that allows an application to send graphics-related commands to the X server, and receive HID events from the server. Normally an application does not use Xlib API directly, but uses some easier toolkit instead, which in turn uses Xlib. </nowiki>		* '''Xlib'''<nowiki>: A library that allows an application to send graphics-related commands to the X server, and receive HID events from the server. Normally an application does not use Xlib API directly, but uses some easier toolkit instead, which in turn uses Xlib. </nowiki>
	* '''GLib'''<nowiki>: A utility library that provides portable types, an object-oriented framework (GObject/GType), a general event mechanism (sometimes referred to as GSignal), common abstract data structure types like hash tables, linked lists, etc. </nowiki>		* '''GLib'''<nowiki>: A utility library that provides portable types, an object-oriented framework (GObject/GType), a general event mechanism (sometimes referred to as GSignal), common abstract data structure types like hash tables, linked lists, etc. </nowiki>
Line 46:		Line 46:
	* '''ATK'''<nowiki>: The Accessibility ToolKit. Provides generic methods by which an application can support people with special needs with respect to using computers. </nowiki>		* '''ATK'''<nowiki>: The Accessibility ToolKit. Provides generic methods by which an application can support people with special needs with respect to using computers. </nowiki>
	* '''GTK+'''<nowiki>: A library that provides a portable set of graphical elements, graphical area layout capabilities and interaction functions for applications. Graphical elements in GTK+ are called widgets. GTK+ also supports the notion of themes, which are user-switchable sets of graphics and behavior models. These are called skins in some other systems. Uses GLib, GDK, Pango and ATK. </nowiki>		* '''GTK+'''<nowiki>: A library that provides a portable set of graphical elements, graphical area layout capabilities and interaction functions for applications. Graphical elements in GTK+ are called widgets. GTK+ also supports the notion of themes, which are user-switchable sets of graphics and behavior models. These are called skins in some other systems. Uses GLib, GDK, Pango and ATK. </nowiki>
-	* '''Hildon'''<nowiki>: A library containing widgets and themes designed specifically for Maemo. This is necessary because the screen has very high PPI (compared to PCs), and applications are sometimes controlled ~~via~~ a stylus. Uses all of the libraries above. </nowiki>	+	* '''Hildon'''<nowiki>: A library containing widgets and themes designed specifically for Maemo. This is necessary because the screen has very high PPI (compared to PCs), and applications are sometimes controlled with a stylus. Uses all of the libraries above. </nowiki>
	* Other support libraries of interest:		* Other support libraries of interest:
	** '''GConf'''<nowiki>: A library from the GNOME project that allows applications to store and retrieve their settings in a consistent manner (in a way, similar to the registry in Windows). Uses GLib. </nowiki>		** '''GConf'''<nowiki>: A library from the GNOME project that allows applications to store and retrieve their settings in a consistent manner (in a way, similar to the registry in Windows). Uses GLib. </nowiki>
Line 53:		Line 53:
	** '''LibOSSO'''<nowiki>: A library specific to the Maemo platform, allowing an application to connect to D-Bus in a simple and consistent manner. Also provides an application state serialization mechanism. This mechanism can be used by an application to store its state, so that it can continue from the exact point in time when the user switched to another application. Useful to conserve battery life on portable devices. </nowiki>		** '''LibOSSO'''<nowiki>: A library specific to the Maemo platform, allowing an application to connect to D-Bus in a simple and consistent manner. Also provides an application state serialization mechanism. This mechanism can be used by an application to store its state, so that it can continue from the exact point in time when the user switched to another application. Useful to conserve battery life on portable devices. </nowiki>

-	There are some caveats related to API changes between major GTK+ versions, ~~and existing codes should~~ not be copy~~-pasted~~ blindly.	+	There are some caveats related to API changes between major GTK+ versions, so do not copy paste existing codes blindly.