mirror of https://github.com/kivy/kivy.git
230 lines
12 KiB
ReStructuredText
230 lines
12 KiB
ReStructuredText
Examples
|
|
--------
|
|
|
|
.. container:: title
|
|
|
|
Follow through the examples.
|
|
|
|
.. |ani_dir| replace:: ./examples/animation
|
|
.. |ani_file| replace:: animate.py
|
|
.. |ani_desc| replace:: Widget animation using :class:`Animation <kivy.animation.Animation>` .
|
|
|
|
|
|
.. |app_dir| replace:: ./examples/application
|
|
.. |app_file1| replace:: app_with_build.py
|
|
.. |app_desc1| replace:: Application example using :py:meth:`~kivy.app.App.build`
|
|
.. |app_file2| replace:: app_with_kv.py
|
|
.. |app_desc2| replace:: Application from a **.kv**
|
|
.. |app_file3| replace:: app_with_kv_in_template1.py
|
|
.. |app_desc3| replace:: Application from a **kv_directory**
|
|
|
|
.. |aud_dir| replace:: ./examples/audio:
|
|
.. |aud_file| replace:: main.py
|
|
.. |aud_desc| replace:: How to Play **Audio**.
|
|
|
|
.. |can_dir| replace:: ./examples/canvas
|
|
.. |can_file1| replace:: bezier.py
|
|
.. |can_desc1| replace:: How to draw :class:`Bezier <kivy.graphics.Bezier>` Lines
|
|
.. |can_file2| replace:: canvas_stress.py
|
|
.. |can_desc2| replace:: Stress test :class:`Canvas <kivy.graphics.Canvas>`
|
|
.. |can_file3| replace:: mesh.py
|
|
.. |can_desc3| replace:: How to use :class:`Mesh <kivy.graphics.Mesh>` in kivy
|
|
.. |can_file4| replace:: multitexture.py
|
|
.. |can_desc4| replace:: How to handle **multiple textures with shader**
|
|
.. |can_file5| replace:: stencil_canvas.py
|
|
.. |can_desc5| replace:: How to use :class:`Stencil <kivy.uix.stencil>` on widget canvas
|
|
|
|
.. |dem_dir| replace:: ./examples/demo:
|
|
.. |dem_file| replace:: camera_puzzle.py
|
|
.. |dem_desc| replace:: A puzzle using :class:`Camera <kivy.uix.camera.Camera>` output
|
|
|
|
.. |pic_dir| replace:: ./examples/demo/pictures
|
|
.. |pic_file| replace:: main.py
|
|
.. |pic_desc| replace:: Highlights usage of :class:`Image <kivy.uix.image>` and :class:`Scatter <kivy.uix.scatter>` Widgets
|
|
|
|
.. |sed_dir| replace:: ./examples/demo/shadereditor
|
|
.. |sed_file| replace:: main.py
|
|
.. |sed_desc| replace:: How to use **fragment and vertex shaders**
|
|
|
|
.. |sho_dir| replace:: ../examples/demo/showcase
|
|
.. |sho_file| replace:: main.py
|
|
.. |sho_desc| replace:: Showcase of **widgets and layouts** used in kivy.
|
|
|
|
.. |tch_dir| replace:: ./examples/demo/touchtracer
|
|
.. |tch_file| replace:: main.py
|
|
.. |tch_desc| replace:: Draw lines under every detected touch.
|
|
.. |tch_desc2| replace:: A good place to understand **how touch events work in kivy**.
|
|
|
|
.. |tws_dir| replace:: ./examples/frameworks/twisted
|
|
.. |tws_file| replace:: echo_client_app.py
|
|
.. |tws_file2| replace:: echo_server_app.py
|
|
.. |tws_desc| replace:: A clent and server app using :doc:`Twisted inside Kivy </guide/other-frameworks>`
|
|
|
|
.. |gst_dir| replace:: ./examples/gestures
|
|
.. |gst_file| replace:: gesture_board.py
|
|
.. |gst_desc| replace:: A clean board to try out **gestures**.
|
|
|
|
.. |kv_dir| replace:: ./examples/guide/designwithkv
|
|
.. |kv_file| replace:: main.py
|
|
.. |kv_desc| replace:: Programming Guide examples on how to :doc:`design with kv lang </guide/designwithkv>`
|
|
|
|
.. |fwd_dir| replace:: ./examples/guide/firstwidget
|
|
.. |fwd_file| replace:: 1_skeleton.py
|
|
.. |fwd_file2| replace:: 2_print_touch.py
|
|
.. |fwd_file3| replace:: 3_draw_ellipse.py
|
|
.. |fwd_file4| replace:: 4_draw_line.py
|
|
.. |fwd_file5| replace:: 5_random_colors.py
|
|
.. |fwd_file6| replace:: 6_button.py
|
|
.. |fwd_desc| replace:: Programming Guide examples :doc:`Your first widget </guide/firstwidget>`
|
|
|
|
.. |qst_dir| replace:: ./examples/guide/quickstart
|
|
.. |qst_file| replace:: main.py
|
|
.. |qst_desc| replace:: Programming Guide :doc:`guide/quickstart </guide/quickstart>` example.
|
|
|
|
.. |kin_dir| replace:: ./examples/kinect
|
|
.. |kin_file| replace:: main.py
|
|
.. |kin_desc| replace:: Howto use **kinect** for input.
|
|
|
|
.. |kvd_dir| replace:: ./examples/kv
|
|
.. |kvd_file| replace:: kvrun.py
|
|
.. |kvd_desc| replace:: load kv files, use **kv lang to load different widgets**.
|
|
|
|
.. |rst_dir| replace:: ./examples/RST_Editor
|
|
.. |rst_file| replace:: main.py
|
|
.. |rst_desc| replace:: An RST editor for the :class:`RstDocument <kivy.uix.rst.RstDocument>` Widget.
|
|
|
|
.. |sdr_dir| replace:: ./examples/shader
|
|
.. |sdr_file| replace:: plasma.py
|
|
.. |sdr_file1| replace:: shadertree.py
|
|
.. |sdr_desc| replace:: How to use different **Shaders**.
|
|
|
|
.. |png_dir| replace:: ./examples/tutorials/pong
|
|
.. |png_file| replace:: main.py
|
|
.. |png_desc| replace:: :doc:`/tutorials/pong`. Your first step in kivy programming.
|
|
|
|
.. |wdg_dir| replace:: ./examples/widgets
|
|
.. |wdg_file1| replace:: accordion_1.py
|
|
.. |wdg_desc1| replace:: Usage and Showcase of :class:`Accordion <kivy.uix.accordion>` Widget.
|
|
.. |wdg_file2| replace:: asyncimage.py
|
|
.. |wdg_desc2| replace:: Usage and Showcase of :class:`AsyncImage <kivy.uix.image.AsyncImage>` Widget.
|
|
.. |wdg_file25| replace:: boxlayout_pos_hint.py
|
|
.. |wdg_desc25| replace:: Showcase of pos_hint under BoxLayout :class:`BoxLayout <kivy.uix.boxlayout>`
|
|
.. |wdg_file3| replace:: bubble_test.py
|
|
.. |wdg_desc3| replace:: Usage and Showcase of :class:`Bubble <kivy.uix.bubble>` Widget.
|
|
.. |wdg_file4| replace:: customcollide.py
|
|
.. |wdg_desc4| replace:: Test for **collision** with custom shaped widget
|
|
.. |wdg_file5| replace:: fbowidget.py
|
|
.. |wdg_desc5| replace:: Usage of :class:`FBO <kivy.graphics.fbo>` to speed up graphics.
|
|
.. |wdg_file6| replace:: image_mipmap.py
|
|
.. |wdg_desc6| replace:: How to use :class:`Image <kivy.uix.image>` widget with mipmap.
|
|
.. |wdg_file7| replace:: keyboardlistener.py
|
|
.. |wdg_desc7| replace:: listen to the keyboard input and spew result to console.
|
|
.. |wdg_file8| replace:: label_mipmap.py
|
|
.. |wdg_desc8| replace:: How to use :class:`Label <kivy.uix.label>` widget with
|
|
.. |wdg_file81| replace:: label_with_markup.py
|
|
.. |wdg_desc81| replace:: Useage of :class:`Label <kivy.uix.label>` widget with markup.
|
|
.. |wdg_file82| replace:: popup_with_kv.py
|
|
.. |wdg_desc82| replace:: Useage of :class:`Popup <kivy.uix.popup>` widget with ``kv`` language
|
|
.. |wdg_file9| replace:: rstexample.py
|
|
.. |wdg_desc9| replace:: Usage and Showcase of :class:`RstDocument <kivy.uix.rst.RstDocument>` Widget.
|
|
.. |wdg_file10| replace:: scatter.py
|
|
.. |wdg_desc10| replace:: Usage and Showcase of :class:`Scatter <kivy.uix.scatter>` Widget.
|
|
.. |wdg_file11| replace:: screenmanager.py
|
|
.. |wdg_desc11| replace:: Usage and showase of :mod:`ScreenManager <kivy.uix.screenmanager>` Module.
|
|
.. |wdg_file12| replace:: scrollview.py
|
|
.. |wdg_desc12| replace:: Usage and Showcase of :class:`ScrollView <kivy.uix.scrollview>` Widget.
|
|
.. |wdg_file14| replace:: spinner.py
|
|
.. |wdg_desc14| replace:: Usage and Showcase of :class:`Spinner <kivy.uix.spinner>` Widget.
|
|
.. |wdg_file15| replace:: tabbedpanel.py
|
|
.. |wdg_desc15| replace:: Usage of a simple :class:`TabbedPanel <kivy.uix.tabbedpanel.TabbedPanel>`
|
|
.. |wdg_file16| replace:: tabbed_panel_showcase.py
|
|
.. |wdg_desc16| replace:: Advanced Showcase of :class:`TabbedPanel <kivy.uix.tabbedpanel.TabbedPanel>`
|
|
.. |wdg_file17| replace:: textalign.py
|
|
.. |wdg_desc17| replace:: Usage of text alignment in :class:`Label <kivy.uix.label>` widget.
|
|
.. |wdg_file18| replace:: textinput.py
|
|
.. |wdg_desc18| replace:: Usage and Showcase of :class:`TextInput <kivy.uix.textinput>` Widget.
|
|
.. |wdg_file19| replace:: unicode_textinput.py
|
|
.. |wdg_desc19| replace:: Showcase of unicode text in :class:`TextInput <kivy.uix.textinput>` Widget.
|
|
.. |wdg_file20| replace:: videoplayer.py
|
|
.. |wdg_desc20| replace:: Usage and options of :class:`VideoPlayer <kivy.uix.videoplayer>` Widget.
|
|
.. |seq_dir| replace:: ./examples/widgets/sequenced_images:
|
|
.. |seq_file| replace:: main.py
|
|
.. |seq_desc| replace:: Showcase usage of **sequenced images**: gif, images in .zip.
|
|
|
|
+------------+---------------+------------------------+
|
|
| Directory | Filename/s | Example Description |
|
|
+============+===============+========================+
|
|
|- |ani_dir| | - |ani_file| |- |ani_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |app_dir| | - |app_file1| |- |app_desc1| |
|
|
| | - |app_file2| |- |app_desc2| |
|
|
| | - |app_file3| |- |app_desc3| |
|
|
+------------+---------------+------------------------+
|
|
|- |can_dir| | - |can_file1| |- |can_desc1| |
|
|
| | - |can_file2| |- |can_desc2| |
|
|
| | - |can_file3| |- |can_desc3| |
|
|
| | - |can_file4| |- |can_desc4| |
|
|
| | - |can_file5| |- |can_desc5| |
|
|
+------------+---------------+------------------------+
|
|
|- |dem_dir| | - |dem_file| |- |dem_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |pic_dir| | - |pic_file| |- |pic_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |sed_dir| | - |sed_file| |- |sed_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |sho_dir| | - |sho_file| |- |sho_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |tch_dir| | - |tch_file| |- |tch_desc| |
|
|
| | |- |tch_desc2| |
|
|
+------------+---------------+------------------------+
|
|
|- |tws_dir| | - |tws_file| |- |tws_desc| |
|
|
| | - |tws_file2| | |
|
|
+------------+---------------+------------------------+
|
|
|- |gst_dir| | - |gst_file| |- |gst_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |kv_dir| | - |kv_file| |- |kv_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |fwd_dir| | - |fwd_file| |- |fwd_desc| |
|
|
| | - |fwd_file2| | |
|
|
| | - |fwd_file3| | |
|
|
| | - |fwd_file4| | |
|
|
| | - |fwd_file5| | |
|
|
| | - |fwd_file6| | |
|
|
+------------+---------------+------------------------+
|
|
|- |qst_dir| | - |qst_file| |- |qst_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |kin_dir| | - |kin_file| |- |kin_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |kvd_dir| | - |kvd_file| |- |kvd_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |rst_dir| | - |rst_file| |- |rst_desc| |
|
|
+------------+---------------+------------------------+
|
|
|- |sdr_dir| | - |sdr_file| |- |sdr_desc| |
|
|
| | - |sdr_file1| | |
|
|
+------------+---------------+------------------------+
|
|
|- |wdg_dir| | - |wdg_file1| |- |wdg_desc1| |
|
|
| | - |wdg_file2| |- |wdg_desc2| |
|
|
| | - |wdg_file25||- |wdg_desc25| |
|
|
| | - |wdg_file3| |- |wdg_desc3| |
|
|
| | - |wdg_file4| |- |wdg_desc4| |
|
|
| | - |wdg_file5| |- |wdg_desc5| |
|
|
| | - |wdg_file6| |- |wdg_desc6| |
|
|
| | - |wdg_file7| |- |wdg_desc7| |
|
|
| | - |wdg_file8| |- |wdg_desc8| |
|
|
| | - |wdg_file81||- |wdg_desc81| |
|
|
| | - |wdg_file82||- |wdg_desc82| |
|
|
| | - |wdg_file9| |- |wdg_desc9| |
|
|
| | - |wdg_file10||- |wdg_desc10| |
|
|
| | - |wdg_file11||- |wdg_desc11| |
|
|
| | - |wdg_file12||- |wdg_desc12| |
|
|
| | - |wdg_file14||- |wdg_desc14| |
|
|
| | - |wdg_file15||- |wdg_desc15| |
|
|
| | - |wdg_file16||- |wdg_desc16| |
|
|
| | - |wdg_file17||- |wdg_desc17| |
|
|
| | - |wdg_file18||- |wdg_desc18| |
|
|
| | - |wdg_file19||- |wdg_desc19| |
|
|
| | - |wdg_file20||- |wdg_desc20| |
|
|
+------------+---------------+------------------------+
|
|
|- |seq_dir| | - |seq_file| |- |seq_desc| |
|
|
+------------+---------------+------------------------+
|