summaryrefslogtreecommitdiff
path: root/doc/tutorial
diff options
context:
space:
mode:
authorCarl Worth <cworth@cworth.org>2006-01-25 14:31:17 +0000
committerCarl Worth <cworth@cworth.org>2006-01-25 14:31:17 +0000
commit2d2c5fd5b003d681b57380a5d11ffc4dd3903b35 (patch)
tree3f17e3752bcb5f2303723a8e5c2d83048be9bcf4 /doc/tutorial
parentdc64fcc68ccbe92392a88167e83cc5994f69cf66 (diff)
Shrink the font size to make the tutorial instructions fit.
Format text to solve all problematic line wrapping. Add my name to the README.
Diffstat (limited to 'doc/tutorial')
-rw-r--r--doc/tutorial/slides/cairo-blank.svg2
-rw-r--r--doc/tutorial/slides/tutorial.xml89
-rw-r--r--doc/tutorial/src/README4
3 files changed, 48 insertions, 47 deletions
diff --git a/doc/tutorial/slides/cairo-blank.svg b/doc/tutorial/slides/cairo-blank.svg
index b2f3f829d..6fca5fa86 100644
--- a/doc/tutorial/slides/cairo-blank.svg
+++ b/doc/tutorial/slides/cairo-blank.svg
@@ -476,7 +476,7 @@
<!-- Slide content -->
<g ss:region="default">
<rect x="112" y="200" width="800" height="480" fill="none" stroke="blue"/>
- <text font-size="40" fill="black"
+ <text font-size="35" fill="black"
x="112" y="232">Slide content</text>
</g>
diff --git a/doc/tutorial/slides/tutorial.xml b/doc/tutorial/slides/tutorial.xml
index 00fa4c911..eae9360f1 100644
--- a/doc/tutorial/slides/tutorial.xml
+++ b/doc/tutorial/slides/tutorial.xml
@@ -15,10 +15,11 @@
<lc></lc>
<lc align="center">http://cairographics.org/tutorial</lc>
<lc></lc>
- <li>wget http://cairographics.org/tutorial.tar.gz</li>
- <li>tar xzf tutorial.tar.gz</li>
- <li>cd tutorial</li>
+ <li>wget http://cairographics.org/cairo-tutorial.tar.gz</li>
+ <li>tar xzf cairo-tutorial.tar.gz</li>
+ <li>cd cairo-tutorial</li>
<li>make</li>
+ <li>cat README</li>
<lc></lc>
<lc align="center">IRC: irc.freenode.net #cairo</lc>
</slide>
@@ -199,12 +200,11 @@
<slide title="Following along" >
<lc></lc>
<lc align="center">http://cairographics.org/tutorial</lc>
- <lc></lc>
- <li>wget http://cairographics.org/tutorial.tar.gz</li>
- <li>tar xzf tutorial.tar.gz</li>
- <li>cd tutorial</li>
+ <lc align="center">http://cairographics.org/cairo-tutorial.tar.gz</lc>
+ <li>tar xzf cairo-tutorial.tar.gz</li>
+ <li>cd cairo-tutorial</li>
<li>make</li>
- <lc></lc>
+ <li>cat README</li>
<lc align="center">IRC: irc.freenode.net #cairo</lc>
</slide>
@@ -296,11 +296,10 @@
<slide title="cairo_stroke example">
</slide>
- <slide title="cairo_set_line_width example">
+ <slide title="cairo_set_line_width">
</slide>
<slide title="cairo_set_line_cap example">
- <li>cairo_set_line_cap</li>
<ul>
<li>CAIRO_LINE_CAP_BUTT</li>
<li>CAIRO_LINE_CAP_ROUND</li>
@@ -309,7 +308,6 @@
</slide>
<slide title="cairo_set_line_join example">
- <li>cairo_set_line_join</li>
<ul>
<li>CAIRO_LINE_JOIN_BEVEL</li>
<li>CAIRO_LINE_JOIN_ROUND</li>
@@ -318,24 +316,23 @@
</slide>
<slide title="cairo_close_path example">
- <li>cairo_close_path</li>
- <li>Adds a line segment (if necessary) to the start of the path</li>
- <li>Draws a join from that line to the first element of the path</li>
+ <li>Adds a line segment (if necessary) to the</li>
+ <lc>start of the path</lc>
+ <li>Draws a join from that line to the first</li>
+ <lc>element of the path</lc>
</slide>
<slide title="cairo_set_dash example">
</slide>
- <slide title="Filling paths">
+ <slide title="cairo_fill">
<ul>
- <li>cairo_fill</li>
+ <li>Paints the “inside” of the path</li>
+ <li>Two different ways to determine inside-ness</li>
<ul>
- <li>Paints the “inside” of the path</li>
- <li>Two different ways to determine inside-ness</li>
- <ul>
- <li>cairo_set_fill_rule (CAIRO_FILL_RULE_WINDING)</li>
- <li>cairo_set_fill_rule (CAIRO_FILL_RULE_EVEN_ODD)</li>
- </ul>
+ <li>cairo_set_fill_rule:</li>
+ <lc> CAIRO_FILL_RULE_WINDING</lc>
+ <lc> CAIRO_FILL_RULE_EVEN_ODD</lc>
</ul>
</ul>
</slide>
@@ -343,23 +340,22 @@
<slide title="cairo_fill example">
</slide>
- <slide title="Fill rules">
- <li>To test a point for inside-ness, imagine a ray from the point</li>
- <lc>and extending to infinity (any direction) and examine path crossings</lc>
+ <slide title="cairo_set_fill_rule">
+ <li>To test a point for inside-ness, imagine a ray</li>
+ <lc>from the point and extending to infinity</lc>
+ <lc>(any direction) and examine path crossings</lc>
<li>EVEN_ODD counts crossings and fills when odd</li>
- <li>WINDING counts up/down for leftward/rightward crossings</li>
+ <li>WINDING counts up/down for left/right crossings</li>
<lc>and fills when the final number is not zero</lc>
</slide>
<slide title="Fill rule example">
</slide>
- <slide title="Fill rule example">
- </slide>
-
<slide title="Something besides black?">
<li>All drawing occurs with the source pattern</li>
- <li>Uniform-color sources can be set with/without alpha:</li>
+ <li>Uniform-color sources can be set</li>
+ <lc>with or without alpha:</lc>
<ul>
<li>cairo_set_source_rgb</li>
<li>cairo_set_source_rgba</li>
@@ -409,7 +405,8 @@
<slide title="Affine Transformations">
<ul>
- <li>Single matrix combines rotation, translation, scale and shear</li>
+ <li>Single matrix combines rotation, translation,</li>
+ <lc>scale and shear</lc>
<li>Non-projective transformations</li>
<ul>
<li>Pen doesn't change shape along the stroke</li>
@@ -425,20 +422,23 @@
</slide>
<slide title="Save/Restore Graphics States">
- <li>cairo_save and cairo_restore</li>
- <li>Very useful for bracketing function bodies</li>
- <li>Eliminates graphics state side effects</li>
- <lc></lc>
- <li>NOTE: Path is not part of graphics state</li>
<ul>
- <li>Path is not affected by cairo_save/restore</li>
- <li>Useful for path-generating functions</li>
+ <li>cairo_save and cairo_restore</li>
+ <li>Very useful for bracketing function bodies</li>
+ <li>Eliminates graphics state side effects</li>
+ <lc></lc>
+ <li>NOTE: Path is not part of graphics state</li>
+ <ul>
+ <li>Path is not affected by cairo_save/restore</li>
+ <li>Useful for path-generating functions</li>
+ </ul>
</ul>
</slide>
<slide title="Clipping">
<li>cairo_clip</li>
- <li>Intersects path with current clip to further restrict drawing</li>
+ <li>Intersects path with current clip to further</li>
+ <lc>restrict drawing</lc>
<li>Pixel-aligned clipping is much faster</li>
<li>cairo_clip_preserve is available as well</li>
</slide>
@@ -480,14 +480,14 @@
<ul>
<li>“Toy” API:</li>
<ul>
- <li>Useful for demos like we are writing today.</li>
- <li>No real layout—not useful for the majority of writing</li>
- <lc>systems in the world.</lc>
+ <li>Useful for demos like we are writing today</li>
+ <li>No real layout—not useful for the majority</li>
+ <lc>of writing systems in the world</lc>
</ul>
<li>“Full” API:</li>
<ul>
<li>User must do OS-dependent font selection</li>
- <li>User must map access font glyph IDs directly</li>
+ <li>User must access font glyph IDs directly</li>
<li>User must do all text layout</li>
</ul>
</ul>
@@ -522,7 +522,8 @@
<slide title="Cairo error handling">
<li>Cairo stores status value when error occurs</li>
<li>API “shuts down” when an error occurs</li>
- <li>All cairo functions are benign (and well defined) after any error.</li>
+ <li>All cairo functions are benign</li>
+ <lc>(and well defined) after any error.</lc>
<li>cairo_status can be called when convenient</li>
<li>Error status values propagate across objects</li>
</slide>
diff --git a/doc/tutorial/src/README b/doc/tutorial/src/README
index 5e19e39c2..a2738da4e 100644
--- a/doc/tutorial/src/README
+++ b/doc/tutorial/src/README
@@ -61,6 +61,6 @@ that are compiled, you may edit the "all" target in the Makefile.
Have fun!
+-Carl Worth
-
-
+cworth@redhat.com