Git Product home page Git Product logo

imagecropper's Introduction

ImageCropper

A custom image cropper library for Android

Features

  • Support moving/scale the crop window freely by finger
  • Support set a fixed crop window size
  • Support set the max crop window size
  • Support set a fixed crop window's width/height aspect
  • Support rotate the image when cropping
  • Easy to integrate to your app

ScreenShot

Screenshot

Building

  • It's a android library project with eclipse
  • You should import the project into the eclipse with your main project
  • Config the Library Reference to ImageCropper in the main project's properties

Usage

Declare the CropImageActivity in the main project's AndroidManifest.xml

<activity android:name="com.ticktick.imagecropper.CropImageActivity"/>

Declare the write_external_storage permission in the main project's AndroidManifest.xml

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

Call these methods to run CropImage Activity

//1. Using the CropIntent to help build the start intent
private void startCropImage() {

    // Create a CropIntent
    CropIntent intent = new CropIntent(); 
    
    // Set the source image filepath/URL and output filepath/URL (Required)
    intent.setImagePath("/sdcard/source.jpg");
    intent.setOutputPath("/sdcard/cropped.jpg");
    
    // Set a fixed crop window size (Optional) 
    intent.setOutputSize(640,480);

    // set the max crop window size (Optional) 
    intent.setMaxOutputSize(800,600);

    // Set a fixed crop window's width/height aspect (Optional) 
    intent.setAspect(3,2);
    
    // start ImageCropper activity with certain request code and listen for result
    startActivityForResult(intent.getIntent(this), REQUEST_CODE_CROP_PICTURE);
}
//2. Create the intent by manual
private void startCropImage() {

    // Create explicit intent
    Intent intent = new Intent(this, CropImageActivity.class);
        
    // Set the source image filepath/URL and output filepath/URL (Required)
    intent.setData(Uri.fromFile(new File("/sdcard/source.jpg")));
    intent.putExtra(MediaStore.EXTRA_OUTPUT,Uri.fromFile(new File("/sdcard/cropped.jpg")));
    
    // Set a fixed crop window size (Optional) 
    intent.putExtra("outputX",640);
    intent.putExtra("outputY",480);

    // set the max crop window size (Optional) 
    intent.putExtra("maxOutputX",800);
    intent.putExtra("maxOutputY",600);

    // Set a fixed crop window's width/height aspect (Optional) 
    intent.putExtra("aspectX",3);
    intent.putExtra("aspectY",2);
    
    // start ImageCropper activity with certain request code and listen for result
    startActivityForResult(intent, REQUEST_CODE_CROP_PICTURE);
}

Waiting for result

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

    if (resultCode != RESULT_OK) {
        return;
    }

    if (requestCode == REQUEST_CODE_CROP_PICTURE ) {
        Uri croppedUri = data.getExtras().getParcelable(MediaStore.EXTRA_OUTPUT);	
        InputStream in = null;
	try {
            in = getContentResolver().openInputStream(croppedUri);
            Bitmap b = BitmapFactory.decodeStream(in);
            mImageView.setImageBitmap(b);
        } 
	catch (FileNotFoundException e) {
            e.printStackTrace();
        }     
    }
    super.onActivityResult(requestCode, resultCode, data);
}

Contact

Email:[email protected]

imagecropper's People

Contributors

jhuster avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.