ImageCropper.Forms - GitLite

KO | EN

gitlite — search

#python #react #ai #typescript #llm #golang #rust #docker #java #awesome #awesome-list #vue #pytorch #open-source

ImageCropper.Forms

(★ 90)

Xamarin.Forms plugin to crop and rotate photos.

File Explorer

Download Latest Version (.zip)

- - Binding_AndroidImageCropper.csproj
  - GeneratedBindingInfo.txt
- - ApiDefinition.cs
  - Structs.cs
  - TOCropViewController.csproj
- - IImageCropperWrapper.cs
  - ImageCropper.cs
  - ImageCropper.csproj
- - ImageCropper.Android.csproj
  - ImageCropperImplementation.cs
  - Platform.cs
- - ImageCropper.iOS.csproj
  - ImageCropperImplementation.cs
  - packages.config
  - Platform.cs
- Android.png
- Android_Circle.gif
- Android_Rectangle.gif
- iOS.png
- iOS_Circle.gif
- iOS_Rectangle.gif
- - App.xaml
  - App.xaml.cs
  - MainPage.xaml
  - MainPage.xaml.cs
  - Test.csproj
- - MainActivity.cs
  - MainApplication.cs
  - Test.Android.csproj
- - AppDelegate.cs
  - Entitlements.plist
  - Info.plist
  - Main.cs
  - packages.config
  - Test.iOS.csproj
.gitattributes
.gitignore
ImageCropper.Forms.sln
ImageCropper.nuspec
LICENSE.md
nuget.exe
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ImageCropper.Forms

Xamarin.Forms plugin to crop and rotate photos.

[![NuGet](https://img.shields.io/nuget/v/ImageCropper.Forms.svg)](https://www.nuget.org/packages/ImageCropper.Forms/)

Supports Android and iOS.
* Android library from : https://github.com/ArthurHub/Android-Image-Cropper
* iOS library from : https://github.com/TimOliver/TOCropViewController

## Features

* Cropping image.
* Rotating image.
* Aspect ratio.
* Circle/Rectangle shape.

## Screen-Shots

### Android
<img src="ScreenShots/Android_Rectangle.gif" alt="Crop/Rotate image(Rectangle/Android)"/> <img src="ScreenShots/Android_Circle.gif" alt="Crop/Rotate image(Circle/Android)"/>

### iOS
<img src="ScreenShots/iOS_Rectangle.gif" alt="Crop/Rotate image(Rectangle/iOS)"/> <img src="ScreenShots/iOS_Circle.gif" alt="Crop/Rotate image(Circle/iOS)" />

## Setup

* Install the [nuget package](https://www.nuget.org/packages/ShapeControl.Forms/) in portable and all platform specific projects.
* This plugin uses the [MediaPlugin](https://github.com/jamesmontemagno/MediaPlugin/blob/master/README.md). Be sure to complete the full setup this plugin. Please fully read through the [MediaPlugin description](https://github.com/jamesmontemagno/MediaPlugin/blob/master/README.md).

### Android

Add the following to your AndroidManifest.xml inside the <application> tags:
```xml	
	<activity android:name="com.theartofdev.edmodo.cropper.CropImageActivity"
	          android:theme="@style/Base.Theme.AppCompat"/>	
```

In MainActivity.cs file:
```cs
    Stormlion.ImageCropper.Droid.Platform.Init();

global::Xamarin.Forms.Forms.Init(this, bundle);
```
```cs
    protected override void OnActivityResult(int requestCode, Result resultCode, Intent data)
    {
        base.OnActivityResult(requestCode, resultCode, data);

Stormlion.ImageCropper.Droid.Platform.OnActivityResult(requestCode, resultCode, data);
    }
```

### iOS

In AppDelegate.cs file:

```cs
    Stormlion.ImageCropper.iOS.Platform.Init();
```
## Usage

### Show ImageCropper page.
```cs
    new ImageCropper()
    {
        Success = (imageFile) =>
        {
            Device.BeginInvokeOnMainThread(() =>
            {
                imageView.Source = ImageSource.FromFile(imageFile);
            });
        }
    }.Show(this);
```
### Show it with additional parameters.
```cs
    new ImageCropper()
    {
        PageTitle = "Test Title",
        AspectRatioX = 1,
        AspectRatioY = 1,
	CropShape = ImageCropper.CropShapeType.Oval,
	SelectSourceTitle = "Select source",
	TakePhotoTitle = "Take Photo",
	PhotoLibraryTitle = "Photo Library",
	CancelButtonTitle = "Cancel",
        Success = (imageFile) =>
        {
            Device.BeginInvokeOnMainThread(() =>
            {
                imageView.Source = ImageSource.FromFile(imageFile);
            });
        }
    }.Show(this);
```
### Show it with a image
```cs
    new ImageCropper()
    {
        Success = (imageFile) =>
        {
            Device.BeginInvokeOnMainThread(() =>
            {
                imageView.Source = ImageSource.FromFile(imageFile);
            });
        }
    }.Show(this, imageFileName);
```
### Get byte[] from image file
var imageBytes = ImageCropper.Current.GetBytes(imageFile: imageFile);
### Properties
* PageTitle
* AspectRatioX
* AspectRatioY
* CropShape
* Initial image can be set in Show function.

## Contributions
Contributions are welcome!