Repolode
TimOliver

TimOliver/TOCropViewController

写真アプリの編集画面を手本に、UIImageの切り抜き、回転、円形切り抜き、アスペクト比の固定に対応するiOS用ViewController。

スター
4,948
フォーク
1,027
未解決の Issue
106
最終コミット
4 時間前

これは何?

TOCropViewControllerは、UIImageの一部を切り抜いたり、90度単位で回転したりできる、iOS向けのオープンソースUIViewControllerサブクラスです。プロフィール写真の編集や写真の一部の共有などを想定しており、iOSの写真アプリの編集画面に合わせた動作で、ユーザーが使い慣れた操作感を提供します。

切り抜いた画像は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の写真アプリの編集フローに沿ったアプリ内画像エディターを構築する。

クイックスタート

  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 とは?
写真アプリの編集画面を手本に、UIImageの切り抜き、回転、円形切り抜き、アスペクト比の固定に対応するiOS用ViewController。 TOCropViewControllerは、UIImageの一部を切り抜いたり、90度単位で回転したりできる、iOS向けのオープンソースUIViewControllerサブクラスです。プロフィール写真の編集や写真の一部の共有などを想定しており、iOSの写真アプリの編集画面に合わせた動作で、ユーザーが使い慣れた操作感を提供します。
TOCropViewController は無料で使えますか?ライセンスは?
TOCropViewController は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
TOCropViewController は今もメンテナンスされていますか?
活発にメンテナンス中。TOCropViewController の最終コミットは 2026年11月6日 です。
TOCropViewController は何に使えますか?
iOSアプリで、ユーザーがプロフィール画像を円形に切り抜けるようにする。 画像のアップロードや共有の前に、写真の切り抜き手順を追加する。 iOSの写真アプリの編集フローに沿ったアプリ内画像エディターを構築する。
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 の数値は毎日更新されます。

関連プロジェクト