croppy - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #llm #machine-learning #rust #deep-learning #linux #windows #awesome #vue #pytorch #open-source

croppy

(★ 148)

A fully customizable image cropper for Flutter, in Flutter

File Explorer

Download Latest Version (.zip)

- - pages.yml
- - cover-github.png
  - cover.jpg
  - cover.psd
  - illustration-1.png
  - illustration-2.png
  - illustration-3.png
  - illustration-4.png
  - illustration-5.png
  - illustration-6.png
  - image1.png
  - image2.png
  - image3.png
  - video.gif
- doc.md
- localization.md
- saving-images.md
- - .gitignore
  - build.gradle.kts
  - gradle.properties
  - settings.gradle.kts
- - .gitignore
- - custom_cropper.dart
  - localization_override_example.dart
  - main.dart
  - settings_modal.dart
- - .gitignore
  - CMakeLists.txt
  - main.cc
  - my_application.cc
  - my_application.h
- - .gitignore
- - widget_test.dart
- - favicon.png
  - index.html
  - manifest.json
- - .gitignore
  - CMakeLists.txt
- .gitignore
- .metadata
- analysis_options.yaml
- pubspec.lock
- pubspec.yaml
- README.md
- build.dart
- - src.dart
- croppy.dart
- - AssocVector.h
  - constraint.h
  - debug.h
  - errors.h
  - expression.h
  - kiwi.h
  - LICENSE
  - maptype.h
  - row.h
  - shareddata.h
  - solver.h
  - solverimpl.h
  - strength.h
  - symbol.h
  - symbolics.h
  - term.h
  - util.h
  - variable.h
  - version.h
- CMakeLists.txt
- croppy.c
- croppy.h
- fit_polygon_in_quad.cpp
- fit_polygon_in_quad.h
.gitignore
.metadata
analysis_options.yaml
CHANGELOG.md
ffigen.yaml
LICENSE
pubspec.yaml
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Cover image](https://raw.githubusercontent.com/kekland/croppy/master/doc/assets/cover.jpg)

# croppy

[![Pub Version](https://img.shields.io/pub/v/croppy?color=turquoise)](https://pub.dev/packages/croppy)

A fully customizable image cropper for Flutter, with built-in Material and Cupertino croppers.

Check out the example at https://kekland.github.io/croppy.

<p float="left">
  <img src="https://github.com/kekland/croppy/raw/master/doc/assets/video.gif" width="160" />
  <img src="https://github.com/kekland/croppy/raw/master/doc/assets/image1.png" width="160" />
  <img src="https://github.com/kekland/croppy/raw/master/doc/assets/image2.png" width="160" />
  <img src="https://github.com/kekland/croppy/raw/master/doc/assets/image3.png" width="160" />
</p>

Supported platforms:
- Android 
- iOS
- Windows
- Linux (untested, but should work)
- macOS
- Web (uses Dart's Cassowary instead of FFI because there's no FFI support in web)

NOTE: see https://github.com/kekland/croppy/issues/38. Currently I'm very busy with other projects so support might be limited.

## Features

- Material image cropper (similar to Google Photos)
- iOS Photos app-like image cropper
- Support for any linear transformations on the image: scaling, rotating, skewing, flipping, etc
- Completely customizable (will create documentation with later releases)
- Fixed aspect ratios
- Custom cropping shapes
- Kickass animations
- Localization

In progress:

- Image editing module (?) (brightness, contrast, etc)

## Getting started

Install `croppy` from `pub`:

```yaml
dependencies:
  croppy: <latest_version>
```

Enjoy using it :)

## Usage

Currently `croppy` supports a Material (Google Photos-like) and a Cupertino (iOS Photos-like) image croppers:

```dart
final result = await showAdaptiveImageCropper(
    context,
    imageProvider: const NetworkImage('MY_IMAGE_URL'), // Or any other image provider
);

final result = await showMaterialImageCropper(
  context,
  imageProvider: const NetworkImage('MY_IMAGE_URL'), // Or any other image provider
);

final result = await showCupertinoImageCropper(
  context,
  imageProvider: const NetworkImage('MY_IMAGE_URL'), // Or any other image provider
);
```

Voilà! You can now start cropping images.

For a complete runnable example, see `./example`. For the full in-depth documentation, including customization, see the [documentation](./doc/doc.md).

## Localization

`croppy` currently supports the following languages:

- English
- Kazakh
- Russian
- Arabic (thanks @Milad-Akarie)
- Vietnamese (thanks @ptanhVNU)
- Portuguese (thanks @JCKodel)
- Spanish (thanks @Thesergiolg99)
- Chinese (thanks @yohom and @zhushenwudi)
- Hebrew (thanks @kfiross)
- German (thanks @jkoenig134)
- Persian (thanks @mdpe-ir)
- Turkish (thanks @BayramYARIM)
- Polish (thanks @mekkolodziejski)
- Romanian (thanks @AdrianSima)
- Kyrgyz (thanks @warioddly)

If there's a language that you would like to add, please see the [localization](./doc/localization.md) guide.

It's recommended to insert the `CroppyLocalizations.delegate` in your `MaterialApp` or `CupertinoApp`:

```dart
MaterialApp(
  localizationsDelegates: [
    CroppyLocalizations.delegate, // <- This here
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
  ],
  ...
)
```

## Additional information

Feel free to report bugs/issues on GitHub.

If you have questions, you can contact me directly at `kk.erzhan@gmail.com`.

Credits:
- https://github.com/daniyarzt for the `FitAabbInQuadSolver` class