Repolode
TimOliver

TimOliver/TOCropViewController

Photos 앱 편집기를 본떠 회전, 원형 자르기, 가로세로 비율 고정을 지원하는 UIImage 자르기용 iOS 뷰 컨트롤러입니다.

스타
4,948
포크
1,027
열린 이슈
106
마지막 커밋
10시간 전

어떤 프로젝트인가요?

TOCropViewController는 iOS용 오픈 소스 UIViewController 하위 클래스로, 사용자가 UIImage의 일부를 자르고 기본적인 90도 회전을 할 수 있게 해줍니다. 프로필 사진을 편집하거나 사진의 일부를 공유하는 경우 등을 위한 것으로, 사용자가 익숙하게 느끼도록 iOS Photos 앱 편집기와 동작이 비슷하게 설계되었습니다.

컨트롤러는 자른 이미지를 delegate에 전달하거나 UIActivityViewController로 바로 넘길 수 있습니다. 원형 자르기, 가로세로 비율 제한, 재설정 버튼, 사용자 지정 열기 및 닫기 애니메이션도 제공합니다. CropViewController라는 Swift 래퍼는 Objective-C 클래스 위에 Swift에 더 자연스러운 인터페이스를 제공합니다.

이 라이브러리는 CocoaPods, Swift Package Manager, Carthage를 통해 설치하거나 소스 파일을 직접 복사해 사용할 수 있습니다. iOS 12.0 이상이 필요하며, 28개 언어로 현지화되어 있습니다.

핵심 기능

  • 01그리드 오버레이의 가장자리를 드래그해 자릅니다.
  • 02직사각형 이미지뿐 아니라 원형 이미지도 자를 수 있습니다.
  • 03이미지를 90도 단위로 회전합니다.
  • 04자르기 영역을 고정된 가로세로 비율로 유지합니다.
  • 05결과를 delegate로 반환하거나 공유 시트를 바로 엽니다.
  • 06Objective-C 클래스와 함께 Swift 래퍼를 제공합니다.

활용 사례

  • iOS 앱에서 사용자가 프로필 아바타를 원형으로 자를 수 있게 합니다.
  • 이미지를 업로드하거나 공유하기 전에 사진 자르기 단계를 추가합니다.
  • iOS Photos의 편집 흐름을 따르는 인앱 이미지 편집기를 만듭니다.

빠른 시작

  1. 1

    Podfile에 pod를 추가합니다(Objective-C)

    pod 'TOCropViewController'
  2. 2

    또는 Swift용 pod를 Podfile에 추가합니다(Swift)

    pod 'CropViewController'
  3. 3

    UIImage를 사용해 TOCropViewController를 만들고 delegate를 설정한 다음, 앱 코드에서 모달 방식으로 표시합니다

사용 전 알아둘 점

  • iOS만 대상으로 하며 iOS 12.0 이상이 필요합니다.
  • visionOS 및 Mac Catalyst 모드는 활성화되어 있지만 공식 지원 대상은 아닙니다.

포함된 컬렉션

토픽

자주 묻는 질문

TOCropViewController은(는) 무엇인가요?
Photos 앱 편집기를 본떠 회전, 원형 자르기, 가로세로 비율 고정을 지원하는 UIImage 자르기용 iOS 뷰 컨트롤러입니다. TOCropViewController는 iOS용 오픈 소스 UIViewController 하위 클래스로, 사용자가 UIImage의 일부를 자르고 기본적인 90도 회전을 할 수 있게 해줍니다. 프로필 사진을 편집하거나 사진의 일부를 공유하는 경우 등을 위한 것으로, 사용자가 익숙하게 느끼도록 iOS Photos 앱 편집기와 동작이 비슷하게 설계되었습니다.
TOCropViewController은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
TOCropViewController은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
TOCropViewController은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. TOCropViewController의 마지막 커밋은 2026년 11월 6일입니다.
TOCropViewController은(는) 어디에 사용할 수 있나요?
iOS 앱에서 사용자가 프로필 아바타를 원형으로 자를 수 있게 합니다. 이미지를 업로드하거나 공유하기 전에 사진 자르기 단계를 추가합니다. iOS Photos의 편집 흐름을 따르는 인앱 이미지 편집기를 만듭니다.
TOCropViewController는 어떻게 설치하나요?
Podfile에 pod를 추가합니다(Objective-C): pod 'TOCropViewController' 또는 Swift용 pod를 Podfile에 추가합니다(Swift): pod 'CropViewController' UIImage를 사용해 TOCropViewController를 만들고 delegate를 설정한 다음, 앱 코드에서 모달 방식으로 표시합니다
TOCropViewController은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/TimOliver/TOCropViewController

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트