# timoliver/tocropviewcontroller

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/timoliver-tocropviewcontroller).**

4,932 stars · 1,023 forks · Objective-C · MIT

## Links

- GitHub: https://github.com/TimOliver/TOCropViewController
- awesome-repositories: https://awesome-repositories.com/repository/timoliver-tocropviewcontroller.md

## Description

TOCropViewController is a UIKit view controller designed for image cropping and rotation within iOS applications. It provides a visual image editing interface that allows for the extraction of specific image sections using a draggable grid overlay.

The component supports custom aspect ratio selection and circular masking to ensure photos fit predefined layouts, such as those required for profile picture editing. It includes a dedicated interface for changing image orientation and performing rotation adjustments.

The tool handles image processing by translating UI grid positions into pixel coordinates and exporting the resulting cropped content. Communication with the calling application is managed through a delegate-based data transfer protocol.

## Tags

### User Interface & Experience

- [Image Cropping Components](https://awesome-repositories.com/f/user-interface-experience/image-cropping-components.md) — Provides a specialized UIKit component for defining and adjusting crop areas with a draggable grid overlay. ([source](https://github.com/timoliver/tocropviewcontroller#readme))
- [Image Editing Interfaces](https://awesome-repositories.com/f/user-interface-experience/image-editing-interfaces.md) — Offers a visual tool for extracting image sections using custom aspect ratios and circular masks.
- [View-to-Image Coordinate Mapping](https://awesome-repositories.com/f/user-interface-experience/view-to-image-coordinate-mapping.md) — Implements logic to translate screen touch and grid coordinates into raw image pixel coordinates for precise cropping.

### Graphics & Multimedia

- [Rotation and Shear transforms](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/rendering/coordinate-viewport-transformations/affine-transformation-matrices/image-geometric-transformations/image-rotation/rotation-and-shear-transforms.md) — Provides geometric transformations to update image orientation and grid alignment through rotation.
- [Crop Area Masks](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/tile-map-renderers/raster-and-vector-tile-renderers/layer-based-composition/animation-layer-compositing/ui-masking-layers/crop-area-masks.md) — Uses shape masks and clipping paths to render the selected crop area as a circle or specific aspect ratio.
- [Cropped Image Exporters](https://awesome-repositories.com/f/graphics-multimedia/image-editing-processing/image-editors/image-cropping-tools/cropped-image-exporters.md) — Provides utilities to export the final cropped image data to internal delegates or system share sheets. ([source](https://github.com/timoliver/tocropviewcontroller#readme))
- [Image Orientation Manipulators](https://awesome-repositories.com/f/graphics-multimedia/image-orientation-manipulators.md) — Includes a dedicated user interface for adjusting the visual orientation of images via rotation. ([source](https://github.com/timoliver/tocropviewcontroller#readme))
- [Preset Aspect Ratios](https://awesome-repositories.com/f/graphics-multimedia/image-editing-processing/image-editors/image-cropping-tools/preset-aspect-ratios.md) — Allows users to restrict image cropping to predefined aspect ratios to ensure photos fit specific layouts.

### Mobile Development

- [iOS Photo Manipulation](https://awesome-repositories.com/f/mobile-development/ios-photo-manipulation.md) — Enables changing the orientation and framing of images to prepare them for storage or sharing on iOS.

### Networking & Communication

- [Profile Photo Framing](https://awesome-repositories.com/f/networking-communication/telegram-bot-frameworks/profile-editing/bot-profile-links/profile-photo-uploads/profile-photo-framing.md) — Provides a dedicated interface for cropping and rotating photos to fit the dimensions required for account avatars.

### Part of an Awesome List

- [Image Processing](https://awesome-repositories.com/f/awesome-lists/media/image-processing.md) — View controller for image cropping.
- [Media Processing](https://awesome-repositories.com/f/awesome-lists/media/media-processing.md) — Image cropping view controller.