Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sh-khashimov/SwiftFortuneWheel

The ultimate spinning wheel view that supports dynamic content and rich customization.
https://github.com/sh-khashimov/SwiftFortuneWheel

circle circular core-graphics dynamic fortune fortune-wheel ios lucky macos osx radial rotating sector slice spinning swift tvos uicontrol uiview wheel

Last synced: about 1 month ago
JSON representation

The ultimate spinning wheel view that supports dynamic content and rich customization.

Host: GitHub
URL: https://github.com/sh-khashimov/SwiftFortuneWheel
Owner: sh-khashimov
License: mit
Created: 2020-06-07T07:30:17.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-08-02T12:37:34.000Z (5 months ago)
Last Synced: 2024-11-15T19:48:56.875Z (about 2 months ago)
Topics: circle, circular, core-graphics, dynamic, fortune, fortune-wheel, ios, lucky, macos, osx, radial, rotating, sector, slice, spinning, swift, tvos, uicontrol, uiview, wheel
Language: Swift
Homepage:
Size: 37.7 MB
Stars: 351
Watchers: 8
Forks: 82
Open Issues: 8
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - SwiftFortuneWheel - A cross-platform framework for games like a Wheel of Fortune. (Games / Getting Started)
awesome-ios-star - SwiftFortuneWheel - A cross-platform framework for games like a Wheel of Fortune. (Games / Getting Started)

README

        



[![CI Status](https://img.shields.io/travis/sh-khashimov/SwiftFortuneWheel.svg?style=flat)](https://travis-ci.org/sh-khashimov/SwiftFortuneWheel)

[![Swift Version](https://img.shields.io/badge/Swift-5-orange.svg)]()

[![Version](https://img.shields.io/cocoapods/v/SwiftFortuneWheel.svg?label=version)](https://cocoapods.org/pods/SwiftFortuneWheel)

![Support](https://img.shields.io/badge/supports-SPM%2C%20CocoaPods-green.svg)

[![Platform](https://img.shields.io/cocoapods/p/SwiftFortuneWheel.svg?style=flat)](https://cocoapods.org/pods/SwiftFortuneWheel)

![Documentation](./docs/badge.svg?style=flat&sanitize=true)

The ultimate spinning wheel control that supports dynamic content and rich customization.

| | Main Features |

|---|---|

| 🏵 | Dynamic content, supports texts, images, and lines |

| 🎯 | Adaptive text size with support multiline, alignment and line break mode |

| 🎇 | Supports background Image for each Slice (sector) |

| 🧮 | Supports vertical and horizontal text orientation |

| 🌈 | Appearance customization |

| 🔊 | Sounds and haptic feedback |

| 🌋 | Collision callbacks and effects |

| 🎨 | Drawn and animated using CoreGraphics, CoreAnimations |

| 🔋 | High performance, low memory usage |

### Layout Preview





> _Taken from [example projects](/Examples)_

### Dynamic Content and Rotation Preview



> _Taken from [example projects](/Examples)_

### Collision Effect Preview



> _Taken from [example projects](/Examples)_

## Screenshots

  from iOS Example Project



- - -

  from macOS Example Project



- - -

  from tvOS Example Project



- - -

## Documentation

- [**Getting Started Guide**](/Documentation/GettingStarted.md)

- [**API Overview**](/Documentation/API_Overview.md)

- [**Configuration In-Depth**](/Documentation/Configuration_indepth.md)

- [**About Slice and Slice’s contents**](/Documentation/About_Slice_and_Slice_contents.md)

- [**Sound Effects and Impact Feedback**](/Documentation/sound_effects.md)

- [**pinImageView Collision effect and Collision Callbacks**](/Documentation/collision.md)

- [**About Port to Other Platforms**](/Documentation/Port_to_Other_Platforms.md)

- [**Example Projects**](/Examples)

## Installation

When you are ready to install, follow the [**Installation Guide**](/Documentation/Installation.md).

## API Documentation

You can find **the docs here**. 

Documentation is generated with [jazzy](https://github.com/realm/jazzy) and hosted on [GitHub-Pages](https://pages.github.com/).



## Requirements

| App name | Swift | Xcode | Platforms |

|---|---|---|---|

| 1.1.4 - current version | Swift 5.x | Xcode 14 | iOS 9.0 / macOS 10.13 / tvOS 9.0 |

| 1.1.x - 1.4.3 | Swift 5.0 | Xcode 11 | iOS 9.0 / macOS 10.11 / tvOS 9.0 |

| 0.x.x - 1.0.x | Swift 5.0 | Xcode 11 | iOS 9.0 |

## Migration

- [**from 1.1.x to 1.2.x**](/Documentation/Migrations/Migration_1.1.x_to_1.2.x.md)

- [**from 1.0.x to 1.1.x**](/Documentation/Migrations/Migration_1_to_1.x.md)

- [**from 0.x.x to 1.0.0**](/Documentation/Migrations/Migration_0_to_1.md)

## Changelog

See [**changelog here**](/Documentation/Changelog.md)

## Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## Author

Sherzod Khashimov

## License

[MIT](https://choosealicense.com/licenses/mit/)