Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FabianTerhorst/Isometric
Isometric drawing library for Android
https://github.com/FabianTerhorst/Isometric
android isometric view
Last synced: about 1 month ago
JSON representation
Isometric drawing library for Android
- Host: GitHub
- URL: https://github.com/FabianTerhorst/Isometric
- Owner: FabianTerhorst
- License: apache-2.0
- Created: 2017-04-03T13:41:08.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-04-20T04:45:26.000Z (over 5 years ago)
- Last Synced: 2024-10-30T02:36:35.329Z (about 1 month ago)
- Topics: android, isometric, view
- Language: Java
- Size: 800 KB
- Stars: 1,131
- Watchers: 34
- Forks: 129
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-android-ui - Isometric - 安卓图形库 (其他)
README
# Isometric
Isometric drawing library for Android
### Drawing a simple cube
```java
isometricView.add(
new Prism(
new Point(/* x */ 0, /* y */ 0, /* z */ 0),
/* width */ 1, /* length */ 1, /* height */ 1
),
new Color(33, 150, 243)
);
```
### Drawing multiple Shapes
#### There are 3 basic components: points, paths and shapes. A shape needs an origin point and 3 measurements for the x, y and z axes. The default Prism constructor is setting all measurements to 1.
```java
isometricView.add(new Prism(new Point(0, 0, 0)), new Color(33, 150, 243));
isometricView.add(new Prism(new Point(-1, 1, 0), 1, 2, 1), new Color(33, 150, 243));
isometricView.add(new Prism(new Point(1, -1, 0), 2, 1, 1), new Color(33, 150, 243));
```
### Drawing multiple Paths
#### Paths are two dimensional. You can draw and color paths the same as shapes.
```java
isometricView.add(new Prism(Point.ORIGIN, 3, 3, 1), new Color(50, 60, 160));
isometricView.add(new Path(new Point[]{
new Point(1, 1, 1),
new Point(2, 1, 1),
new Point(2, 2, 1),
new Point(1, 2, 1)
}), new Color(50, 160, 60));
```
### The grid
#### Here you can see how the grid looks like. The blue grid is the xy-plane. The z-line is the z-axis.
### Supports complex structures
# Include in your project
## Using JCenter
```groovy
compile 'io.fabianterhorst:Isometric:0.0.9'
```
### Available Shapes
#### [Cylinder](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Cylinder.java), [Knot](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Knot.java), [Octahedron](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Octahedron.java), [Prism](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Prism.java), [Pyramid](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Pyramid.java) and [Stairs](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Stairs.java)
### Translate
#### Traslate is translating an point, path or shape to the given x, y and z distance. Translate is returning a new point, path or shape.
```java
Prism prism = new Prism(new Point(0, 0, 0));
isometricView.add(prism, new Color(33, 150, 243));
isometricView.add(prism.translate(0, 0, 1.1), new Color(33, 150, 243));
```
### Scale
#### Scale is scaling an point, path or shape with the given x, y and z scaling factors. Scale is returning a new point, path or shape.
```java
Color blue = new Color(50, 60, 160);
Color red = new Color(160, 60, 50);
Prism cube = new Prism(Point.ORIGIN);
isometricView.add(cube.scale(Point.ORIGIN, 3.0, 3.0, 0.5), red);
isometricView.add(cube
.scale(Point.ORIGIN, 3.0, 3.0, 0.5)
.translate(0, 0, 0.6), blue);
```
### RotateZ
#### RotateZ is rotating an point, path or shape with the given angle in radians on the xy-plane (where an angle of 0 runs along the position x-axis). RotateZ is returning a new point, path or shape.
```java
Color blue = new Color(50, 60, 160);
Color red = new Color(160, 60, 50);
Prism cube = new Prism(Point.ORIGIN, 3, 3, 1);
isometricView.add(cube, red);
isometricView.add(cube
/* (1.5, 1.5) is the center of the prism */
.rotateZ(new Point(1.5, 1.5, 0), Math.PI / 12)
.translate(0, 0, 1.1), blue);
```
### Shapes from Paths
#### The method ```Shape.extrude``` allows you to create a 3D model by popping out a 2D path along the z-axis.
```java
Color blue = new Color(50, 60, 160);
Color red = new Color(160, 60, 50);
isometricView.add(new Prism(Point.ORIGIN, 3, 3, 1), blue);
isometricView.add(Shape.extrude(new Path(new Point[]{
new Point(1, 1, 1),
new Point(2, 1, 1),
new Point(2, 3, 1)
}), 0.3), red);
```
### Available Shapes
#### [Cylinder](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Cylinder.java)
[Knot](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Knot.java)
[Octahedron](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Octahedron.java)
[Prism](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Prism.java)
[Pyramid](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Pyramid.java)
[Stairs](https://github.com/FabianTerhorst/Isometric/blob/master/lib/src/main/java/io/fabianterhorst/isometric/shapes/Stairs.java)
# Developed By
* Fabian Terhorst
* [github.com/FabianTerhorst](https://github.com/FabianTerhorst) -
* [paypal.me/fabianterhorst](http://paypal.me/fabianterhorst)
# Contributors
* **[cameronwhite08](https://github.com/cameronwhite08)**
# License
Copyright 2017 Fabian Terhorst
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.