JoyStick/README.md

107 lines
3.1 KiB
Markdown
Raw Normal View History

2015-10-31 04:57:44 +00:00
# JoyStick
Android Library for JoyStick View.<br>
2015-11-03 03:27:28 +00:00
Its customizable, small and lightweight.<br>
Change Background/Button Color, use image for Background/Button.
2015-10-31 04:57:44 +00:00
[ ![Download](https://api.bintray.com/packages/erz05/maven/JoyStick/images/download.svg) ](https://bintray.com/erz05/maven/JoyStick/_latestVersion)
2015-11-01 22:38:52 +00:00
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-JoyStick-blue.svg?style=flat)](http://android-arsenal.com/details/1/2712)
2016-10-29 18:17:29 +00:00
<a href="https://play.google.com/store/apps/details?id=com.erz.joystick&utm_source=global_co&utm_medium=prtnr&utm_content=Mar2515&utm_campaign=PartBadge&pcampaignid=MKT-AC-global-none-all-co-pr-py-PartBadges-Oct1515-1"><img height="75px" alt="Get it on Google Play" src="https://play.google.com/intl/en_us/badges/images/apps/en-play-badge.png" /></a>
2015-10-31 05:21:18 +00:00
2015-10-31 04:57:44 +00:00
<H2>Images: Sample App</H2>
<img width="300px" src="https://github.com/erz05/JoyStick/blob/master/images/Screenshot_2015-10-30-21-38-13.png" />
2015-11-01 22:37:49 +00:00
<br><br>
2015-10-31 04:57:44 +00:00
<img width="300px" src="https://github.com/erz05/JoyStick/blob/master/images/Screenshot_2015-10-30-21-43-47.png" />
2015-11-03 03:27:28 +00:00
<br><br>
JoyStick with Image for button<br>
<img width="300px" src="https://github.com/erz05/JoyStick/blob/master/images/Screenshot_2015-11-02-18-05-49.png" />
2015-10-31 04:57:44 +00:00
<br>
<H2>Usage</H2>
Gradle Import: jcenter <br>
```groovy
repositories {
jcenter()
}
dependencies {
2016-10-29 17:44:18 +00:00
compile 'com.github.erz05:JoyStick:1.0.3@aar'
2015-10-31 04:57:44 +00:00
}
```
```xml
<com.erz.joysticklibrary.JoyStick
android:id="@+id/joy1"
android:layout_width="200dp"
android:layout_height="200dp"
android:layout_gravity="bottom"/>
<com.erz.joysticklibrary.JoyStick
android:id="@+id/joy2"
android:layout_width="200dp"
android:layout_height="200dp"
android:layout_gravity="bottom|right"
app:padColor="#55ffffff"
app:buttonColor="#55ff0000"/>
```
```java
JoyStick joyStick = (JoyStick) findViewById(R.id.joyStick);
//or
JoyStick joyStick = new JoyStick(context);
//Set GamePad Color
joyStick.setPadColor(Color.BLACK);
//Set Button Color
joyStick.setButtonColor(Color.RED);
2015-11-03 03:27:28 +00:00
//Set Background Image
joyStick.setPadBackground(resId);
//Set Button Image
joyStick.setButtonDrawable(resId);
//Set Button Scale
joyStick.setButtonRadiusScale(scale);
//Enable Button to Stay Put
joyStick.enableStayPut(enable);
2015-10-31 04:57:44 +00:00
//Get Power
joyStick.getPower();
2015-11-02 03:33:50 +00:00
//Get Angle
joyStick.getAngle();
//Get Angle in Degrees
joyStick.getAngleDegrees();
2015-10-31 04:57:44 +00:00
//Set JoyStickListener
joyStick.setListener(this);
//JoyStickListener Interface
public interface JoyStickListener {
2015-11-02 03:33:50 +00:00
void onMove(JoyStick joyStick, double angle, double power);
2015-10-31 04:57:44 +00:00
}
```
<H2>License</H2>
Copyright 2015 erz05
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.