Rooba
/
kivy
mirror of https://github.com/kivy/kivy.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1172 from Zen-CODE/Doc_English_Improvements_36 

doc: gettingstarted/framework.rst
This commit is contained in:
qua-non 2013-05-05 13:27:07 -07:00
parent a778235d15 5ce90953d4
commit 31985c625a
1 changed files with 21 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/sources/gettingstarted/framework.rst
View File

@ -3,21 +3,36 @@ Non-widget stuff
.. |animation_img| image:: ../images/gs-animation.gif
.. |animation_text| replace:: :class:`Animation <kivy.animation.Animation>` is used to change a Widget's properties (size/pos/center...), to a target value, in a target time.
Various :class:`transition <kivy.animation.AnimationTransition>` functions are provided.
Using them, you can animate widgets and build very smooth UI behaviours.
.. |animation_text| replace:: :class:`Animation <kivy.animation.Animation>` is
used to change a widget's properties (size/pos/center etc.) to a target
value within a target time.
Various :class:`transition <kivy.animation.AnimationTransition>` functions
are provided. You can use them to animate widgets and build very smooth UI
behaviours.
.. |atlas_img| image:: ../images/gs-atlas.png
.. |atlas_text| replace:: :class:`Atlas <kivy.atlas.Atlas>` is a class for managing texture maps, i.e. packing multiple textures into one image. Using it allows you to reduce the number of images to load and speed up the application start.
.. |atlas_text| replace:: :class:`Atlas <kivy.atlas.Atlas>` is a class for
managing texture maps i.e. packing multiple textures into one image.
This allows you to reduce the number of images loaded and thus speed up the
application start.
.. |clock_text| replace:: :class:`Clock <kivy.clock.Clock>` provides you with a convenient way to do jobs at set time intervals and is preferred over *sleep()* which would block the kivy Event Loop. These intervals can be set relative to the OpenGL Drawing instructions, :ref:`before <schedule-before-frame>` or :ref:`after <schedule-before-frame>` frame. Clock also provides you with a way to create :ref:`triggered events <triggered-events>` that are grouped together and only called once before the next frame.
.. |clock_text| replace:: :class:`Clock <kivy.clock.Clock>` provides you with a
convenient way to schecdule jobs at set time intervals and is preferred
over *sleep()*, which would block the kivy event loop. These intervals can
be set relative to the OpenGL drawing instructions,
:ref:`before <schedule-before-frame>` or
:ref:`after <schedule-before-frame>`. The Clock also provides you with a way
to create :ref:`triggered events <triggered-events>` that are grouped
together and called only once before the next frame.
.. |sched_once| replace:: :meth:`~kivy.clock.ClockBase.schedule_once`
.. |sched_intrvl| replace:: :meth:`~kivy.clock.ClockBase.schedule_interval`
.. |unsched| replace:: :meth:`~kivy.clock.ClockBase.unschedule`
.. |trigger| replace:: :meth:`~kivy.clock.ClockBase.create_trigger`
.. |urlreq| replace:: :class:`UrlRequest <kivy.network.urlrequest.UrlRequest>` is useful to do asynchronous requests without blocking the event loop, and manage the result and progress with callbacks.
.. |urlreq| replace:: :class:`UrlRequest <kivy.network.urlrequest.UrlRequest>`
is useful for asynchronous requests that do not block the event loop, and
manage the result and progress with callbacks.
+------------------+------------------+
| |animation_text| | |animation_img||