Repolode
TimOliver

TimOliver/TOCropViewController

Контроллер представления iOS для обрезки объектов UIImage: поворот, круглая обрезка и фиксация соотношения сторон — по образцу редактора приложения «Фото».

Звёзды
4,948
Форки
1,027
Открытые issues
106
Последний коммит
24 часа назад

Что это?

TOCropViewController — подкласс UIViewController с открытым исходным кодом для iOS. Он позволяет обрезать фрагменты объектов UIImage и поворачивать изображения с шагом 90 градусов. Контроллер подходит, например, для редактирования фотографий профиля или выделения фрагмента снимка для отправки. По поведению он повторяет редактор приложения «Фото» в iOS, поэтому пользователям будет привычно им пользоваться.

Контроллер может передать обрезанное изображение делегату или сразу открыть UIActivityViewController. Также доступны круглая обрезка, ограничение соотношения сторон, кнопка сброса и настраиваемые анимации открытия и закрытия. Swift-обёртка CropViewController предоставляет более привычный для Swift интерфейс поверх класса Objective-C.

Библиотеку можно установить через CocoaPods, Swift Package Manager, Carthage или вручную скопировав исходные файлы. Требуется iOS 12.0 или новее; библиотека локализована на 28 языков.

Ключевые возможности

  • 01Обрезка перетаскиванием краёв сетки.
  • 02Круглая и прямоугольная обрезка изображений.
  • 03Поворот изображений с шагом 90 градусов.
  • 04Фиксация рамки обрезки с заданным соотношением сторон.
  • 05Передача результата делегату или прямое открытие меню «Поделиться».
  • 06Swift-обёртка в дополнение к классу Objective-C.

Сценарии использования

  • Обрезка аватаров пользователей до круга в приложении для iOS.
  • Добавление этапа обрезки фотографии перед загрузкой или отправкой изображения.
  • Создание встроенного редактора изображений с процессом редактирования, как в приложении «Фото» для iOS.

Быстрый старт

  1. 1

    Добавьте pod в Podfile (Objective-C)

    pod 'TOCropViewController'
  2. 2

    Или добавьте pod для Swift в Podfile (Swift)

    pod 'CropViewController'
  3. 3

    Создайте TOCropViewController с вашим UIImage, задайте delegate и представьте его модально в коде приложения

Что важно знать

  • Поддерживается только iOS; требуется iOS 12.0 или новее.
  • Режимы visionOS и Mac Catalyst включены, но официально не поддерживаются.

В подборках

Темы

Частые вопросы

Что такое TOCropViewController?
Контроллер представления iOS для обрезки объектов UIImage: поворот, круглая обрезка и фиксация соотношения сторон — по образцу редактора приложения «Фото». TOCropViewController — подкласс UIViewController с открытым исходным кодом для iOS. Он позволяет обрезать фрагменты объектов UIImage и поворачивать изображения с шагом 90 градусов. Контроллер подходит, например, для редактирования фотографий профиля или выделения фрагмента снимка для отправки. По поведению он повторяет редактор приложения «Фото» в iOS, поэтому пользователям будет привычно им пользоваться.
TOCropViewController можно использовать бесплатно? Какая у него лицензия?
TOCropViewController распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
TOCropViewController всё ещё поддерживается?
Активно поддерживается. Последний коммит в TOCropViewController — 6 нояб. 2026 г..
Для чего можно использовать TOCropViewController?
Обрезка аватаров пользователей до круга в приложении для iOS. Добавление этапа обрезки фотографии перед загрузкой или отправкой изображения. Создание встроенного редактора изображений с процессом редактирования, как в приложении «Фото» для iOS.
Как установить TOCropViewController?
Добавьте pod в Podfile (Objective-C): pod 'TOCropViewController' Или добавьте pod для Swift в Podfile (Swift): pod 'CropViewController' Создайте TOCropViewController с вашим UIImage, задайте delegate и представьте его модально в коде приложения
Где скачать TOCropViewController?
Исходный код и инструкции по установке — на GitHub: https://github.com/TimOliver/TOCropViewController

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Высокопроизводительный модуль обработки изображений для Node.js: меняет размер и конвертирует JPEG, PNG, WebP, AVIF и TIFF с помощью libvips.

32,8 тыс.+20 за неделю1,5 тыс.JavaScriptApache-2.0Активно поддерживаетсяОбновлён позавчера

Фреймворк логирования для платформ Apple (macOS, iOS, tvOS, watchOS, visionOS), который направляет сообщения в несколько логгеров: консоль, файлы и пользовательские бэкенды.

13,3 тыс.+3 за неделю2,3 тыс.Objective-CBSD-3-ClauseОбновлён позавчера