Vorolay
VoronoiView is a view (ViewGroup) that allows you to add and display views inside Voronoi diagram regions. [Voronoi diagram] (https://en.wikipedia.org/wiki/Voronoi_diagram)
Screenshots
Import
Step 1. Add the JitPack repository to your build file
Add it in your root build.gradle at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Step 2. Add the dependency
dependencies {
compile 'com.github.Quatja:Vorolay:1.0.1'
}
---------
Usage
Add the view into your layout. You can customize it by using xml attributes
<quatja.com.vorolay.VoronoiView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_margin="50dp"
custom:border_color="@color/gray"
custom:border_round="false"
custom:border_width="5" />
Then add your views to the VoronoiView
VoronoiView voronoiView = (VoronoiView) findViewById(R.id.voronoi);
LayoutInflater layoutInflater = getLayoutInflater();
for (int i = 0; i < 15; i++) {
View view = layoutInflater.inflate(R.layout.item_voronoi, null, false);
voronoiView.addView(view);
}
Now VoronoiView children will be displayed inside the diagram regions.
---------
Customization
Attributes which you can use in customization purposes
attr | value/example | description |
---|---|---|
show_border | true | shows or hides each region borders |
border_color | #fff | sets all borders color |
border_width | 5 | sets borders width |
border_round | true | makes border corners round |
generation_type | random | sets different points generation behavior |
Generation types
type | description |
---|---|
random | VoronoiView generates a random point positions inside the view bounds. |
ordered | points are placed like a table - rows and columns. |
custom | points will be placed in user defined positions. |
These attributes are available programmatically too.
Warning
Children visibility GONE doesn't work
Do not use tags for the children
Acknowledgements
Steven Fortune - algorithm author
Zhenyu Pan - Forutne algorithm Java version
Bart Kiers - Graham Scan realization
License
Copyright 2016 Daniil Jurjev
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.