/Vorolay

VoronoiView is a view (ViewGroup) that allows you to add and display views inside Voronoi diagram regions.

Primary LanguageJavaApache License 2.0Apache-2.0

Vorolay

License Android Arsenal

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

alt text alt text alt text alt text

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.