cdjoystick's Introduction

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)

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

Usage (Programmatically)

Import the module:
```
import CDJoystick
```

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

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

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
}

Add the joystick to your view:
```
view.addSubview(joystick)
```

Author

Cole Dunsby, [email protected]

License

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

cdjoystick's People

Contributors

Stargazers

Watchers

cdjoystick's Issues

On release, values are not updated

Hi, Thanks for created a great library.

Is there a way to get the x and y values to reset once the joystick has been released ?

Currently have this:

        joystick.trackingHandler = {joystickData in
            self.xlabel.text = "\(joystickData.velocity.x)";
            self.ylabel.text = "\(joystickData.velocity.y)";
        }

Works fine when moving the joypad around, but as soon as I release the x and y values reported in the label get stuck on the values related to the last position of the joystick (even though the joystick has returned back to the middle visually.