LongImageCamera

Additional

Language
Java
Version
1.0.1 (Apr 19, 2017)
Created
Apr 13, 2017
Updated
Jun 17, 2017 (Retired)
Owner
Wajahat Karim (wajahatkarim3)
Contributor
Wajahat Karim (wajahatkarim3)
1
Activity
Badge
Generate
Download
Source code

LongImageCamera

A camera view to capture long image merged from small captured images as it is in Shoparoo app! This library uses CameraView from Google as the backbone of camera functionality and adds auto-support of creating long or wide images from multiple images. This library includes:

  • Built-in Camera UI and activity
  • Built-in Image Viewer with pinch-fling gestures for zoom/move/rotate etc.
  • TouchImageView with gestures support for zoom/move/rotate etc.
  • Built-in permission handling for Camera and Storage
  • Horizontal or Vertical image merging

Demo

Install Demo app or APK from Releases on your device and try to capture a long image!

Changelog

Changes exist in the releases tab.

Installation

Add this in your app's build.gradle file:

dependencies {
  compile 'com.wajahatkarim3.LongImageCamera:LongImageCamera:1.0.2'
}

Or add LongImageCamera as a new dependency inside your pom.xml

<dependency>
  <groupId>com.wajahatkarim3.LongImageCamera</groupId>
  <artifactId>LongImageCamera</artifactId>
  <version>1.0.2</version>
  <type>pom</type>
</dependency>

Usage

Launch Camera Activity

Start the camera from any Activity with this code:

// Launches camera in Vertical Merge Mode (Captured image will be long)
LongImageCameraActivity.launch( myActivity );

// Launches Camea in Horizontal Merge Mode (Captured image will be wide)
LongImageCameraActivity.launch( myActivity, LongImageCameraActivity.ImageMergeMode.HORIZONTAL );

and then you will get the result image in onActivityResult() method like this:

@Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);

        if (resultCode == RESULT_OK && requestCode == LongImageCameraActivity.LONG_IMAGE_RESULT_CODE && data != null)
        {
            String imageFileName = data.getStringExtra(LongImageCameraActivity.IMAGE_PATH_KEY);
            Log.e(TAG, "onActivityResult: " + imageFileName );
        }
    }

Launch Image Viewer Activity

This library comes with a built-in image viewer including support of pinch/fling gestures for zoom/move/roate etc. You can launch image viewer with this code:

Intent ii = new Intent(myActivity, PreviewLongImageActivity.class);
ii.putExtra("imageName", myImagePath);
startActivity(ii);

Using TouchImageView in your layouts

You can use customized ImageView with support of gestures for zoom/move/rotate etc like this:

<com.wajahatkarim3.longimagecamera.TouchImageView
        android:id="@+id/imageView1"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

Libs used in this Library

Donations

This project needs you! If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, feel free to donate. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!

PayPal

  • Donate $5: Thank's for creating this project, here's a tea (or some juice) for you!
  • Donate $10: Wow, I am stunned. Let me take you to the movies!
  • Donate $15: I really appreciate your work, let's grab some lunch!
  • Donate $25: That's some awesome stuff you did right there, dinner is on me!
  • Donate $50: I really really want to support this project, great job!
  • Donate $100: You are the man! This project saved me hours (if not days) of struggle and hard work, simply awesome!
  • Donate $2799: Go buddy, buy Macbook Pro for yourself! Of course, you can also choose what you want to donate, all donations are awesome!

Developed By

Wajahat Karim

How to Contribute

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

Copyright 2017 Wajahat Karim

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.