Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sparrow007/androidjoystickview
This library lets you create joystick with some customization for android
https://github.com/sparrow007/androidjoystickview
android customview joystick library shadow
Last synced: about 1 month ago
JSON representation
This library lets you create joystick with some customization for android
- Host: GitHub
- URL: https://github.com/sparrow007/androidjoystickview
- Owner: sparrow007
- License: apache-2.0
- Created: 2018-08-22T23:22:41.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-10-26T06:02:29.000Z (about 1 year ago)
- Last Synced: 2024-04-29T00:36:21.174Z (9 months ago)
- Topics: android, customview, joystick, library, shadow
- Language: Java
- Size: 76.2 KB
- Stars: 49
- Watchers: 5
- Forks: 12
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AndroidJoyStickView
[](http://developer.android.com/index.html)
[](https://android-arsenal.com/api?level=14)
[](https://www.apache.org/licenses/LICENSE-2.0.html)
This library lets you create joystick with some customization for android
Gradle
------
#### Add the dependency
```
dependencies {
...
implementation 'com.jackandphantom.android:joystickview:1.0.2'
}
```
# Basic Usage
#### AndroidJoystickView XML
In order to use AndroidLikeButton copy following xml code in your xml file.
```xml
```
#### AndroidJoystickView Interface
```java
JoyStickView joyStickView = findViewById(R.id.joy);
joyStickView.setOnMoveListener(new JoyStickView.OnMoveListener() {
@Override
public void onMove(double angle, float strength) {
}
});
```
# Concept
There are two views in JoyStick
1. InnerCircleView : This is small circle in joystick as you can see in image so attributes related to this view will using innerCircle
in prefix in xml
2. OuterCircleView : This is big circle in joystick so all attributes related to this will using outerCircle in prefix in xml
# Attributes
There are several attribute to configure AndroidJoystick view, they are following
#### InnerCircleView Attributes
#### innerCircleColor , innerCircleImage
In order to change the inner Circle color and add the image into the small circle use the following code :-
```xml
```
In Java
```java
joyStickView.setInnerCircleImageResId(R.drawable.ic_directions_run_black_24dp);
joyStickView.setInnerCircleColor(Color.BLACK);
```
#### innerCircleRadius
Before changing the size of small circle you need to understand small concep which is both inner and outer circle has ratio 0.1f and 0.4f respectively so you have to maintain 5.0f in total. so when you change innerCircleRadius value it substracted outercircle value from 5.0f.
```xml
```
In Java
```java
joyStickView.setInnerCircleRadius(0.1f);
```
#### OuterCircleView Attributes
#### outerCircleColor , outerCircleBorderWidth , outerCircleBorderColor
In order to change outerCircle attributes like it's color , bordercolor and borderWidth you can use following code :
```xml
```
In Java
```java
joyStickView.setOuterCircleBorderColor(Color.RED);
joyStickView.setOuterCircleBorderStrokeWidth(15);
joyStickView.setOuterCircleColor(Color.WHITE);
```
### lockCenter
The default property of joystickview is that when move it and you release it then it automatically came to the center and lockCenter is the property in which it lock the small circle when it stength is equal to 100 so if you want to lock it then
```xml
```
In Java
```java
joyStickView.setLockCenter(false);
```
#### Shadow
If you want to addt the shadow in joystick first you need to add outerCircleBorderWidth value and then you can change these properties
#### ShadowRadius , shadowColor , Dx, Dy
```xml
```
In Java
```java
joyStickView.setShadowColor(Color.BLACK);
joyStickView.setShadowRadius(7f);
joyStickView.setShadowDxAndDy(5f, 5f);
```
LICENCE
-----
Copyright 2018 Ankit kumar
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.
Special Thanks to Manish and zerokol