libervia-desktop-kivy: cagou/backport/carousel.py annotate

annotate cagou/backport/carousel.py @ 439:12d188cb1206

core: use of new profileConnected method: bookmarks cache is now retrieved in profileConnected, as getting it in ProfilePlugged could result in an exception is client was not fully connected (if plugins were not all initialised).

author	Goffi <goffi@goffi.org>
date	Sat, 07 Mar 2020 00:05:49 +0100
parents	5bd583d00594
children

rev	line source
323 5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	1 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	2 Carousel
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	3 ========
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	4
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	5 .. image:: images/carousel.gif
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	6 :align: right
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	7
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	8 .. versionadded:: 1.4.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	9
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	10 The :class:`Carousel` widget provides the classic mobile-friendly carousel view
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	11 where you can swipe between slides.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	12 You can add any content to the carousel and have it move horizontally or
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	13 vertically. The carousel can display pages in a sequence or a loop.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	14
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	15 Example::
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	16
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	17 from kivy.app import App
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	18 from kivy.uix.carousel import Carousel
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	19 from kivy.uix.image import AsyncImage
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	20
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	21
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	22 class CarouselApp(App):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	23 def build(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	24 carousel = Carousel(direction='right')
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	25 for i in range(10):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	26 src = "http://placehold.it/480x270.png&text=slide-%d&.png" % i
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	27 image = AsyncImage(source=src, allow_stretch=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	28 carousel.add_widget(image)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	29 return carousel
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	30
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	31
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	32 CarouselApp().run()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	33
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	34
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	35 Kv Example::
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	36
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	37 Carousel:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	38 direction: 'right'
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	39 AsyncImage:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	40 source: 'http://placehold.it/480x270.png&text=slide-1.png'
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	41 AsyncImage:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	42 source: 'http://placehold.it/480x270.png&text=slide-2.png'
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	43 AsyncImage:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	44 source: 'http://placehold.it/480x270.png&text=slide-3.png'
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	45 AsyncImage:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	46 source: 'http://placehold.it/480x270.png&text=slide-4.png'
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	47
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	48
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	49 .. versionchanged:: 1.5.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	50 The carousel now supports active children, like the
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	51 :class:`~kivy.uix.scrollview.ScrollView`. It will detect a swipe gesture
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	52 according to the :attr:`Carousel.scroll_timeout` and
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	53 :attr:`Carousel.scroll_distance` properties.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	54
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	55 In addition, the slide container is no longer exposed by the API.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	56 The impacted properties are
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	57 :attr:`Carousel.slides`, :attr:`Carousel.current_slide`,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	58 :attr:`Carousel.previous_slide` and :attr:`Carousel.next_slide`.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	59
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	60 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	61
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	62 __all__ = ('Carousel', )
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	63
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	64 from functools import partial
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	65 from kivy.clock import Clock
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	66 from kivy.factory import Factory
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	67 from kivy.animation import Animation
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	68 from kivy.uix.stencilview import StencilView
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	69 from kivy.uix.relativelayout import RelativeLayout
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	70 from kivy.properties import BooleanProperty, OptionProperty, AliasProperty, \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	71 NumericProperty, ListProperty, ObjectProperty, StringProperty
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	72
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	73
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	74 class Carousel(StencilView):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	75 '''Carousel class. See module documentation for more information.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	76 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	77
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	78 slides = ListProperty([])
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	79 '''List of slides inside the Carousel. The slides are the
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	80 widgets added to the Carousel using the :attr:`add_widget` method.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	81
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	82 :attr:`slides` is a :class:`~kivy.properties.ListProperty` and is
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	83 read-only.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	84 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	85
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	86 def _get_slides_container(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	87 return [x.parent for x in self.slides]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	88
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	89 slides_container = AliasProperty(_get_slides_container, bind=('slides',))
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	90
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	91 direction = OptionProperty('right',
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	92 options=('right', 'left', 'top', 'bottom'))
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	93 '''Specifies the direction in which the slides are ordered. This
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	94 corresponds to the direction from which the user swipes to go from one
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	95 slide to the next. It
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	96 can be `right`, `left`, `top`, or `bottom`. For example, with
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	97 the default value of `right`, the second slide is to the right
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	98 of the first and the user would swipe from the right towards the
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	99 left to get to the second slide.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	100
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	101 :attr:`direction` is an :class:`~kivy.properties.OptionProperty` and
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	102 defaults to 'right'.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	103 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	104
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	105 min_move = NumericProperty(0.2)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	106 '''Defines the minimum distance to be covered before the touch is
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	107 considered a swipe gesture and the Carousel content changed.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	108 This is a expressed as a fraction of the Carousel's width.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	109 If the movement doesn't reach this minimum value, the movement is
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	110 cancelled and the content is restored to its original position.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	111
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	112 :attr:`min_move` is a :class:`~kivy.properties.NumericProperty` and
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	113 defaults to 0.2.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	114 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	115
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	116 anim_move_duration = NumericProperty(0.5)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	117 '''Defines the duration of the Carousel animation between pages.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	118
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	119 :attr:`anim_move_duration` is a :class:`~kivy.properties.NumericProperty`
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	120 and defaults to 0.5.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	121 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	122
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	123 anim_cancel_duration = NumericProperty(0.3)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	124 '''Defines the duration of the animation when a swipe movement is not
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	125 accepted. This is generally when the user does not make a large enough
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	126 swipe. See :attr:`min_move`.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	127
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	128 :attr:`anim_cancel_duration` is a :class:`~kivy.properties.NumericProperty`
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	129 and defaults to 0.3.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	130 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	131
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	132 loop = BooleanProperty(False)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	133 '''Allow the Carousel to loop infinitely. If True, when the user tries to
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	134 swipe beyond last page, it will return to the first. If False, it will
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	135 remain on the last page.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	136
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	137 :attr:`loop` is a :class:`~kivy.properties.BooleanProperty` and
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	138 defaults to False.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	139 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	140
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	141 def _get_index(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	142 if self.slides:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	143 return self._index % len(self.slides)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	144 return None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	145
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	146 def _set_index(self, value):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	147 if self.slides:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	148 self._index = value % len(self.slides)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	149 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	150 self._index = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	151
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	152 index = AliasProperty(_get_index, _set_index,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	153 bind=('_index', 'slides'),
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	154 cache=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	155 '''Get/Set the current slide based on the index.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	156
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	157 :attr:`index` is an :class:`~kivy.properties.AliasProperty` and defaults
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	158 to 0 (the first item).
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	159 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	160
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	161 def _prev_slide(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	162 slides = self.slides
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	163 len_slides = len(slides)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	164 index = self.index
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	165 if len_slides < 2: # None, or 1 slide
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	166 return None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	167 if self.loop and index == 0:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	168 return slides[-1]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	169 if index > 0:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	170 return slides[index - 1]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	171
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	172 previous_slide = AliasProperty(_prev_slide,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	173 bind=('slides', 'index', 'loop'),
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	174 cache=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	175 '''The previous slide in the Carousel. It is None if the current slide is
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	176 the first slide in the Carousel. This ordering reflects the order in which
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	177 the slides are added: their presentation varies according to the
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	178 :attr:`direction` property.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	179
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	180 :attr:`previous_slide` is an :class:`~kivy.properties.AliasProperty`.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	181
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	182 .. versionchanged:: 1.5.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	183 This property no longer exposes the slides container. It returns
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	184 the widget you have added.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	185 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	186
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	187 def _curr_slide(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	188 if len(self.slides):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	189 return self.slides[self.index or 0]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	190
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	191 current_slide = AliasProperty(_curr_slide,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	192 bind=('slides', 'index'),
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	193 cache=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	194 '''The currently shown slide.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	195
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	196 :attr:`current_slide` is an :class:`~kivy.properties.AliasProperty`.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	197
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	198 .. versionchanged:: 1.5.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	199 The property no longer exposes the slides container. It returns
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	200 the widget you have added.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	201 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	202
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	203 def _next_slide(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	204 if len(self.slides) < 2: # None, or 1 slide
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	205 return None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	206 if self.loop and self.index == len(self.slides) - 1:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	207 return self.slides[0]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	208 if self.index < len(self.slides) - 1:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	209 return self.slides[self.index + 1]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	210
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	211 next_slide = AliasProperty(_next_slide,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	212 bind=('slides', 'index', 'loop'),
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	213 cache=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	214 '''The next slide in the Carousel. It is None if the current slide is
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	215 the last slide in the Carousel. This ordering reflects the order in which
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	216 the slides are added: their presentation varies according to the
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	217 :attr:`direction` property.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	218
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	219 :attr:`next_slide` is an :class:`~kivy.properties.AliasProperty`.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	220
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	221 .. versionchanged:: 1.5.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	222 The property no longer exposes the slides container.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	223 It returns the widget you have added.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	224 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	225
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	226 scroll_timeout = NumericProperty(200)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	227 '''Timeout allowed to trigger the :attr:`scroll_distance`, in milliseconds.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	228 If the user has not moved :attr:`scroll_distance` within the timeout,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	229 no scrolling will occur and the touch event will go to the children.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	230
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	231 :attr:`scroll_timeout` is a :class:`~kivy.properties.NumericProperty` and
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	232 defaults to 200 (milliseconds)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	233
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	234 .. versionadded:: 1.5.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	235 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	236
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	237 scroll_distance = NumericProperty('20dp')
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	238 '''Distance to move before scrolling the :class:`Carousel` in pixels. As
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	239 soon as the distance has been traveled, the :class:`Carousel` will start
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	240 to scroll, and no touch event will go to children.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	241 It is advisable that you base this value on the dpi of your target device's
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	242 screen.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	243
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	244 :attr:`scroll_distance` is a :class:`~kivy.properties.NumericProperty` and
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	245 defaults to 20dp.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	246
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	247 .. versionadded:: 1.5.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	248 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	249
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	250 anim_type = StringProperty('out_quad')
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	251 '''Type of animation to use while animating to the next/previous slide.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	252 This should be the name of an
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	253 :class:`~kivy.animation.AnimationTransition` function.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	254
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	255 :attr:`anim_type` is a :class:`~kivy.properties.StringProperty` and
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	256 defaults to 'out_quad'.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	257
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	258 .. versionadded:: 1.8.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	259 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	260
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	261 ignore_perpendicular_swipes = BooleanProperty(False)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	262 '''Ignore swipes on axis perpendicular to direction.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	263
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	264 :attr:`ignore_perpendicular_swipes` is a
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	265 :class:`~kivy.properties.BooleanProperty` and defaults to False.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	266
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	267 .. versionadded:: 1.10.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	268 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	269
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	270 # private properties, for internal use only ###
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	271 _index = NumericProperty(0, allownone=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	272 _prev = ObjectProperty(None, allownone=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	273 _current = ObjectProperty(None, allownone=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	274 _next = ObjectProperty(None, allownone=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	275 _offset = NumericProperty(0)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	276 _touch = ObjectProperty(None, allownone=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	277
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	278 _change_touch_mode_ev = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	279
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	280 def __init__(self, **kwargs):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	281 self._trigger_position_visible_slides = Clock.create_trigger(
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	282 self._position_visible_slides, -1)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	283 super(Carousel, self).__init__(**kwargs)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	284 self._skip_slide = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	285 self.touch_mode_change = False
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	286 self._prioritize_next = False
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	287 self.fbind('loop', lambda *args: self._insert_visible_slides())
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	288
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	289 def load_slide(self, slide):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	290 '''Animate to the slide that is passed as the argument.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	291
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	292 .. versionchanged:: 1.8.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	293 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	294 slides = self.slides
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	295 start, stop = slides.index(self.current_slide), slides.index(slide)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	296 if start == stop:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	297 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	298
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	299 self._skip_slide = stop
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	300 if stop > start:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	301 self._prioritize_next = True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	302 self._insert_visible_slides(_next_slide=slide)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	303 self.load_next()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	304 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	305 self._prioritize_next = False
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	306 self._insert_visible_slides(_prev_slide=slide)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	307 self.load_previous()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	308
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	309 def load_previous(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	310 '''Animate to the previous slide.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	311
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	312 .. versionadded:: 1.7.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	313 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	314 self.load_next(mode='prev')
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	315
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	316 def load_next(self, mode='next'):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	317 '''Animate to the next slide.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	318
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	319 .. versionadded:: 1.7.0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	320 '''
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	321 if self.index is not None:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	322 w, h = self.size
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	323 _direction = {
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	324 'top': -h / 2,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	325 'bottom': h / 2,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	326 'left': w / 2,
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	327 'right': -w / 2}
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	328 _offset = _direction[self.direction]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	329 if mode == 'prev':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	330 _offset = -_offset
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	331
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	332 self._start_animation(min_move=0, offset=_offset)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	333
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	334 def get_slide_container(self, slide):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	335 return slide.parent
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	336
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	337 @property
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	338 def _prev_equals_next(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	339 return self.loop and len(self.slides) == 2
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	340
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	341 def _insert_visible_slides(self, _next_slide=None, _prev_slide=None):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	342 get_slide_container = self.get_slide_container
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	343
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	344 previous_slide = _prev_slide if _prev_slide else self.previous_slide
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	345 if previous_slide:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	346 self._prev = get_slide_container(previous_slide)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	347 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	348 self._prev = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	349
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	350 current_slide = self.current_slide
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	351 if current_slide:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	352 self._current = get_slide_container(current_slide)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	353 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	354 self._current = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	355
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	356 next_slide = _next_slide if _next_slide else self.next_slide
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	357 if next_slide:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	358 self._next = get_slide_container(next_slide)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	359 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	360 self._next = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	361
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	362 if self._prev_equals_next:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	363 setattr(self, '_prev' if self._prioritize_next else '_next', None)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	364
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	365 super_remove = super(Carousel, self).remove_widget
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	366 for container in self.slides_container:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	367 super_remove(container)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	368
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	369 if self._prev and self._prev.parent is not self:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	370 super(Carousel, self).add_widget(self._prev)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	371 if self._next and self._next.parent is not self:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	372 super(Carousel, self).add_widget(self._next)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	373 if self._current:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	374 super(Carousel, self).add_widget(self._current)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	375
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	376 def _position_visible_slides(self, *args):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	377 slides, index = self.slides, self.index
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	378 no_of_slides = len(slides) - 1
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	379 if not slides:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	380 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	381 x, y, width, height = self.x, self.y, self.width, self.height
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	382 _offset, direction = self._offset, self.direction[0]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	383 _prev, _next, _current = self._prev, self._next, self._current
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	384 get_slide_container = self.get_slide_container
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	385 last_slide = get_slide_container(slides[-1])
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	386 first_slide = get_slide_container(slides[0])
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	387 skip_next = False
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	388 _loop = self.loop
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	389
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	390 if direction in 'rl':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	391 xoff = x + _offset
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	392 x_prev = {'l': xoff + width, 'r': xoff - width}
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	393 x_next = {'l': xoff - width, 'r': xoff + width}
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	394 if _prev:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	395 _prev.pos = (x_prev[direction], y)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	396 elif _loop and _next and index == 0:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	397 # if first slide is moving to right with direction set to right
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	398 # or toward left with direction set to left
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	399 if ((_offset > 0 and direction == 'r') or
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	400 (_offset < 0 and direction == 'l')):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	401 # put last_slide before first slide
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	402 last_slide.pos = (x_prev[direction], y)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	403 skip_next = True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	404 if _current:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	405 _current.pos = (xoff, y)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	406 if skip_next:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	407 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	408 if _next:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	409 _next.pos = (x_next[direction], y)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	410 elif _loop and _prev and index == no_of_slides:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	411 if ((_offset < 0 and direction == 'r') or
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	412 (_offset > 0 and direction == 'l')):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	413 first_slide.pos = (x_next[direction], y)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	414 if direction in 'tb':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	415 yoff = y + _offset
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	416 y_prev = {'t': yoff - height, 'b': yoff + height}
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	417 y_next = {'t': yoff + height, 'b': yoff - height}
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	418 if _prev:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	419 _prev.pos = (x, y_prev[direction])
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	420 elif _loop and _next and index == 0:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	421 if ((_offset > 0 and direction == 't') or
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	422 (_offset < 0 and direction == 'b')):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	423 last_slide.pos = (x, y_prev[direction])
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	424 skip_next = True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	425 if _current:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	426 _current.pos = (x, yoff)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	427 if skip_next:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	428 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	429 if _next:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	430 _next.pos = (x, y_next[direction])
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	431 elif _loop and _prev and index == no_of_slides:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	432 if ((_offset < 0 and direction == 't') or
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	433 (_offset > 0 and direction == 'b')):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	434 first_slide.pos = (x, y_next[direction])
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	435
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	436 def on_size(self, *args):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	437 size = self.size
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	438 for slide in self.slides_container:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	439 slide.size = size
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	440 self._trigger_position_visible_slides()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	441
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	442 def on_pos(self, *args):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	443 self._trigger_position_visible_slides()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	444
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	445 def on_index(self, *args):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	446 self._insert_visible_slides()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	447 self._trigger_position_visible_slides()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	448 self._offset = 0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	449
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	450 def on_slides(self, *args):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	451 if self.slides:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	452 self.index = self.index % len(self.slides)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	453 self._insert_visible_slides()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	454 self._trigger_position_visible_slides()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	455
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	456 def on__offset(self, *args):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	457 self._trigger_position_visible_slides()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	458 # if reached full offset, switch index to next or prev
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	459 direction = self.direction[0]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	460 _offset = self._offset
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	461 width = self.width
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	462 height = self.height
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	463 index = self.index
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	464 if self._skip_slide is not None or index is None:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	465 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	466
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	467 # Move to next slide?
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	468 if (direction == 'r' and _offset <= -width) or \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	469 (direction == 'l' and _offset >= width) or \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	470 (direction == 't' and _offset <= - height) or \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	471 (direction == 'b' and _offset >= height):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	472 if self.next_slide:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	473 self.index += 1
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	474
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	475 # Move to previous slide?
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	476 elif (direction == 'r' and _offset >= width) or \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	477 (direction == 'l' and _offset <= -width) or \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	478 (direction == 't' and _offset >= height) or \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	479 (direction == 'b' and _offset <= -height):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	480 if self.previous_slide:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	481 self.index -= 1
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	482
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	483 elif self._prev_equals_next:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	484 new_value = (_offset < 0) is (direction in 'rt')
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	485 if self._prioritize_next is not new_value:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	486 self._prioritize_next = new_value
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	487 if new_value is (self._next is None):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	488 self._prev, self._next = self._next, self._prev
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	489
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	490 def _start_animation(self, args, *kwargs):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	491 # compute target offset for ease back, next or prev
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	492 new_offset = 0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	493 direction = kwargs.get('direction', self.direction)[0]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	494 is_horizontal = direction in 'rl'
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	495 extent = self.width if is_horizontal else self.height
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	496 min_move = kwargs.get('min_move', self.min_move)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	497 _offset = kwargs.get('offset', self._offset)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	498
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	499 if _offset < min_move * -extent:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	500 new_offset = -extent
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	501 elif _offset > min_move * extent:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	502 new_offset = extent
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	503
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	504 # if new_offset is 0, it wasnt enough to go next/prev
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	505 dur = self.anim_move_duration
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	506 if new_offset == 0:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	507 dur = self.anim_cancel_duration
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	508
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	509 # detect edge cases if not looping
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	510 len_slides = len(self.slides)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	511 index = self.index
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	512 if not self.loop or len_slides == 1:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	513 is_first = (index == 0)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	514 is_last = (index == len_slides - 1)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	515 if direction in 'rt':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	516 towards_prev = (new_offset > 0)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	517 towards_next = (new_offset < 0)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	518 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	519 towards_prev = (new_offset < 0)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	520 towards_next = (new_offset > 0)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	521 if (is_first and towards_prev) or (is_last and towards_next):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	522 new_offset = 0
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	523
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	524 anim = Animation(_offset=new_offset, d=dur, t=self.anim_type)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	525 anim.cancel_all(self)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	526
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	527 def _cmp(*l):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	528 if self._skip_slide is not None:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	529 self.index = self._skip_slide
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	530 self._skip_slide = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	531
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	532 anim.bind(on_complete=_cmp)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	533 anim.start(self)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	534
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	535 def _get_uid(self, prefix='sv'):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	536 return '{0}.{1}'.format(prefix, self.uid)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	537
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	538 def on_touch_down(self, touch):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	539 if not self.collide_point(*touch.pos):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	540 touch.ud[self._get_uid('cavoid')] = True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	541 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	542 if self.disabled:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	543 return True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	544 if self._touch:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	545 return super(Carousel, self).on_touch_down(touch)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	546 Animation.cancel_all(self)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	547 self._touch = touch
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	548 uid = self._get_uid()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	549 touch.grab(self)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	550 touch.ud[uid] = {
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	551 'mode': 'unknown',
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	552 'time': touch.time_start}
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	553 self._change_touch_mode_ev = Clock.schedule_once(
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	554 self._change_touch_mode, self.scroll_timeout / 1000.)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	555 self.touch_mode_change = False
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	556 return True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	557
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	558 def on_touch_move(self, touch):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	559 if not self.touch_mode_change:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	560 if self.ignore_perpendicular_swipes and \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	561 self.direction in ('top', 'bottom'):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	562 if abs(touch.oy - touch.y) < self.scroll_distance:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	563 if abs(touch.ox - touch.x) > self.scroll_distance:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	564 self._change_touch_mode()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	565 self.touch_mode_change = True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	566 elif self.ignore_perpendicular_swipes and \
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	567 self.direction in ('right', 'left'):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	568 if abs(touch.ox - touch.x) < self.scroll_distance:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	569 if abs(touch.oy - touch.y) > self.scroll_distance:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	570 self._change_touch_mode()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	571 self.touch_mode_change = True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	572
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	573 if self._get_uid('cavoid') in touch.ud:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	574 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	575 if self._touch is not touch:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	576 super(Carousel, self).on_touch_move(touch)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	577 return self._get_uid() in touch.ud
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	578 if touch.grab_current is not self:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	579 return True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	580 ud = touch.ud[self._get_uid()]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	581 direction = self.direction[0]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	582 if ud['mode'] == 'unknown':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	583 if direction in 'rl':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	584 distance = abs(touch.ox - touch.x)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	585 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	586 distance = abs(touch.oy - touch.y)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	587 if distance > self.scroll_distance:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	588 ev = self._change_touch_mode_ev
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	589 if ev is not None:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	590 ev.cancel()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	591 ud['mode'] = 'scroll'
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	592 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	593 if direction in 'rl':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	594 self._offset += touch.dx
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	595 if direction in 'tb':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	596 self._offset += touch.dy
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	597 return True
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	598
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	599 def on_touch_up(self, touch):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	600 if self._get_uid('cavoid') in touch.ud:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	601 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	602 if self in [x() for x in touch.grab_list]:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	603 touch.ungrab(self)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	604 self._touch = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	605 ud = touch.ud[self._get_uid()]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	606 if ud['mode'] == 'unknown':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	607 ev = self._change_touch_mode_ev
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	608 if ev is not None:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	609 ev.cancel()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	610 super(Carousel, self).on_touch_down(touch)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	611 Clock.schedule_once(partial(self._do_touch_up, touch), .1)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	612 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	613 self._start_animation()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	614
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	615 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	616 if self._touch is not touch and self.uid not in touch.ud:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	617 super(Carousel, self).on_touch_up(touch)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	618 return self._get_uid() in touch.ud
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	619
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	620 def _do_touch_up(self, touch, *largs):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	621 super(Carousel, self).on_touch_up(touch)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	622 # don't forget about grab event!
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	623 for x in touch.grab_list[:]:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	624 touch.grab_list.remove(x)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	625 x = x()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	626 if not x:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	627 continue
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	628 touch.grab_current = x
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	629 super(Carousel, self).on_touch_up(touch)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	630 touch.grab_current = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	631
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	632 def _change_touch_mode(self, *largs):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	633 if not self._touch:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	634 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	635 self._start_animation()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	636 uid = self._get_uid()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	637 touch = self._touch
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	638 ud = touch.ud[uid]
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	639 if ud['mode'] == 'unknown':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	640 touch.ungrab(self)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	641 self._touch = None
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	642 super(Carousel, self).on_touch_down(touch)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	643 return
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	644
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	645 def add_widget(self, widget, index=0, canvas=None):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	646 container = RelativeLayout(
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	647 size=self.size, x=self.x - self.width, y=self.y)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	648 container.add_widget(widget)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	649 super(Carousel, self).add_widget(container, index, canvas)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	650 if index != 0:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	651 self.slides.insert(index - len(self.slides), widget)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	652 else:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	653 self.slides.append(widget)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	654
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	655 def remove_widget(self, widget, args, *kwargs):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	656 # XXX be careful, the widget.parent refer to the RelativeLayout
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	657 # added in add_widget(). But it will break if RelativeLayout
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	658 # implementation change.
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	659 # if we passed the real widget
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	660 slides = self.slides
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	661 if widget in slides:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	662 if self.index >= slides.index(widget):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	663 self.index = max(0, self.index - 1)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	664 container = widget.parent
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	665 slides.remove(widget)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	666 super(Carousel, self).remove_widget(container)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	667 return container.remove_widget(widget, args, *kwargs)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	668 return super(Carousel, self).remove_widget(widget, args, *kwargs)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	669
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	670 def clear_widgets(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	671 for slide in self.slides[:]:
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	672 self.remove_widget(slide)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	673 super(Carousel, self).clear_widgets()
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	674
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	675
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	676 if __name__ == '__main__':
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	677 from kivy.app import App
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	678
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	679 class Example1(App):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	680
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	681 def build(self):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	682 carousel = Carousel(direction='left',
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	683 loop=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	684 for i in range(4):
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	685 src = "http://placehold.it/480x270.png&text=slide-%d&.png" % i
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	686 image = Factory.AsyncImage(source=src, allow_stretch=True)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	687 carousel.add_widget(image)
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	688 return carousel
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	689
5bd583d00594 backport: added a new "backport" module for using unreleased code from Kivy: Goffi <goffi@goffi.org> parents: diff changeset	690 Example1().run()

Mercurial > libervia-desktop-kivy

annotate cagou/backport/carousel.py @ 439:12d188cb1206