TedPicker

Additional

Language
Java
Version
v1.0.10 (Mar 6, 2016)
Created
Jan 17, 2016
Updated
Mar 12, 2019
Owner
Ted Park (ParkSangGwon)
Contributors
Vladislav Bauer (vbauer)
Ted Park (ParkSangGwon)
gun0912
ggikko
robertsLando
5
Activity
Badge
Generate
Download
Source code
APK file

Show card

What is TedPicker?

TedPicker is image selector library for android and allows you to easily take a picture from gallery or camera without using a lot of boilerplate code. Do not waste your time for writing image select function code. You can take a picture or select image from gallery.

Also you can customize color, drawable, select count, etc for your application.

Demo

Watch video at youtube

Setup

Gradle

We will use cwac-camera for take a picture. And get library from jitpack.io

repositories {
    maven { url "https://repo.commonsware.com.s3.amazonaws.com" }
    maven { url "https://jitpack.io" }

}

dependencies {
      compile 'com.github.ParkSangGwon:TedPicker:v1.0.10'
}
Permission

Add permission for Camera, External Storage.

<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" android:required="false" />

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
Activity

Declare Activity in your AndroidManifest.xml

<activity android:name="com.gun0912.tedpicker.ImagePickerActivity" 
                      android:screenOrientation="portrait"
/>

you have to use AppCompat theme like this. ImagePickerActivity use toolbar without actionbar

    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <!-- Customize your theme here. -->
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>


        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>

How to use

1. Start Activity

Add your request code for startActivityForResult() and start ImagePickerActivity

    private static final int INTENT_REQUEST_GET_IMAGES = 13;

    private void getImages() {

        Intent intent  = new Intent(this, ImagePickerActivity.class);
        startActivityForResult(intent,INTENT_REQUEST_GET_IMAGES);

    }
2. Receive Activity

If you finish image select, you will recieve image path array (Uri type)

    @Override
    protected void onActivityResult(int requestCode, int resuleCode, Intent intent) {
        super.onActivityResult(requestCode, resuleCode, intent);

            if (requestCode == INTENT_REQUEST_GET_IMAGES && resuleCode == Activity.RESULT_OK ) {

                ArrayList<Uri>  image_uris = intent.getParcelableArrayListExtra(ImagePickerActivity.EXTRA_IMAGE_URIS);

                //do something
            }
    }

Customize

You can change color, drawable, height ... Before call startActivityForResult(), set your Config instance to ImagePickerActivity

Example
        Config config = new Config();
        config.setCameraHeight(R.dimen.app_camera_height);
        config.setToolbarTitleRes(R.string.custom_title);
        config.setSelectionMin(2);
        config.setSelectionLimit(4);
        config.setSelectedBottomHeight(R.dimen.bottom_height);

        ImagePickerActivity.setConfig(config);

        Intent intent = new Intent(this, ImagePickerActivity.class);
        startActivityForResult(intent, INTENT_REQUEST_GET_IMAGES);
Function
  • setCameraHeight(R.dimen.xxx) (default: 250dp)

  • setSelectedBottomHeight(R.dimen.xxx) (default: 90dp)

  • setSelectedBottomColor(R.color.xxx) (default: R.attr.colorAccent)

  • setToolbarTitleRes(R.string.xxx) (default: Choice Image / 사진선택)

  • setTabBackgroundColor(R.color.xxx) (default: #fff)

  • setTabSelectionIndicatorColor(R.color.xxx) (default: R.attr.colorPrimary)

  • setSelectionLimit(int)

  • setSelectionMin(int)

  • setCameraBtnImage(R.drawable.xxx)

  • setCameraBtnBackground(R.drawable.xxx)

  • setSelectedCloseImage(R.drawable.xxx)

  • setSavedDirectoryName(R.string.xxx) (default: Pictures)

  • setFlashOn(boolean) (default: false)

Thanks

License

Copyright 2016 Ted Park

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.```