Kivy-examples 2.3.1.dev0__py3-none-any.whl

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/demo/multistroke/main.py

@@ -0,0 +1,144 @@
+'''
+Multistroke Recognition Database Demonstration
+==============================================
+
+This application records gestures and attempts to match them. You should
+see a black drawing surface with some buttons across the bottom. As you
+make a gesture on the drawing surface, the gesture will be added to
+the history and a match will be attempted. If you go to the history tab,
+name the gesture, and add it to the database, then similar gestures in the
+future will be recognized. You can load and save databases of gestures
+in .kg files.
+
+This demonstration code spans many files, with this being the primary file.
+The information pop-up ('No match') comes from the file helpers.py.
+The history pane is managed in the file historymanager.py and described
+in the file historymanager.kv. The database pane and storage is managed in
+the file gesturedatabase.py and the described in the file gesturedatabase.kv.
+The general logic of the sliders and buttons are in the file
+settings.py and described in settings.kv. but the actual settings pane is
+described in the file multistroke.kv and managed from this file.
+
+'''
+from kivy.app import App
+from kivy.uix.gridlayout import GridLayout
+from kivy.uix.gesturesurface import GestureSurface
+from kivy.uix.screenmanager import ScreenManager, Screen, SlideTransition
+from kivy.uix.label import Label
+from kivy.multistroke import Recognizer
+
+# Local libraries
+from historymanager import GestureHistoryManager
+from gesturedatabase import GestureDatabase
+from settings import MultistrokeSettingsContainer
+
+
+class MainMenu(GridLayout):
+    pass
+
+
+class MultistrokeAppSettings(MultistrokeSettingsContainer):
+    pass
+
+
+class MultistrokeApp(App):
+
+    def goto_database_screen(self, *l):
+        self.database.import_gdb()
+        self.manager.current = 'database'
+
+    def handle_gesture_cleanup(self, surface, g, *l):
+        if hasattr(g, '_result_label'):
+            surface.remove_widget(g._result_label)
+
+    def handle_gesture_discard(self, surface, g, *l):
+        # Don't bother creating Label if it's not going to be drawn
+        if surface.draw_timeout == 0:
+            return
+
+        text = '[b]Discarded:[/b] Not enough input'
+        g._result_label = Label(text=text, markup=True, size_hint=(None, None),
+                                center=(g.bbox['minx'], g.bbox['miny']))
+        self.surface.add_widget(g._result_label)
+
+    def handle_gesture_complete(self, surface, g, *l):
+        result = self.recognizer.recognize(g.get_vectors())
+        result._gesture_obj = g
+        result.bind(on_complete=self.handle_recognize_complete)
+
+    def handle_recognize_complete(self, result, *l):
+        self.history.add_recognizer_result(result)
+
+        # Don't bother creating Label if it's not going to be drawn
+        if self.surface.draw_timeout == 0:
+            return
+
+        best = result.best
+        if best['name'] is None:
+            text = '[b]No match[/b]'
+        else:
+            text = 'Name: [b]%s[/b]\nScore: [b]%f[/b]\nDistance: [b]%f[/b]' % (
+                   best['name'], best['score'], best['dist'])
+
+        g = result._gesture_obj
+        g._result_label = Label(text=text, markup=True, size_hint=(None, None),
+                                center=(g.bbox['minx'], g.bbox['miny']))
+        self.surface.add_widget(g._result_label)
+
+    def build(self):
+        # Setting NoTransition breaks the "history" screen! Possibly related
+        # to some inexplicable rendering bugs on my particular system
+        self.manager = ScreenManager(transition=SlideTransition(
+                                     duration=.15))
+        self.recognizer = Recognizer()
+
+        # Setup the GestureSurface and bindings to our Recognizer
+        surface = GestureSurface(line_width=2, draw_bbox=True,
+                                 use_random_color=True)
+        surface_screen = Screen(name='surface')
+        surface_screen.add_widget(surface)
+        self.manager.add_widget(surface_screen)
+
+        surface.bind(on_gesture_discard=self.handle_gesture_discard)
+        surface.bind(on_gesture_complete=self.handle_gesture_complete)
+        surface.bind(on_gesture_cleanup=self.handle_gesture_cleanup)
+        self.surface = surface
+
+        # History is the list of gestures drawn on the surface
+        history = GestureHistoryManager()
+        history_screen = Screen(name='history')
+        history_screen.add_widget(history)
+        self.history = history
+        self.manager.add_widget(history_screen)
+
+        # Database is the list of gesture templates in Recognizer
+        database = GestureDatabase(recognizer=self.recognizer)
+        database_screen = Screen(name='database')
+        database_screen.add_widget(database)
+        self.database = database
+        self.manager.add_widget(database_screen)
+
+        # Settings screen
+        app_settings = MultistrokeAppSettings()
+        ids = app_settings.ids
+
+        ids.max_strokes.bind(value=surface.setter('max_strokes'))
+        ids.temporal_win.bind(value=surface.setter('temporal_window'))
+        ids.timeout.bind(value=surface.setter('draw_timeout'))
+        ids.line_width.bind(value=surface.setter('line_width'))
+        ids.draw_bbox.bind(value=surface.setter('draw_bbox'))
+        ids.use_random_color.bind(value=surface.setter('use_random_color'))
+
+        settings_screen = Screen(name='settings')
+        settings_screen.add_widget(app_settings)
+        self.manager.add_widget(settings_screen)
+
+        # Wrap in a gridlayout so the main menu is always visible
+        layout = GridLayout(cols=1)
+        layout.add_widget(self.manager)
+        layout.add_widget(MainMenu())
+        return layout
+
+
+if __name__ in ('__main__', '__android__'):
+    MultistrokeApp().run()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/demo/multistroke/multistroke.kv

