[gtkmm-documentation] Removed Drawing With GDK appendix.
- From: Murray Cumming <murrayc src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [gtkmm-documentation] Removed Drawing With GDK appendix.
- Date: Mon, 8 Feb 2010 09:38:47 +0000 (UTC)
commit 13530d3b7234452ac75eae401d08d2bac74581ee
Author: Murray Cumming <murrayc murrayc com>
Date: Mon Feb 8 10:14:29 2010 +0100
Removed Drawing With GDK appendix.
* docs/tutorial/C/gtkmm-tutorial-in.xml: Removed deprecated
Drawing With GDK appendix. The older versions are online if people
need this.
ChangeLog | 8 ++++
docs/tutorial/C/gtkmm-tutorial-in.xml | 61 ---------------------------------
2 files changed, 8 insertions(+), 61 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 24c27ac..9d560bc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
2010-02-08 Murray Cumming <murrayc murrayc com>
+ Removed Drawing With GDK appendix.
+
+ * docs/tutorial/C/gtkmm-tutorial-in.xml: Removed deprecated
+ Drawing With GDK appendix. The older versions are online if people
+ need this.
+
+2010-02-08 Murray Cumming <murrayc murrayc com>
+
Building from svn chapter: Mention git instead.
* docs/tutorial/C/gtkmm-tutorial-in.xml: Building from svn:
diff --git a/docs/tutorial/C/gtkmm-tutorial-in.xml b/docs/tutorial/C/gtkmm-tutorial-in.xml
index 9ea345d..60fec93 100644
--- a/docs/tutorial/C/gtkmm-tutorial-in.xml
+++ b/docs/tutorial/C/gtkmm-tutorial-in.xml
@@ -8126,67 +8126,6 @@ practical - and sensible - to subclass a button for that purpose.
</sect1>
</appendix>
-<appendix id="chapter-gdk-drawing">
-<title>Drawing With GDK</title>
-<para>The GDK drawing API described here is now deprecated, in favour of Cairo. See the <link linkend="chapter-drawingarea">DrawingArea</link> chapter for information about the Cairo API.</para>
-<para>
- Gdk graphics contexts (<classname>Gdk::GC</classname>) are a
- server-side resource. They contain information that describes how
- drawing is to be done. This provides for fewer arguments to the
- drawing methods, and less communication between the client and the
- server. The following example shows how to set up a graphics context
- with a foreground color of red for drawing.
- </para>
- <programlisting>Gdk::GC some_gc;
-some_gc.create(get_window());
-Gdk::Color some_color;
-Gdk::Colormap some_colormap(Gdk::Colormap::get_system());
-some_color.set_red(65535);
-some_color.set_green(0);
-some_color.set_blue(0);
-some_colormap.alloc(some_color);
-some_gc.set_foreground(some_color);</programlisting>
- <para>
- The first two lines create the graphics context and assign it to the
- appropriate widget. The <methodname>get_window()</methodname> method is
- a part of the <classname>Gtk::Widget</classname> class, so if you put
- this code into a derived widget's implementation then you can call it
- just as it is, otherwise you'd use
- <methodname>some_widget.get_window()</methodname>.
- </para>
- <para>
- The next two lines create the <classname>Gdk::Color</classname> and
- <classname>Gdk::Colormap</classname>. After setting the color values
- you then need to allocate the color. The system figures out what to
- do in this case. The colormap contains information about how colors
- can be displayed on your screen, and is able to allocate the
- requested color. For example, on a display of only 256 colors the
- exact color requested may not be available, so the closest color to
- the one requested will be used instead. The final line sets the color
- as the foreground color.
- </para>
- <para>
- There are a number of attributes that can be set for a graphics
- context. There's the foreground and background color. When drawing
- lines, you can set the thickness of the line with
- <methodname>set_line_width()</methodname>. Whether a solid or dashed line
- is drawn can be set with <methodname>set_line_style()</methodname>. The
- size and proportions of the dashes are set with
- <methodname>set_dashes</methodname>. How two lines join together, whether
- round or pointed or beveled off, is set with
- <methodname>set_join_style()</methodname>. Other things that can be set
- within a graphics context include font style, stippling and tiling
- for the filling of solid polygons.
- </para>
- <para>
- Graphics contexts are central to drawing with Gdk, because nearly all Gdk
- drawing functions and many Pango functions take a
- <classname>Gdk::GC</classname> object as an argument. So although Cairo
- has largely superceded many Gdk drawing functions, you're still likely to
- run into <classname>Gdk::GC</classname> objects quite often, so it's
- important to know what they are and how they're used.
- </para>
-</appendix>
<appendix id="chapter-working-with-source">
<title>Working with gtkmm's Source Code</title>
<para>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]