Skip to content

Latest commit

 

History

History
108 lines (91 loc) · 4.65 KB

README.md

File metadata and controls

108 lines (91 loc) · 4.65 KB
Raw

SCPRotatingWheelControl (v1.0) iOS 6.0 +

Simple customisable control that allows user interaction to spin a wheel and reveal a segment.

Sample project both using storyboards and programmatically included

Pod coming soon.

Installation

  • Download .zip or add as a submodule

  • Add SCPRotatingWheelControl folder to your Xcode project. This contains the required subclasses.

    (Note all classes are needed)

  • Include #import "SCPRotatingWheelControl.h" in your controllers .h or .m

Storyboards

  • Add a empty view to the chosen board for your storyboard
  • Set the custom class of the view to SCPRotatingWheelControl
  • Add a property of that view to your view controller @property (weak, nonatomic) IBOutlet SCPRotatingWheelControl *storyBoardRotatingWheelControl;
  • Set the segment title data and call reloadSegment
//Set the data and reload the table
[_storyBoardRotatingWheelControl setSegmentTitles:@[@"Segment 1", @"Segment 2"]];
[_storyBoardRotatingWheelControl reloadSegments];
  • To listen to the changing of segments set the block property
//Set block to handel the call backs with the selected segment index
[_storyBoardRotatingWheelControl setCurrectSegmentDidChangeBlock:^(NSInteger currentSegment) {
    NSLog(@"Current segment %d", currentSegment);
}];

Programmatically

  • Add a property to your view controller @property (nonatomic, strong) SCPRotatingWheelControl *codeRotatingWheelControl;

  • Create a CGSize setting the size you want the wheel to be.

    (Note width and height must be the same to give a perfect circle)

//Set the wheel size
CGSize wheelSize = CGSizeMake(600, 600);
  • Init a new instance of SCPRotatingWheelControl
//Init a new SCPRotatingWheelControl
self.codeRotatingWheelControl = [[SCPRotatingWheelControl alloc] initWithSize:wheelSize
                                                                segmentTitles:_segmentTitles
                                                           spinOnFirstViewing:YES
                                                               spinCompletion:^(BOOL finished) {
                                                                   //Spinning completed in-case you want to fade on controls once the SCPRotatingWheelControl is ready
                                                                   NSLog(@"Spinning complete");
                                                               }
                                                      currectSegmentDidChange:^(NSInteger currentSegment) {
                                                            //Block to handle the call backs with the selected segment index
                                                            NSLog(@"Current segment %d", currentSegment);
                                                      }];
  • The above code handles the change segment events. Set spinOnFirstShowing to force the wheel to spin the very first time it is shown.
  • Finally set the frame and add it to your view
[_codeRotatingWheelControl setFrame:CGRectMake(40, 84, wheelSize.width, wheelSize.height)];
[[self view] addSubview:_codeRotatingWheelControl];

Customising the look

  • There are a few methods that you can call on an instance of SCPRotatingWheelControl that allow you to customise the colour scheme of the wheel easily.
[_storyBoardRotatingWheelControl setBottomWheelFillColour:[UIColor colorWithRed:0.384 green:0.565 blue:0.741 alpha:1]];
[_storyBoardRotatingWheelControl setBottomWheelStrokeColour:[UIColor whiteColor]];
[_storyBoardRotatingWheelControl setBottomWheelStrokeWidth:7.0f];

[_storyBoardRotatingWheelControl setTopWheelFillColour:[UIColor colorWithRed:0.463 green:0.698 blue:0.847 alpha:1]];
[_storyBoardRotatingWheelControl setTopWheelStrokeColour:[UIColor whiteColor]];
[_storyBoardRotatingWheelControl setTopWheelStrokeWidth:7.0f];
  • If you have several segments (25+) on the wheel you may wish to reduce the viewport of the wheel, making the visable area of the segments narrower. As is the same for a larger view point.
[_storyBoardRotatingWheelControl setViewPortSizeOffset:35.0f];

(Note you can only have valuse between -35.0f and 35.0f)

Other methods

  • If you wish to force the wheel to perform a spin you can do this with the spin method
[_storyBoardRotatingWheelControl spinCompletion:^(BOOL finished) {
    NSLog(@"Spinning complete");
}];

Future work

  • Further customisation of wheel
  • Sounds
  • Any fixes that the open source community finds

License

MIT