gnome-devel-docs r634 - in trunk/gtk-drawing: . C C/figures

[davyd svn gnome org]

Author: davyd
Date: Thu Dec 18 13:28:29 2008
New Revision: 634
URL: http://svn.gnome.org/viewvc/gnome-devel-docs?rev=634&view=rev

Log:
2008-12-18  Davyd Madeley  <davyd fugro-fsi com au>

        * C/figures/fig.cairo.coordinates.1.svg:
        * C/cairo.xml:
        - begin a section on Cairo coordinates


Added:
   trunk/gtk-drawing/C/figures/
   trunk/gtk-drawing/C/figures/fig.cairo.coordinates.1.svg
Modified:
   trunk/gtk-drawing/C/cairo.xml
   trunk/gtk-drawing/ChangeLog

Modified: trunk/gtk-drawing/C/cairo.xml
==============================================================================
--- trunk/gtk-drawing/C/cairo.xml	(original)
+++ trunk/gtk-drawing/C/cairo.xml	Thu Dec 18 13:28:29 2008
@@ -18,6 +18,23 @@
   within GTK+ and how to optimise them. If you need a complete Cairo
   tutorial, see <ulink url="http://cairographics.org/documentation/"/>.
  </para>
+
+ <sect1 id="sect.cairo.coords">
+  <title>Cairo Coordinate System</title>
+
+  <para>
+   The Cairo coordinate system is not identical to the one presented in
+   GTK+. Coordinates in GTK+ are given in integer pixels from the top-left
+   corner; where the first pixel is 0, 0.
+  </para>
+  <para>
+   Cairo coordinates are given as double precision floating point numbers,
+   with the top-left corner (not pixel) is given the position 0.0, 0.0.
+   Coordinates are given in this space to enable Cairo to create the effect
+   of a higher resolution device via antialiasing, and to provide more
+   consistent output between different drawing backends.
+  </para>
+ </sect1>
   
  <sect1 id="sect.cairo.masks">
   <title>Speeding Up Drawing Using Masks</title>

Added: trunk/gtk-drawing/C/figures/fig.cairo.coordinates.1.svg
==============================================================================
--- (empty file)
+++ trunk/gtk-drawing/C/figures/fig.cairo.coordinates.1.svg	Thu Dec 18 13:28:29 2008
@@ -0,0 +1,125 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/";
+   xmlns:cc="http://creativecommons.org/ns#";
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#";
+   xmlns:svg="http://www.w3.org/2000/svg";
+   xmlns="http://www.w3.org/2000/svg";
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd";
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape";
+   width="500"
+   height="400"
+   id="svg2"
+   sodipodi:version="0.32"
+   inkscape:version="0.46"
+   version="1.0"
+   sodipodi:docname="fig.cairo.coordinates.1.svg"
+   inkscape:output_extension="org.inkscape.output.svg.inkscape">
+  <defs
+     id="defs4">
+    <inkscape:perspective
+       sodipodi:type="inkscape:persp3d"
+       inkscape:vp_x="0 : 526.18109 : 1"
+       inkscape:vp_y="0 : 1000 : 0"
+       inkscape:vp_z="744.09448 : 526.18109 : 1"
+       inkscape:persp3d-origin="372.04724 : 350.78739 : 1"
+       id="perspective10" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     gridtolerance="10000"
+     guidetolerance="10"
+     objecttolerance="10"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.156"
+     inkscape:cx="250"
+     inkscape:cy="200"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     inkscape:window-width="1024"
+     inkscape:window-height="697"
+     inkscape:window-x="0"
+     inkscape:window-y="25" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage"; />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <path
+       sodipodi:nodetypes="cc"
+       id="path3155"
+       d="M 100.5,50 L 100.5,350"
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 200.5,50 L 200.5,350"
+       id="path3157"
+       sodipodi:nodetypes="cc" />
+    <path
+       sodipodi:nodetypes="cc"
+       id="path3159"
+       d="M 150.5,50 L 150.5,350"
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 250.5,50 L 250.5,350"
+       id="path3161"
+       sodipodi:nodetypes="cc" />
+    <path
+       sodipodi:nodetypes="cc"
+       id="path3163"
+       d="M 300.5,50 L 300.5,350"
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 400.5,50 L 400.5,350"
+       id="path3165"
+       sodipodi:nodetypes="cc" />
+    <path
+       sodipodi:nodetypes="cc"
+       id="path3167"
+       d="M 450.5,50 L 450.5,350"
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+    <path
+       style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 350.5,50 L 350.5,350"
+       id="path3169"
+       sodipodi:nodetypes="cc" />
+    <text
+       xml:space="preserve"
+       style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;text-anchor:middle;fill:#cc0000;fill-opacity:1;stroke:none;stroke-width:1pt;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Sans;-inkscape-font-specification:Sans"
+       x="101.0293"
+       y="26.083046"
+       id="text3171"><tspan
+         sodipodi:role="line"
+         x="101.0293"
+         y="26.083046"
+         id="tspan3175">0.0</tspan></text>
+    <text
+       id="text3179"
+       y="26.083046"
+       x="150.75977"
+       style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:center;text-anchor:middle;fill:#cc0000;fill-opacity:1;stroke:none;stroke-width:1pt;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Sans;-inkscape-font-specification:Sans"
+       xml:space="preserve"><tspan
+         id="tspan3181"
+         y="26.083046"
+         x="150.75977"
+         sodipodi:role="line">0.0</tspan></text>
+  </g>
+</svg>