Skip to content

SlavaKyrai/QuadTreeAndroid

Repository files navigation

QuadTreeAndroid

alt tag alt tag

Library that helps to implement the QuadTree in android, by using splitting images

Download

Download via Gradle:

compile 'com.github.slavakyrai:quadtreeandroidimpl:0.1.1'

or Maven:

<dependency>
  <groupId>com.github.slavakyrai</groupId>
  <artifactId>quadtreeandroidimpl</artifactId>
  <version>0.1.1</version>
  <type>pom</type>
</dependency>

Usage

Create an instance of the QuadSplitter class. Pass the bitmap and OnQuadTreeSplitComplete callback in the constructor. The result will be returned as list of QuadTreeRect, in another thread in onSplitComplete().Use the method start() to start splitting image.

QuadTreeSplitter quadTreeSplitter = new QuadTreeSplitter(mutableBitmap, new OnQuadTreeSplitComplete() {
    @Override
    public void onSplitComplete(List<QuadTreeRect> quadTreeRects) {
        Log.d(TAG, "onSplitComplete: " + quadTreeRects.size());
      }
    });
quadTreeSplitter.start();

You can customize the work of the QuadSplitter class by using methods setMinQuadAreaSize() and setMinColorDistance().

quadTreeSplitter.setMinQuadAreaSize(50);
quadTreeSplitter.setMinColorDistance(5);

If you want to display the separeting image process, use the QuadTreeImageView class, which is extended by the ImageView. For than you must use the next methods: setImageBitmap() method of the QuadTreeImageView class, and setOnQuadDrawListener() method of the QuadTreeSplitter class. You can enable or disable the outlines of the rectangles borders, when you use the setDrawGreed() method.

QuadTreeImageView imageView = (QuadTreeImageView) findViewById(R.id.qtImgView);
imageView.setImageBitmap(mutableBitmap);
quadTreeSplitter.setOnQuadDrawListener(imageView);
imageView.setDrawGreed(true);

Look sample for more information

License

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.