@@ -0,0 +1,101 @@
+<MainMenu>:
+    rows: 1
+    size_hint: (1, None)
+    height: 50
+    spacing: 5
+    padding: 5
+    ToggleButton:
+        group: 'mainmenu'
+        state: 'down'
+        text: 'Gesture Surface'
+        on_press:
+            app.manager.current = 'surface'
+            if self.state == 'normal': self.state = 'down'
+    ToggleButton:
+        group: 'mainmenu'
+        text: 'History'
+        on_press:
+            app.manager.current = 'history'
+            if self.state == 'normal': self.state = 'down'
+    ToggleButton:
+        group: 'mainmenu'
+        text: 'Database'
+        on_press:
+            app.goto_database_screen()
+            if self.state == 'normal': self.state = 'down'
+    ToggleButton:
+        group: 'mainmenu'
+        text: 'Settings'
+        on_press:
+            app.manager.current = 'settings'
+            if self.state == 'normal': self.state = 'down'
+
+<MultistrokeAppSettings>:
+    pos_hint: {'top': 1}
+
+    MultistrokeSettingTitle:
+        title: 'GestureSurface behavior'
+        desc: 'Affects how gestures are detected and cleaned up'
+
+    MultistrokeSettingSlider:
+        id: max_strokes
+        title: 'Max strokes'
+        type: 'int'
+        desc: 
+            ('Max number of strokes for a single gesture. If 0, the ' +
+            'gesture will only be analyzed once the temporal window has ' +
+            'expired since the last strokes touch up event')
+        value: 4
+        min: 0
+        max: 15
+
+    MultistrokeSettingSlider:
+        id: temporal_win
+        title: 'Temporal Window'
+        type: 'float'
+        desc: 
+            ('Time to wait from last touch up in a gesture before analyzing ' +
+            'the input. If 0, only analyzed once Max Strokes is reached')
+        value: 2.
+        min: 0
+        max: 60.
+
+    MultistrokeSettingTitle:
+        title: 'Drawing'
+        desc: 'Affects how gestures are visualized on the GestureSurface'
+
+    MultistrokeSettingSlider:
+        id: timeout
+        title: 'Draw Timeout'
+        type: 'float'
+        desc: 
+            ('How long to display the gesture (and result label) on the ' +
+            'gesture surface once analysis has completed')
+        value: 2.
+        min: 0
+        max: 60.
+
+    MultistrokeSettingSlider:
+        id: line_width
+        title: 'Line width'
+        type: 'int'
+        desc: 
+            ('Width of lines on the gesture surface; 0 does not draw ' +
+            'anything; 1 uses OpenGL line, >1 uses custom drawing method.')
+        value: 2
+        min: 0
+        max: 10
+
+    MultistrokeSettingBoolean:
+        id: use_random_color
+        title: 'Use random color?'
+        desc: 'Use random color for each gesture? If disabled, white is used.'
+        button_text: 'Random color?'
+        value: True
+
+    MultistrokeSettingBoolean:
+        id: draw_bbox
+        title: 'Draw gesture bounding box?'
+        desc: 'Enable to draw a bounding box around the gesture'
+        button_text: 'Draw bbox?'
+        value: True

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/demo/multistroke/settings.kv

