Picasso face detection transformation

An Android image transformation library providing cropping above Face Detection (Face Centering) for Picasso

Are you using Glide? GlideFaceDetectionTransformation.

Are you using Fresco? FrescoFaceDetectionProcessor.

Results

Original Image

Results after cropping

Original Image

Results after cropping

Original Image

Results after cropping

Original Image

Results after cropping

You can read more on my Medium article.

How to use it?

STEP 1:

Grab via Gradle

repositories {
    jcenter()
}
dependencies {
    compile 'com.github.aryarohit07:picasso-facedetection-transformation:0.3.0'
}

Or via Maven

<dependency>
  <groupId>com.github.aryarohit07</groupId>
  <artifactId>picasso-facedetection-transformation</artifactId>
  <version>0.3.0</version>
</dependency>

STEP 2:

Initialize the detector (May be in onCreate() method)

PicassoFaceDetector.initialize(context);

STEP 3: Set picasso transform

Picasso
  .with(context)
  .load(url)
  .fit() // use fit() and centerInside() for making it memory efficient.
  .centerInside()
  .transform(new FaceCenterCrop(100, 100)) //in pixels. You can also use FaceCenterCrop(width, height, unit) to provide width, height in DP.
  .into(imageView);

STEP 4:

The face detector uses native resources in order to do detection. For this reason, it is necessary to release the detector instance once it is no longer needed (May be in onDestory() method)

PicassoFaceDetector.releaseDetector();

Note: If no face is detected, it will fallback to CENTER CROP.

Library dependencies:

com.google.android.gms:play-services-vision:9.4.0
com.squareup.picasso:picasso:2.5.2

If you liked it, please Star it.

TODO

• Making it generic for any point.

Performance: Time taken to detect faces in the original image.

| width | height | time taken(ms) | |-------|--------|----------------| | 640 | 360 | 60-150 | | 900 | 600 | 100-200 | | 1280 | 720 | 250-350 | | 1920 | 1080 | 350-400 | | 2048 | 1536 | 500-550 |

License

Copyright 2016 Rohit Arya

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.