Skip to content

It's is an Android document detection library built on top of OpenCV 4.4.0 It works best with a dark background.

Notifications You must be signed in to change notification settings

askintution/LiveEdgeDetection

 
 

Repository files navigation

Release

LiveEdgeDetection

LiveEdgeDetection is an Android document detection library built on top of OpenCV. It scans documents from camera live mode and allows you to adjust crop using the detected 4 edges and performs perspective transformation of the cropped image.

It works best with a dark background.

OpenCV

The source code of OpenCV is here https://git.mxtracks.info/opencv/openCV-android-sdk The code was too big for github, but the main problem was jitpack.io was not able to build jitpack/jitpack.io#4119

Screenshots

Use darker bg Move closer Move away Adjust angle Hold still Adjust crop Result

Integrating into your project

This library is available in JitPack.io repository. To use it, make sure to add the below inside root build.gradle file

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

and add the repository's url to the app's build.gradle file.

dependencies {
   implementation 'com.github.hannesa2:LiveEdgeDetection:$latestVersion'
}

Usage

Out of the box it uses OpenCV.

  1. Start startActivityForResult from your activity
startActivityForResult(new Intent(this, ScanActivity.class), REQUEST_CODE);
  1. Get a file path for cropped image on onActivityResult
String filePath = data.getExtras().getString(ScanConstants.SCANNED_RESULT);
Bitmap baseBitmap = ScanUtils.decodeBitmapFromFile(filePath, ScanConstants.IMAGE_NAME);
  1. Display the image using TouchImageView
<com.ortiz.touchview.TouchImageView
        android:id="@+id/scanned_image"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scaleType="center" />

License

Copyright 2020 hannesa2.

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

It's is an Android document detection library built on top of OpenCV 4.4.0 It works best with a dark background.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Kotlin 86.3%
  • Java 12.7%
  • Shell 1.0%