@@ -0,0 +1,110 @@
+<MultistrokeSettingsContainer>:
+    cols: 1
+    spacing: 5
+    padding: 5
+    size_hint_y: None
+    height: self.minimum_height
+
+<MultistrokeSettingItem>:
+    size_hint_y: None
+    height: 70
+    rows: 1
+    canvas:
+        Color:
+            rgba: 47 / 255., 167 / 255., 212 / 255., .1
+        Rectangle:
+            pos: self.x, self.y + 1
+            size: self.size
+        Color:
+            rgb: .2, .2, .2
+        Rectangle:
+            pos: self.x, self.y - 2
+            size: self.width, 1
+    Label:
+        size_hint_x: .6
+        id: labellayout
+        markup: True
+        text: u'{0}\n[size=13sp][color=999999]{1}[/color][/size]'.format(root.title or '', root.desc or '')
+        font_size: '15sp'
+        text_size: self.size
+        valign: 'top'
+
+<MultistrokeSettingTitle>:
+    size_hint_y: None
+    height: 40
+    markup: True
+    text: u'{0}\n[size=13sp][color=999999]{1}[/color][/size]'.format(root.title or '', root.desc or '')
+    font_size: '15sp'
+    text_size: self.size
+    valign: 'top'
+    halign: 'right'
+    canvas:
+        Color:
+            rgba: 47 / 255., 167 / 255., 212 / 255., .4
+        Rectangle:
+            pos: self.x, self.y + 1
+            size: self.size
+        Color:
+            rgb: .5, .5, .5
+        Rectangle:
+            pos: self.x, self.y - 2
+            size: self.width, 1
+
+<MultistrokeSettingBoolean>:
+    value: button.state == 'down' and True or False
+    ToggleButton:
+        id: button
+        text: root.button_text
+        size_hint_x: None
+        width: 150
+        pos: root.pos
+        state: root.value and 'down' or 'normal'
+
+<MultistrokeSettingString>:
+    value: input.text
+    AnchorLayout:
+        size_hint_x: None
+        width: 150
+        TextInput:
+            id: input
+            size_hint_y: None
+            height: 30
+            pos: root.pos
+            multiline: True
+            text: root.value
+
+<MultistrokeSettingSlider>:
+    value: slider.value
+    Label:
+        id: sliderlabel
+        size_hint_x: None
+        width: 50
+        text: str(root._to_numtype(slider.value))
+    Slider:
+        id: slider
+        min: root.min
+        max: root.max
+        pos: root.pos
+        size_hint_x: None
+        width: 150
+        value: root.value
+
+<EditSettingPopup>:
+    size_hint: None, None
+    size: 300, 150
+    title: 'Edit setting'
+    BoxLayout:
+        orientation: 'vertical'
+        TextInput:
+            id: input
+            markup: False
+            multiline: False
+            on_text_validate: root.dispatch('on_validate', self.text)
+        BoxLayout:
+            orientation: 'horizontal'
+            Button:
+                text: 'OK'
+                on_press: root.dispatch('on_validate', input.text)
+            Button:
+                text: 'Cancel'
+                on_press: root.dismiss()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/demo/multistroke/settings.py

@@ -0,0 +1,97 @@
+__all__ = ('MultistrokeSettingsContainer', 'MultistrokeSettingItem',
+           'MultistrokeSettingBoolean', 'MultistrokeSettingSlider',
+           'MultistrokeSettingString', 'MultistrokeSettingTitle')
+
+from kivy.factory import Factory
+from kivy.lang import Builder
+from kivy.uix.gridlayout import GridLayout
+from kivy.uix.label import Label
+from kivy.properties import (StringProperty, NumericProperty, OptionProperty,
+                             BooleanProperty)
+from kivy.uix.popup import Popup
+
+Builder.load_file('settings.kv')
+
+
+class MultistrokeSettingsContainer(GridLayout):
+    pass
+
+
+class MultistrokeSettingItem(GridLayout):
+    title = StringProperty('<No title set>')
+    desc = StringProperty('')
+
+
+class MultistrokeSettingTitle(Label):
+    title = StringProperty('<No title set>')
+    desc = StringProperty('')
+
+
+class MultistrokeSettingBoolean(MultistrokeSettingItem):
+    button_text = StringProperty('')
+    value = BooleanProperty(False)
+
+
+class MultistrokeSettingString(MultistrokeSettingItem):
+    value = StringProperty('')
+
+
+class EditSettingPopup(Popup):
+    def __init__(self, **kwargs):
+        super(EditSettingPopup, self).__init__(**kwargs)
+        self.register_event_type('on_validate')
+
+    def on_validate(self, *l):
+        pass
+
+
+class MultistrokeSettingSlider(MultistrokeSettingItem):
+    min = NumericProperty(0)
+    max = NumericProperty(100)
+    type = OptionProperty('int', options=['float', 'int'])
+    value = NumericProperty(0)
+
+    def __init__(self, **kwargs):
+        super(MultistrokeSettingSlider, self).__init__(**kwargs)
+        self._popup = EditSettingPopup()
+        self._popup.bind(on_validate=self._validate)
+        self._popup.bind(on_dismiss=self._dismiss)
+
+    def _to_numtype(self, v):
+        try:
+            if self.type == 'float':
+                return round(float(v), 1)
+            else:
+                return int(v)
+        except ValueError:
+            return self.min
+
+    def _dismiss(self, *l):
+        self._popup.ids.input.focus = False
+
+    def _validate(self, instance, value):
+        self._popup.dismiss()
+        val = self._to_numtype(self._popup.ids.input.text)
+        if val < self.min:
+            val = self.min
+        elif val > self.max:
+            val = self.max
+        self.value = val
+
+    def on_touch_down(self, touch):
+        if not self.ids.sliderlabel.collide_point(*touch.pos):
+            return super(MultistrokeSettingSlider, self).on_touch_down(touch)
+        ids = self._popup.ids
+        ids.value = str(self.value)
+        ids.input.text = str(self._to_numtype(self.value))
+        self._popup.open()
+        ids.input.focus = True
+        ids.input.select_all()
+
+
+Factory.register('MultistrokeSettingsContainer',
+                 cls=MultistrokeSettingsContainer)
+Factory.register('MultistrokeSettingTitle', cls=MultistrokeSettingTitle)
+Factory.register('MultistrokeSettingBoolean', cls=MultistrokeSettingBoolean)
+Factory.register('MultistrokeSettingSlider', cls=MultistrokeSettingSlider)
+Factory.register('MultistrokeSettingString', cls=MultistrokeSettingString)

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/demo/pictures/android.txt

