CDJoystick

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.

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.