WuDaozi

Android image selector, written with Kotlin, inspired by zhihu/Matisse.

Features

• Select images in Activity or Fragment
• Select images with size filter and type filter
• Support custom styles

How to use

You can copy the source code and do whaterver you want to do.

Or use Gradle.

Step 1. Add JitPack repository in your root build.gradle

allprojects {
    repositories {
        //... others 
        maven { url 'https://jitpack.io' }
    }
}

Step 2. Add the dependency in your app build.gradle

dependencies {
	implementation 'com.github.JosephusZhou:WuDaozi:1.0.5'
}

Step 3. Request permission

• android.permission.READ_EXTERNAL_STORAGE

Step 4. Start to select images from Activity or Fragment

val launcher = WuDaozi.getLauncher(this) { result ->
    result?.let {
        for (uri in it) {
            Log.e("WuDaozi", "->$uri")
        }
    } ?: Toast.makeText(this, "canceled", Toast.LENGTH_SHORT)
        .show()
}
WuDaozi.with(this)
        .theme(R.style.CustomWuDaoziTheme)
        .imageLoader(GlideLoader())
        .columnsCount(4)
        .maxSelectableCount(9)
        .filter(minByteSize = 1024 * 10, selectedTypes = arrayOf(Filter.Type.JPG))
        .start(launcher)

How to customize

• theme(): UI theme
• imageLoader(): the image engine to load images
• columnsCount(): how many images can be displayed in one line
• maxSelectableCount(): how many images can be selected at most
• filter(): filter images of specific sizes and types

ImageLoader

Implement the ImageLoader interface and all methods.

Theme

Build your own theme base on WuDaozi.Theme.

License

Copyright 2019 JosephusZhou

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.