Repolode
Enviar
TimOliver

TimOliver/TOCropViewController

Um controlador de visualização para iOS que recorta objetos UIImage, com rotação, recorte circular e proporção fixa, inspirado no editor do app Fotos.

Ver no GitHub
Estrelas
4,948
Forks
1,027
Issues abertas
106
Último commit
há 9 horas

O que é?

TOCropViewController é uma subclasse de UIViewController de código aberto para iOS que permite recortar partes de objetos UIImage e fazer rotações básicas de 90 graus. É indicado para situações como editar fotos de perfil ou compartilhar parte de uma foto, e seu comportamento foi projetado para se parecer com o editor do app Fotos do iOS, tornando a experiência familiar para os usuários.

O controlador pode retornar a imagem recortada a um delegate ou enviá-la diretamente para um UIActivityViewController. Também oferece recorte circular, limitação da proporção, um botão para redefinir e animações personalizadas de abertura e fechamento. Um wrapper Swift chamado CropViewController oferece uma interface mais idiomática para Swift sobre a classe Objective-C.

A biblioteca pode ser instalada pelo CocoaPods, Swift Package Manager, Carthage ou copiando manualmente os arquivos-fonte. Requer iOS 12.0 ou posterior e está localizada em 28 idiomas.

Recursos principais

  • 01Recorte arrastando as bordas de uma sobreposição em grade.
  • 02Recorte imagens circulares, além das retangulares.
  • 03Gire imagens em incrementos de 90 graus.
  • 04Fixe a área de recorte em uma proporção específica.
  • 05Retorne o resultado por meio de um delegate ou abra diretamente a folha de compartilhamento.
  • 06Oferece um wrapper Swift junto com a classe Objective-C.

Casos de uso

  • Permitir que usuários recortem fotos de perfil em formato circular em um app para iOS.
  • Adicionar uma etapa de recorte de fotos antes de enviar ou compartilhar uma imagem.
  • Criar um editor de imagens no app que siga o fluxo de edição do app Fotos do iOS.

Início rápido

  1. 1

    Adicione o pod ao seu Podfile (Objective-C)

    pod 'TOCropViewController'
  2. 2

    Ou adicione o pod para Swift ao seu Podfile (Swift)

    pod 'CropViewController'
  3. 3

    Crie um TOCropViewController com seu UIImage, defina um delegate e apresente-o modalmente no código do app

Antes de usar

  • É compatível apenas com iOS e requer iOS 12.0 ou superior.
  • Os modos visionOS e Mac Catalyst estão habilitados, mas não têm suporte oficial.

Em coleções

Bibliotecas e ferramentas de visão computacional

Tópicos

#ios#image-processing#uikit#objective-c#swift#cropping#mobile-ui#cocoapods#crop#crop-image

Perguntas frequentes

O que é TOCropViewController?
Um controlador de visualização para iOS que recorta objetos UIImage, com rotação, recorte circular e proporção fixa, inspirado no editor do app Fotos. TOCropViewController é uma subclasse de UIViewController de código aberto para iOS que permite recortar partes de objetos UIImage e fazer rotações básicas de 90 graus. É indicado para situações como editar fotos de perfil ou compartilhar parte de uma foto, e seu comportamento foi projetado para se parecer com o editor do app Fotos do iOS, tornando a experiência familiar para os usuários.
TOCropViewController é gratuito? Qual é a licença?
TOCropViewController é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
TOCropViewController ainda é mantido?
Manutenção ativa. O último commit de TOCropViewController foi em 6 de nov. de 2026.
Para que posso usar TOCropViewController?
Permitir que usuários recortem fotos de perfil em formato circular em um app para iOS. Adicionar uma etapa de recorte de fotos antes de enviar ou compartilhar uma imagem. Criar um editor de imagens no app que siga o fluxo de edição do app Fotos do iOS.
Como instalar TOCropViewController?
Adicione o pod ao seu Podfile (Objective-C): pod 'TOCropViewController' Ou adicione o pod para Swift ao seu Podfile (Swift): pod 'CropViewController' Crie um TOCropViewController com seu UIImage, defina um delegate e apresente-o modalmente no código do app
Onde consigo TOCropViewController?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/TimOliver/TOCropViewController

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados