Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jrvansuita/PickImage

📸 🖼️ Shows a DialogFragment with camera and gallery options. User can choose which provider wants to pick images from.
https://github.com/jrvansuita/PickImage

android android-library android-ui camera dialog dialogfragment gallery gallery-options java listener material-design pickimage ui

Last synced: 3 months ago
JSON representation

📸 🖼️ Shows a DialogFragment with camera and gallery options. User can choose which provider wants to pick images from.

Host: GitHub
URL: https://github.com/jrvansuita/PickImage
Owner: jrvansuita
License: mit
Created: 2016-11-01T16:43:11.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2023-04-03T12:44:20.000Z (over 1 year ago)
Last Synced: 2024-06-16T03:32:26.291Z (5 months ago)
Topics: android, android-library, android-ui, camera, dialog, dialogfragment, gallery, gallery-options, java, listener, material-design, pickimage, ui
Language: Java
Homepage:
Size: 5.47 MB
Stars: 470
Watchers: 12
Forks: 107
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Awesome Lists containing this project

awesome-github-android-ui - PickImage - 带有Camera和Gallery选项的DialogFragment (选择器(Picker))

README

        






# PickImage

This is an [**Android**](https://developer.android.com) project. It shows a [DialogFragment](https://developer.android.com/reference/android/app/DialogFragment.html) with Camera or Gallery options. The user can choose from which provider wants to pick an image.

 

 

 

[![JitPack](https://jitpack.io/v/jrvansuita/PickImage.svg)](https://jitpack.io/#jrvansuita/PickImage)

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-PickImage-green.svg?)](https://android-arsenal.com/details/1/4614) [![MaterialUp](https://img.shields.io/badge/MaterialUp-PickImage-6ad0d9.svg?)](https://www.uplabs.com/posts/pickimage) [![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fjrvansuita%2FPickImage&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=VIEWS&edge_flat=false)](https://hits.seeyoufarm.com)

# Dialog screenshots

#### Default icons.



#### Colored icons.



#### Custom dialog.



#### System dialog.



[![Appetize.io](https://img.shields.io/badge/Apptize.io-Run%20Now-brightgreen.svg?)](https://appetize.io/embed/91gknbry9vrtz281b7jy244e0m?device=nexus7&maxSize=50&autoplay=true&orientation=portrait&deviceColor=black) [![Demo](https://img.shields.io/badge/Demo-Download-blue.svg)](http://apk-dl.com/dl/com.vansuita.pickimage.sample)

 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/118bb89e3bed43e2b462201654224a60)](https://www.codacy.com/app/jrvansuita/PickImage?utm_source=github.com&utm_medium=referral&utm_content=jrvansuita/PickImage&utm_campaign=Badge_Grade) 

 

 

# Setup

#### Step #1. Add the JitPack repository to your build.gradle file:

```gradle

allprojects {

    repositories {

	maven { url "https://jitpack.io" }

    }

}

```

#### Step #1.1 Or add the JitPack repository to the settings.gradle file:

```gradle

dependencyResolutionManagement {

    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)

    repositories {

       maven { url 'https://jitpack.io' }

    }

}

```

     

#### Step #2. Add the dependency ([See latest release](https://jitpack.io/#jrvansuita/PickImage)).

```groovy

dependencies {

    implementation 'com.github.jrvansuita:PickImage:+'

}

```

# Implementation

#### Step #1. Overriding the library file provider authority to avoid installation conflicts.

The use of this library can cause [INSTALL_FAILED_CONFLICTING_PROVIDER](https://developer.android.com/guide/topics/manifest/provider-element.html#auth) if you skip this step. Update your AndroidManifest.xml with this exact provider declaration below.

```xml

    

        

            

        

    	

 

```

#### Step #2 - Showing the dialog.

```java

PickImageDialog.build(new PickSetup()).show(this);

``` 

#### Step #3 - Applying the listeners.

##### Method #3.1 - Make your AppCompatActivity implements IPickResult.

```java

@Override

public void onPickResult(PickResult r) {

    if (r.getError() == null) {

        //If you want the Uri.

        //Mandatory to refresh image from Uri.

        //getImageView().setImageURI(null);

        //Setting the real returned image.

        //getImageView().setImageURI(r.getUri());

        //If you want the Bitmap.

        getImageView().setImageBitmap(r.getBitmap());

        //Image path

        //r.getPath();

    } else {

        //Handle possible errors

        //TODO: do what you have to do with r.getError();

        Toast.makeText(this, r.getError().getMessage(), Toast.LENGTH_LONG).show();

    }

}

```

##### Method #3.2 - Set the listener using the public method (Good for Fragments).

```java

PickImageDialog.build(new PickSetup())

               .setOnPickResult(new IPickResult() {

                  @Override

                  public void onPickResult(PickResult r) {

                     //TODO: do what you have to...

                  }

               })

	       .setOnPickCancel(new IPickCancel() {

		  @Override

		  public void onCancelClick() {

			//TODO: do what you have to if user clicked cancel

		   }

		}).show(getSupportFragmentManager());

```

#### Step #4 - Customize you Dialog using PickSetup.

```java

PickSetup setup = new PickSetup()

            .setTitle(yourText)

            .setTitleColor(yourColor)

            .setBackgroundColor(yourColor)

            .setProgressText(yourText)

            .setProgressTextColor(yourColor)

            .setCancelText(yourText)

            .setCancelTextColor(yourColor)

            .setButtonTextColor(yourColor)

            .setDimAmount(yourFloat)

            .setFlip(true)

            .setMaxSize

            .setPickTypes(EPickType.GALLERY, EPickType.CAMERA)

            .setCameraButtonText(yourText)

            .setGalleryButtonText(yourText)

            .setIconGravity(Gravity.LEFT)

            .setButtonOrientation(LinearLayoutCompat.VERTICAL)

            .setSystemDialog(false)

            .setGalleryIcon(yourIcon)

            .setCameraIcon(yourIcon)

            .setGalleryChooserTitle(yourText)

            .setCameraChooserTitle(yourText);

/*... and more to come. */

```

# Additionals

#### Own click implementations.

If you want to write your own button click event, just use [IPickClick](library/src/main/java/com/vansuita/pickimage/listeners/IPickClick.java) listener like in the example below. You may want to take a look at the sample app.

 

 ```java

 PickImageDialog.build(setup)

         .setOnClick(new IPickClick() {

             @Override

             public void onGalleryClick() {

                 Toast.makeText(SampleActivity.this, "Gallery Click!", Toast.LENGTH_LONG).show();

             }

             @Override

             public void onCameraClick() {

                 Toast.makeText(SampleActivity.this, "Camera Click!", Toast.LENGTH_LONG).show();

             }

          }).show(this);

``` 

#### For dismissing the dialog.

```java

PickImageDialog dialog = PickImageDialog.build(...);

dialog.dismiss();

```

#### Force a specific width and height.

```java

new PickSetup().setWidth(600).setHeight(800);

```

#### Not just an ImagePicker anymore! You can pick video too.

You can tell the setup to pick video instead of photo! (default option if you don't mention is to pick Image)

```java

new PickSetup().setVideo(true);

```

  

# Sample app code.

 You can take a look at the sample app [located on this project](/app/).

 

#