[Free] ImageCropView - An Image Cropper With Customizations

Extensions
,
1

crop
crop512×512 11.6 KB

ImageCropView

An extension to crop an image with customizations. Developed by The K Studio.

:memo: Specifications

:package: Package: com.thekstudio.imagecropview
:floppy_disk: Size: 40.70 KB
:gear: Version: 1.0
:iphone: Minimum API Level: 14
:date: Updated On: 2025-04-06T18:30:00Z
:computer: Built & documented using: FAST-CLI v2.8.2
:bookmark_tabs: Uses Library: SimpleCropView

Key Features:

  • 📥 Image Loading
    • Load images from storage into the crop view dynamically.

  • ✂️ Crop Modes
    • Supports multiple cropping styles:
    • Fit Image, Square, Free, Circle
    • Fixed ratios: 4:3, 3:4, 16:9, 9:16

  • 🎨 Customizable Appearance
    • Set background, overlay, frame, handle, and guide colors.
    • Adjust stroke weights for frame and guide.
    • Customize handle size and visibility.
    • Set initial frame scale and minimum frame size.

  • 📦 Output Customization
    • Choose between PNG or JPEG formats.
    • Set image compression quality (0–100).

  • 🔄 Rotate Image
    • Built-in function to rotate image 90° clockwise.

  • 💾 Save Cropped Image
    • Crop the selected area and save to any specified file path.

Events:

ImageCropView has total 2 events.

AfterCrop

AfterCrop_Event

Triggered after the image is cropped successfully.

Parameter Type
outputPath text

OnError

OnError_Event

Triggered when an error occurs during cropping.

Parameter Type
errorMessage text

Methods:

ImageCropView has total 4 methods.

Initialize

Initialize_Method

Initializes the crop view in the given container and sets the image from the specified file path.

Parameter Type
container component
imagePath text

CropMode

CropMode_Method

Set the crop mode.

Parameter Type
mode CropModes (helper blocks)

RotateImage

RotateImage_Method

Rotates the image clockwise by 90 degrees.

CropImage

CropImage_Method

Crops the image and saves it to the specified output path.

Parameter Type
outputPath text

Setters:

ImageCropView has total 13 setter properties.

CompressFormat

CompressFormat_Set_Property

Set the compress format.

  • Input type: text

CompressQuality

CompressQuality_Set_Property

Set the compress quality (0-100, default 90).

  • Input type: number

BackgroundColor

BackgroundColor_Set_Property

Set the background color (default WHITE).

  • Input type: number

OverlayColor

OverlayColor_Set_Property

Set the overlay color (default DIM TRANSPARENT).

  • Input type: number

FrameColor

FrameColor_Set_Property

Set the frame color (default WHITE).

  • Input type: number

HandleColor

HandleColor_Set_Property

Set the handle color (default WHITE).

  • Input type: number

GuideColor

GuideColor_Set_Property

Set the guide color (default WHITE).

  • Input type: number

FrameStrokeWeight

FrameStrokeWeight_Set_Property

Set the frame stroke weight in dp (default 1).

  • Input type: number

GuideStrokeWeight

GuideStrokeWeight_Set_Property

Set the guide stroke weight in dp (default 1).

  • Input type: number

HandleSize

HandleSize_Set_Property

Set the handle size in dp (default 20).

  • Input type: number

HandleVisible

HandleVisible_Set_Property

Toggle handle visibility. True shows handles, false hides them.

  • Input type: boolean

MinFrameSize

MinFrameSize_Set_Property

Set the minimum frame size in dp (default 50).

  • Input type: number

InitialFrameScale

InitialFrameScale_Set_Property

Set the initial frame scale (0.01 to 1.0, default 0.75).

  • Input type: number

PREVIEW:

68747470733a2f2f7261772e6769746875622e636f6d2f77696b692f4973736569416f6b692f53696d706c6543726f70566965772f696d616765732f312e312e302f64656d6f5f62617369635f75736167652e676966

Check docs at: SimpleCropView/README.md at master · igreenwood/SimpleCropView · GitHub

DOWNLOAD:

v1: com.thekstudio.imagecropview.aix (40.7 KB)

If you need an alternative with light weight extension (without external library) - Image Cropper Extension

6 Likes