Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ponywolf/joykey
Converts joystick axis events into key event in Corona SDK
https://github.com/ponywolf/joykey
Last synced: about 2 months ago
JSON representation
Converts joystick axis events into key event in Corona SDK
- Host: GitHub
- URL: https://github.com/ponywolf/joykey
- Owner: ponywolf
- Created: 2016-11-21T21:06:35.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-08-24T19:50:53.000Z (over 4 years ago)
- Last Synced: 2024-07-31T09:10:11.356Z (5 months ago)
- Language: Lua
- Size: 6.84 KB
- Stars: 9
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-solar2d - joykey - a module that converts joystick axis events into key events. (Input Handling)
README
# joykey and vjoy by Ponywolf
These two modules can be strung together to make an on screen joystick control that outputs key events, thereby reducing some of the complexity of writing game interface code. Read more about Corona SDK key events here... https://docs.coronalabs.com/api/event/key/index.html
#### joykey.lua
Converts joystick axis events into key events in Corona SDK
##### Usage:
Just add this line to your main.lua
```
require("com.ponywolf.joykey").start()
```
This module turns gamepad axis events into keyboard events so we don't have to write separate code for joystick and keyboard control. Axis 1 & 2 will return up/down/left/right keyboard events and Axis 3 & 4 will return w/a/s/d keyboard events.
#### vjoy.lua
A modern on-screen joystick and button class that emulate gamepad axis and key events. Basically, if you have a game that works with gamepad input these on screen controls can be customized to make it work with on-screen controls
##### Usage:
Require the module in your main.lua
```
local vjoy = require "com.ponywolf.vjoy"
```
Add a virtual joystick
```
vjoy.newStick(startAxis, innerRadius, outerRadius)
```
###### StartAxis
The first axis of the two for your joystick (defaults to 1)
###### innerRadius
Size of the joystick control (defaults to 48px) or a filename of an image to load for the joystick forground
###### outerRadius
Size of the joystick movement area (defaults to 496px) or a filename of an image to load for the joystick background
Add a virtual button
```
vjoy.newButton(key, radius)
```
###### key
The keyName of the button you want to fire (defaults to "buttonA")
###### radius
Size of the button control (defaults to 64px) or a filename of an image to load for the button