From b6a59828e209f0049971f7f62fd59696c9b3ee39 Mon Sep 17 00:00:00 2001 From: Zen-CODE Date: Mon, 10 Mar 2014 23:39:26 +0200 Subject: [PATCH] doc: revisions to doc/sources/gettingstarted/drawing.rst --- doc/sources/gettingstarted/drawing.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/sources/gettingstarted/drawing.rst b/doc/sources/gettingstarted/drawing.rst index 080a98707..d843a7c7f 100644 --- a/doc/sources/gettingstarted/drawing.rst +++ b/doc/sources/gettingstarted/drawing.rst @@ -2,11 +2,12 @@ Drawing ------- Each widget has a canvas, i.e. a place to draw on. The canvas is a group of -instructions that should be executed whenever there is a change to the widget's -graphical representation. +drawing instructions that should be executed whenever there is a change to the +widget's graphical representation. + You can add two types of instructions to the canvas: *context* instructions and -*vertex* instructions. You can add instructions either from Python or from the -kv file (the preferred way). +*vertex* instructions. You can add instructions either from Python code or from +the kv file (the preferred way). If you add them via the kv file, the advantage is that they are automatically updated when any property they depend on changes. In Python, you need to do this yourself. @@ -17,7 +18,7 @@ In both cases, the canvas of `MyWidget` is re-drawn whenever the ``position`` or the ``size`` of the widget changes. You can use **canvas.before** or **canvas.after**. This allows you to separate -your instructions based on when you want them to happen. +your instructions based on when you want them to be executed. For an in-depth look at how Kivy's graphics are handled, look :mod:`here `.