From e114a359764df45123c570d879893ac6b0b6e610 Mon Sep 17 00:00:00 2001
From: Mathieu Virbel <mat@kivy.org>
Date: Sat, 30 Aug 2014 17:10:41 +0200
Subject: [PATCH] tesselator: added pictures for the documentation

---
 doc/sources/images/tesselator-debug.png  | Bin 0 -> 2202 bytes
 doc/sources/images/tesselator-filled.png | Bin 0 -> 554 bytes
 kivy/graphics/tesselator.pyx             |   9 +++++++--
 3 files changed, 7 insertions(+), 2 deletions(-)
 create mode 100644 doc/sources/images/tesselator-debug.png
 create mode 100644 doc/sources/images/tesselator-filled.png

diff --git a/doc/sources/images/tesselator-debug.png b/doc/sources/images/tesselator-debug.png
new file mode 100644
index 0000000000000000000000000000000000000000..305e2e44944bec26d1f72745d59e13b73042f42b
GIT binary patch
literal 2202
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

literal 0
HcmV?d00001

diff --git a/doc/sources/images/tesselator-filled.png b/doc/sources/images/tesselator-filled.png
new file mode 100644
index 0000000000000000000000000000000000000000..07dbd3d56bc1bfe9583566163f79b5b2012b1078
GIT binary patch
literal 554
zcmeAS@N?(olHy`uVBq!ia0vp^AAtBH2NRI2%3hlQq?n7HJVQ7*IBq}me*okPl(<He
z1m~xflqVLYG6ZLomXxFxB{yB*WME)C=IP=XQgQ3;6-TZE3Oufk!F&EstzVz8TA^j;
z-fk8C<3Q~wz+#cvef5nl=gK4PPuINZ^JD2<;CMkHL%^ho&9NEGWZ{J}Ii#RWK@%ub
z8K@4-bOUPvGI8lnJep$}8fy7=kxCsz4@@D46x14$Y@|##ZxhVD#M-@XhVF8&M_Zt7
uN9c$97mqgtw}^tm6De@8DMpTzhVyYgHe3_WJdhCs346NwxvX<aXaWFtA)`6~

literal 0
HcmV?d00001

diff --git a/kivy/graphics/tesselator.pyx b/kivy/graphics/tesselator.pyx
index cdc6810f7..c0a2d380b 100644
--- a/kivy/graphics/tesselator.pyx
+++ b/kivy/graphics/tesselator.pyx
@@ -4,6 +4,11 @@ Tesselator
 
 .. versionadded:: 1.9.1
 
+.. image:: images/tesselator-filled.png
+    :align: right
+.. image:: images/tesselator-debug.png
+    :align: right
+
 .. warning::
 
     This is experimental and subject to change as long as this warning notice
@@ -27,7 +32,7 @@ holes::
     tess.add_contour([50, 50, 150, 50, 150, 150, 50, 150])
 
 Second, call the :meth:`Tesselate.tesselate` method to compute the points. It is
-possible that the tesselator doesn't work, in that case, it can return False.
+possible that the tesselator doesn't work, in that case, it can return False::
 
     if not tess.tesselate():
         print "Tesselator didn't work :("
@@ -45,7 +50,7 @@ is using :data:`Tesselator.meshes` to get a format directly usable for
         ))
 
 Or, you can get the "raw" result, with just polygons and x/y coordinates with
-:meth:`Tesselator.vertices`:
+:meth:`Tesselator.vertices`::
 
     for vertices in tess.vertices:
         print "got polygon", vertices