@@ -0,0 +1,3 @@
+title=Pictures
+author=Kivy team
+orientation=landscape

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/demo/pictures/main.py

@@ -0,0 +1,73 @@
+'''
+Basic Picture Viewer
+====================
+
+This simple image browser demonstrates the scatter widget. You should
+see three framed photographs on a background. You can click and drag
+the photos around, or multi-touch to drop a red dot to scale and rotate the
+photos.
+
+The photos are loaded from the local images directory, while the background
+picture is from the data shipped with kivy in kivy/data/images/background.jpg.
+The file pictures.kv describes the interface and the file shadow32.png is
+the border to make the images look like framed photographs. Finally,
+the file android.txt is used to package the application for use with the
+Kivy Launcher Android application.
+
+For Android devices, you can copy/paste this directory into
+/sdcard/kivy/pictures on your Android device.
+
+The images in the image directory are from the Internet Archive,
+`https://archive.org/details/PublicDomainImages`, and are in the public
+domain.
+
+'''
+
+import kivy
+kivy.require('1.0.6')
+
+from glob import glob
+from random import randint
+from os.path import join, dirname
+from kivy.app import App
+from kivy.logger import Logger
+from kivy.uix.scatter import Scatter
+from kivy.properties import StringProperty
+
+
+class Picture(Scatter):
+    '''Picture is the class that will show the image with a white border and a
+    shadow. They are nothing here because almost everything is inside the
+    picture.kv. Check the rule named <Picture> inside the file, and you'll see
+    how the Picture() is really constructed and used.
+
+    The source property will be the filename to show.
+    '''
+
+    source = StringProperty(None)
+
+
+class PicturesApp(App):
+
+    def build(self):
+
+        # the root is created in pictures.kv
+        root = self.root
+
+        # get any files into images directory
+        curdir = dirname(__file__)
+        for filename in glob(join(curdir, 'images', '*')):
+            try:
+                # load the image
+                picture = Picture(source=filename, rotation=randint(-30, 30))
+                # add to the main field
+                root.add_widget(picture)
+            except Exception as e:
+                Logger.exception('Pictures: Unable to load <%s>' % filename)
+
+    def on_pause(self):
+        return True
+
+
+if __name__ == '__main__':
+    PicturesApp().run()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/demo/pictures/pictures.kv

@@ -0,0 +1,57 @@
+#:kivy 1.0
+#:import kivy kivy
+#:import win kivy.core.window
+
+FloatLayout:
+    canvas:
+        Color:
+            rgb: 1, 1, 1
+        Rectangle:
+            source: 'data/images/background.jpg'
+            size: self.size
+
+    BoxLayout:
+        padding: 10
+        spacing: 10
+        size_hint: 1, None
+        pos_hint: {'top': 1}
+        height: 44
+        Image:
+            size_hint: None, None
+            size: 24, 24
+            source: 'data/logo/kivy-icon-24.png'
+        Label:
+            height: 24
+            text_size: self.width, None
+            color: (1, 1, 1, .8)
+            text: 'Kivy %s - Pictures' % kivy.__version__
+
+
+
+<Picture>:
+    # each time a picture is created, the image can delay the loading
+    # as soon as the image is loaded, ensure that the center is changed
+    # to the center of the screen.
+    on_size: self.center = win.Window.center
+    size: image.size
+    size_hint: None, None
+
+    Image:
+        id: image
+        source: root.source
+
+        # create initial image to be 400 pixels width
+        size: 400, 400 / self.image_ratio
+
+        # add shadow background
+        canvas.before:
+            Color:
+                rgba: 1,1,1,1
+            BorderImage:
+                source: 'shadow32.png'
+                border: (36,36,36,36)
+                size:(self.width+72, self.height+72)
+                pos: (-36,-36)
+
+
+