[cairo-commit] goocanvas/docs Makefile.am, 1.3, 1.4 creating-items.xml, NONE, 1.1 goocanvas-docs.sgml, 1.6, 1.7 model-view-canvas.xml, NONE, 1.1 overview.xml, NONE, 1.1 simple-canvas.xml, NONE, 1.1

Damon Chaplin commit at pdx.freedesktop.org
Thu Feb 8 14:56:51 PST 2007


Committed by: damon

Update of /cvs/cairo/goocanvas/docs
In directory kemper:/tmp/cvs-serv23550/docs

Modified Files:
	Makefile.am goocanvas-docs.sgml 
Added Files:
	creating-items.xml model-view-canvas.xml overview.xml 
	simple-canvas.xml 
Log Message:
2007-02-08  Damon Chaplin  <damon at gnome.org>

	* src/goocanvasitemmodel.c
	(goo_canvas_item_model_set_simple_transform): 
	* src/goocanvasitem.c (goo_canvas_item_set_simple_transform): new
	convenience functions to set the position, scale and rotation easily.

	* demo/demo.c (move_ellipse_clicked): added tests for
	goo_canvas_item_set_simple_transform().

	* */*: more documentation updates. I've started adding a few
	introductory sections, tidied up a few bits, and tried to update all
	the docs that referred to the old model/view terminology.



Index: Makefile.am
===================================================================
RCS file: /cvs/cairo/goocanvas/docs/Makefile.am,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- Makefile.am	9 Dec 2006 12:08:38 -0000	1.3
+++ Makefile.am	8 Feb 2007 22:56:45 -0000	1.4
@@ -53,14 +53,18 @@
 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
 HTML_IMAGES=
 
-# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
-# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
-content_files=
-
 # SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
 # These files must be listed here *and* in content_files
 # e.g. expand_content_files=running.sgml
-expand_content_files=
+expand_content_files=				\
+	overview.xml				\
+	simple-canvas.xml			\
+	model-view-canvas.xml			\
+	creating-items.xml
+
+# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
+# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
+content_files= $(expand_content_files)
 
 # CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
 # Only needed if you are using gtkdoc-scangobj to dynamically query widget

--- NEW FILE: creating-items.xml ---
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="goocanvas-creating-items">
  <refmeta>
    <refentrytitle>Creating New Items</refentrytitle>
    <manvolnum>3</manvolnum>
    <refmiscinfo>GOOCANVAS Library</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>Creating New Items</refname>
    <refpurpose>how to create new canvas items.</refpurpose>
  </refnamediv>

  <refsect1 id="new-items-overview">
    <title>How to Create New Canvas Items</title>
    <para>
      ... unfinished ...
    </para>
  </refsect1>
</refentry>

Index: goocanvas-docs.sgml
===================================================================
RCS file: /cvs/cairo/goocanvas/docs/goocanvas-docs.sgml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- goocanvas-docs.sgml	9 Dec 2006 12:08:38 -0000	1.6
+++ goocanvas-docs.sgml	8 Feb 2007 22:56:45 -0000	1.7
@@ -7,6 +7,14 @@
   </bookinfo>
 
   <chapter>
+    <title>Introduction</title>
+    <xi:include href="xml/overview.xml"/>
+    <xi:include href="xml/simple-canvas.xml"/>
+    <xi:include href="xml/model-view-canvas.xml"/>
+    <xi:include href="xml/creating-items.xml"/>
+  </chapter>
+
+  <chapter>
     <title>Core Objects</title>
     <xi:include href="xml/goocanvas.xml"/>
     <xi:include href="xml/goocanvasitem.xml"/>

--- NEW FILE: model-view-canvas.xml ---
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="goocanvas-model-view-canvas">
  <refmeta>
    <refentrytitle>The Model/View Canvas</refentrytitle>
    <manvolnum>3</manvolnum>
    <refmiscinfo>GOOCANVAS Library</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>The Model/View Canvas</refname>
    <refpurpose>how to create a model/view canvas.</refpurpose>
  </refnamediv>

  <refsect1 id="model-view-overview">
    <title>Model View Canvas Example</title>
    <para>
      ... unfinished ...
    </para>
  </refsect1>
</refentry>

--- NEW FILE: overview.xml ---
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="goocanvas-overview">
  <refmeta>
    <refentrytitle>Overview</refentrytitle>
    <manvolnum>3</manvolnum>
    <refmiscinfo>GOOCANVAS Library</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>Overview</refname>
    <refpurpose>a quick tour of GooCanvas.</refpurpose>
  </refnamediv>

  <refsect1 id="features">
    <title>Features</title>
    <itemizedlist>
    <listitem><para>
      Optional model/view split.
    </para></listitem><listitem><para>
      Uses interfaces for items and views.
    </para></listitem><listitem><para>
      Basic items - rect/ellipse/polyline/text/image/group.
    </para></listitem><listitem><para>
      Path item, using SVG path specification strings.
    </para></listitem><listitem><para>
      Table item for layout of other items (similar to the GtkTable widget).
    </para></listitem><listitem><para>
      Embedded GTK+ widgets.
    </para></listitem><listitem><para>
      Layers/stacking order with raise/lower functions.
    </para></listitem><listitem><para>
      Cascading styles - line width/style/dashes, colors, fill patterns.
    </para></listitem><listitem><para>
      Affine transformations for all items - rotations/scales/skews.
    </para></listitem><listitem><para>
      Event handling - button/motion events, "pointer-events" property like SVG.
    </para></listitem><listitem><para>
      Grabs - support for pointer and keyboard grabs.
    </para></listitem><listitem><para>
      Keyboard focus traversal.
    </para></listitem><listitem><para>
      Accessibility (item title and description properties and hierarchy stuff).
    </para></listitem><listitem><para>
      Printing (output to a given cairo_t).
    </para></listitem><listitem><para>
      Scrolling.
    </para></listitem><listitem><para>
      Zooming.
    </para></listitem><listitem><para>
      Item visibility setting - on/off/above zoom threshold.
    </para></listitem><listitem><para>
      Simple animation.
    </para></listitem><listitem><para>
      Scalable - support for thousands of items over a large canvas area.
    </para></listitem><listitem><para>
      Support for different units - pixels/points/inches/millimeters.
    </para></listitem>
    </itemizedlist>

  </refsect1>
</refentry>

--- NEW FILE: simple-canvas.xml ---
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="goocanvas-simple-canvas">
  <refmeta>
    <refentrytitle>The Simple Canvas</refentrytitle>
    <manvolnum>3</manvolnum>
    <refmiscinfo>GOOCANVAS Library</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>The Simple Canvas</refname>
    <refpurpose>how to create a simple canvas.</refpurpose>
  </refnamediv>

  <refsect1 id="simple-canvas-example">
    <title>Simple Canvas Example</title>
    <para>
      ... unfinished ...
    </para>
  </refsect1>
</refentry>



More information about the cairo-commit mailing list