/CDJoystick

Joystick for UIKit

Primary LanguageSwiftMIT LicenseMIT

CDJoystick

Version License Platform Language

What is it?

CDJoystick is a Joystick for UIKit.

It is written in Swift 3 and uses IBDesignable, IBInspectable and Core Graphics.

Installation

CDJoystick is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "CDJoystick"

Alternatively, you can install it manually by copying the file CDJoystick.swift into your project.

Usage (Storyboards)

  1. Drag a UIView into your storyboard.
  2. Change the class of the UIView to CDJoystick.
  3. Customize your joystick using the inspector.

alt tag

Usage (Programmatically)

  1. Import the module:

    import CDJoystick
    
  2. Initialize an instance of CDJoystick using the constructor:

    let joystick = CDJoystick()
    joystick.frame = CGRect(x: 0, y: 0, width: 100, height: 100)
    joystick.backgroundColor = .clear
    
  3. Customize the joystick:

    joystick.substrateColor = .lightGray
    joystick.substrateBorderColor = .gray
    joystick.substrateBorderWidth = 1.0
    joystick.stickSize = CGSize(width: 50, height: 50)
    joystick.stickColor = .darkGray
    joystick.stickBorderColor = .black
    joystick.stickBorderWidth = 2.0
    joystick.fade = 0.5
    
  4. Setup the tracking handler to get velocity and angle data:

    joystick.trackingHandler = { joystickData in
        self.objectView.center.x += joystickData.velocity.x
        self.objectView.center.y += joystickData.velocity.y
    }
    
  5. Add the joystick to your view:

    view.addSubview(joystick)
    

Author

Cole Dunsby, coledunsby@gmail.com

License

CDJoystick is available under the MIT license. See the LICENSE file for more info.