https://github.com/kivy-garden/garden.roulettescroll

a kivy scroll effect that simulates the motion of a roulette, or a notched wheel (think Wheel of Fortune)
https://github.com/kivy-garden/garden.roulettescroll

Last synced: about 1 month ago
JSON representation

a kivy scroll effect that simulates the motion of a roulette, or a notched wheel (think Wheel of Fortune)

• Host: GitHub
• URL: https://github.com/kivy-garden/garden.roulettescroll
• Owner: kivy-garden
• License: mit
• Created: 2013-08-26T23:15:02.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2017-06-14T18:02:53.000Z (over 7 years ago)
• Last Synced: 2023-03-30T19:02:11.333Z (over 1 year ago)
• Language: Python
• Size: 10.7 KB
• Stars: 6
• Watchers: 5
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


RouletteScrollEffect

===================

This is a subclass of `kivy.effects.ScrollEffect` that simulates the 

motion of a roulette, or a notched wheel (think Wheel of Fortune). It is

primarily designed for emulating the effect of the iOS and android date pickers.

Usage

-----

Here's an example of using `RouletteScrollEffect` for a 

`kivy.uix.scrollview.ScrollView` 

	if __name__ == '__main__':

	    # example modified from the scrollview example

	

	    from kivy.uix.gridlayout import GridLayout

	    from kivy.uix.button import Button

	    from kivy.uix.scrollview import ScrollView

		from kivy.garden.roulettescroll import RouletteScrollEffect

	    from kivy.base import runTouchApp

	    layout = GridLayout(cols=1, padding=10,

	            size_hint=(None, None), width=500)

	

	    layout.bind(minimum_height=layout.setter('height'))

	

	    for i in range(30):

	        btn = Button(text=str(i), size=(480, 40),

	                     size_hint=(None, None))

	        layout.add_widget(btn)

	

	    root = ScrollView(size_hint=(None, None), size=(500, 320),

	            pos_hint={'center_x': .5, 'center_y': .5}

	            , do_scroll_x=False)

	    root.add_widget(layout)

	

	    root.effect_y = RouletteScrollEffect(anchor=20, interval=40)

	    runTouchApp(root)

        

Here the `ScrollView` scrolls through a series of buttons with height

40. We then attached a `RouletteScrollEffect` with interval 40, 

corresponding to the button heights. This allows the scrolling to stop at

the same offset no matter where it stops. The `RouletteScrollEffect.anchor`

adjusts this offset. 

Customizations

--------------

Other settings that can be played with include 

`RouletteScrollEffect.pull_duration`,

`RouletteScrollEffect.coasting_alpha`,

`RouletteScrollEffect.pull_back_velocity`, and

`RouletteScrollEffect.terminal_velocity`. See their module documentations

for details.

`RouletteScrollEffect` has one event ``on_coasted_to_stop`` that

is fired when the roulette stops, "making a selection". It can be listened to

for handling or cleaning up choice making.