AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-12-26 13:41:07 +00:00
Code Issues Projects Releases Wiki Activity

Add some hints about GnomeColorPicker --> GtkColorButton migration.

Browse Source 
2004-11-04  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtk-docs.sgml:
	* gtk/migrating-GtkColorButton.sgml: Add some hints about
	GnomeColorPicker --> GtkColorButton migration.
This commit is contained in:
Matthias Clasen 2004-11-04 18:01:49 +00:00 committed by Matthias Clasen
parent eb60ff8604
commit d5e2f52013
3 changed files with 56 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/reference/ChangeLog
View File

@ -1,5 +1,11 @@
2004-11-04 Matthias Clasen <mclasen@redhat.com>
* gtk/gtk-docs.sgml:
* gtk/migrating-GtkColorButton.sgml: Add some hints about
GnomeColorPicker --> GtkColorButton migration.
* gtk/migrating-GtkAboutDialog.sgml: Fix links.
* gtk/Makefile.am (content_files): Add new migration chapters.
* gtk/tmpl/gtkaboutdialog.sgml: Markup fix.

5
docs/reference/gtk/gtk-docs.sgml
View File

@ -193,6 +193,7 @@
<!ENTITY gtk-migrating-GtkComboBox SYSTEM "migrating-GtkComboBox.sgml">
<!ENTITY gtk-migrating-GtkIconView SYSTEM "migrating-GtkIconView.sgml">
<!ENTITY gtk-migrating-GtkAboutDialog SYSTEM "migrating-GtkAboutDialog.sgml">
<!ENTITY gtk-migrating-GtkColorButton SYSTEM "migrating-GtkColorButton.sgml">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY gtk-query-immodules SYSTEM "gtk-query-immodules-2.0.xml">
<!ENTITY gtk-update-icon-cache SYSTEM "gtk-update-icon-cache.xml">
@ -564,6 +565,9 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
<para>
This part describes what you need to change in programs use
older versions of GTK+ so that they can use the new features.
It also mentions how to convert applications using widgets
found in the libgnomeui library to use their counterparts
in GTK+.
</para>
</partintro>
@ -575,6 +579,7 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
&gtk-migrating-GtkComboBox;
&gtk-migrating-GtkIconView;
&gtk-migrating-GtkAboutDialog;
&gtk-migrating-GtkColorButton;
</part>
<part>

45
docs/reference/gtk/migrating-GtkColorButton.sgml Normal file
View File

@ -0,0 +1,45 @@
<chapter id="gtk-migrating-GtkColorButton">
<title>Migrating from GnomeColorPicker to GtkColorButton</title>
<para>
Since version 2.6, GTK+ provides the <link linkend="GtkColorButton">GtkColorButton</link>
widget as a replacement for the GnomeColorPicker widget in the libgnomeui library.
</para>
<para>
Porting an application from GnomeColorPicker to <link linkend="GtkColorButton">GtkColorButton</link>
is very simple. <link linkend="GtkColorButton">GtkColorButton</link> doesn't support dithering
(since it is rarely needed on modern hardware), and it doesn't have setters and getters to set the
color from floating point or integer components. So instead of
<informalexample><programlisting>
guint red, green, blue, alpha;
/* ... */
gnome_color_picker_set_i8 (color_picker, red, green, blue, alpha);
</programlisting></informalexample>
you have to write
<informalexample><programlisting>
GdkColor color;
color.red = red << 8;
color.green = green << 8;
color.blue = blue << 8;
gtk_color_button_set_color (color_picker, &color);
gtk_color_button_set_alpha (color_picker, alpha << 8);
</programlisting></informalexample>
and similarly for the setters taking other number formats. For gnome_color_picker_set_i16() no conversion
is needed, for gome_color_picker_set_d(), you need to convert the color components like this:
<informalexample><programlisting>
color.red = (guint16) (red * 65535.0 + 0.5);
color.green = (guint16) (green * 65535.0 + 0.5);
color.blue = (guint16) (blue * 65535.0 + 0.5);
</programlisting></informalexample>
</para>
</chapter>
<!--
Local variables:
mode: sgml
sgml-parent-document: ("gtk-docs.sgml" "book" "part" "chapter")
End:
-->