Skip to content

jinhuizxc/PuzzleView

Repository files navigation

PuzzleView

Android Jigsaw puzzle support,inspired by Instagram's layout.

中文README

the apk file is here--->http://fir.im/puzzle0607

Screenshots

Due the size of the gif file, the example below may not render well, in that case you can view the demo video on youtube.

Click here to see video demo

Usage

in build.gradle

compile 'com.flying.xiaopo:puzzle:1.1.2'

in xml layout

 <com.xiaopo.flying.puzzle.PuzzleView
        android:id="@+id/puzzle"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

 <com.xiaopo.flying.puzzle.SquarePuzzleView
        android:id="@+id/square_puzzle"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

in the java code, you can change some attributes of the puzzle view

mPuzzleView.setPuzzleLayout(mPuzzleLayout);
mPuzzleView.setMoveLineEnable(true);
mPuzzleView.setNeedDrawBorder(false);
mPuzzleView.setNeedDrawOuterBorder(false);
mPuzzleView.setExtraSize(100);
mPuzzleView.setBorderWidth(4);
mPuzzleView.setBorderColor(Color.WHITE);
mPuzzleView.setSelectedBorderColor(Color.parseColor("#99BBFB"));

and handle some actions

mPuzzleView.rotate(90f);
mPuzzleView.flipHorizontally();
mPuzzleView.flipVertically();
mPuzzleView.setNeedDrawBorder(!mPuzzleView.isNeedDrawBorder());
mPuzzleView.replace(bitmap);

Also you can check the source code of the demo for examples of how to use these attributes.

Layout

The PuzzleView depends on the PuzzleLayout. Of course you can customize it.
If you don't want to customize it's layout, you can just use the default layout.
All the built-in layouts can be found in the the demo's PlaygroundActivity. You can click to see the effect.

Custom Layout

To create a custom layout is also easy. Just extend PuzzleLayout and override the layout method.
The PuzzleLayout class provides some methods for customization. Also you can check the source code of the in-built layouts for guidance / examples.

public class CustomLayout extends PuzzleLayout {

    @Override
    public void layout() {
        addLine(getOuterBorder(), Line.Direction.HORIZONTAL, 1f / 2);
        addLine(getBorder(0), Line.Direction.VERTICAL, 1f / 2);
    }
}

Finally

to see some photos by puzzle Click here

Update

  • 2017/04/15 1.1.1 add piece select listener
  • 2017/02/15 1.1.0 add piece padding function

License

Copyright 2016 wuapnjie

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.

About

Android拼图支持库

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages