OpalImagePicker

KO | EN

gitlite — search

#python #react #ai #go #machine-learning #rust #linux #macos #cli #kubernetes #awesome-list #security #ios #open-source

OpalImagePicker

(★ 184)

A multiple image picker for iOS, written in Swift

File Explorer

Download Latest Version (.zip)

- - Bundle+Helper.swift
  - ImagePickerCollectionViewCell.swift
  - OpalImagePickerCollectionViewLayout.swift
  - OpalImagePickerConfiguration.swift
  - OpalImagePickerController.swift
  - OpalImagePickerRootViewController.swift
  - TimeInterval+String.swift
  - UIView+Helper.swift
  - UIViewController+OpalImagePicker.swift
- - AppDelegate.swift
  - Info.plist
  - ViewController.swift
- - contents.xcworkspacedata
- project.pbxproj
- - AppDelegate.swift
  - DelegateExampleViewController.swift
  - Info.plist
  - ViewController.swift
- - project.pbxproj
- - contents.xcworkspacedata
- - Info.plist
  - OpalImagePickerDemoTests.swift
- - Manifest.lock
- .swiftlint.yml
- Podfile
- Podfile.lock
- Info.plist
- MockOpalImagePickerControllerDelegate.swift
- OpalImagePickerControllerTest.swift
- OpalImagePickerRootViewControllerTest.swift
- OpalImagePickerPresentation.jpg
.gitignore
.swiftlint.yml
CHANGELOG.MD
LICENSE
OpalImagePicker.podspec
Package.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![OpalImagePicker](https://github.com/opalorange/OpalImagePicker/blob/master/Resources/OpalImagePickerPresentation.jpg)

[![Version](https://img.shields.io/cocoapods/v/OpalImagePicker.svg?style=flat)](http://cocoadocs.org/docsets/OpalImagePicker)
[![License](https://img.shields.io/cocoapods/l/OpalImagePicker.svg?style=flat)](http://cocoadocs.org/docsets/OpalImagePicker)

## Description

**OpalImagePicker** is a multiple selection Image Picker for iOS written in Swift. Meant to be a drop in replacement for UIImagePickerController. Compatible with both Swift and Objective-C.

##  Swift 4 and 5 Compatibility
- **Swift 5.0**: >= 2.1.0 - Latest is 2.1.0 [Download here](https://github.com/opalorange/OpalImagePicker/releases/tag/2.1.0).
- **Swift 4.2**: >= 2.0.0 - Latest is 2.0.0 [Download here](https://github.com/opalorange/OpalImagePicker/releases/tag/2.0.0).
- **Swift 4.0**: >= 1.5.0 - Latest is 1.7.1 [Download here](https://github.com/opalorange/OpalImagePicker/releases/tag/1.7.1).
CocoaPods be sure to fix the release (`pod 'OpalImagePicker', '~> 2.1.0'`)

## Usage

**OpalImagePicker** is presented much like UIImagePickerController. As a normal View Controller.

```swift
let imagePicker = OpalImagePickerController()   
presentOpalImagePickerController(imagePicker, animated: true, 
	select: { (assets) in
		//Select Assets
	}, cancel: {
		//Cancel
	})
```

```swift
let imagePicker = OpalImagePickerController()
imagePicker.imagePickerDelegate = self        
present(imagePicker, animated: true, completion: nil)
```
**OpalImagePicker** has three delegate methods to notify you when images have been selected, or the picker has been cancelled. This is only necessary if you choose not to use the **presentOpalImagePickerController(_:animated:select:cancel:completion:)** function.

```swift
optional func imagePicker(_ picker: OpalImagePickerController, didFinishPickingAssets assets: [PHAsset])
optional func imagePickerDidCancel(_ picker: OpalImagePickerController)
```

**OpalImagePicker** also allows you to use external images. You may want to use images from Facebook, Instagram, or Twitter for example. You can do this either using the delegate methods below or the following function in Swift **presentOpalImagePickerController(_: animated: maximumSelectionsAllowed: numberOfExternalItems: externalItemsTitle: externalURLForIndex: selectAssets: selectExternalURLs: cancel: completion:)** function.

```swift
optional func imagePickerNumberOfExternalItems(_ picker: OpalImagePickerController) -> Int
optional func imagePicker(_ picker: OpalImagePickerController, imageURLforExternalItemAtIndex index: Int) -> URL?    
optional func imagePickerTitleForExternalItems(_ picker: OpalImagePickerController) -> String
optional func imagePicker(_ picker: OpalImagePickerController, didFinishPickingExternalURLs urls: [URL])
```

**OpalImagePicker** supports allowing users to customize user interface features

```swift
let imagePicker = OpalImagePickerController()

//Change color of selection overlay to white
imagePicker.selectionTintColor = UIColor.white.withAlphaComponent(0.7)

//Change color of image tint to black
imagePicker.selectionImageTintColor = UIColor.black

//Change image to X rather than checkmark
imagePicker.selectionImage = UIImage(named: "x_image")

//Change status bar style
imagePicker.statusBarPreference = UIStatusBarStyle.lightContent

//Limit maximum allowed selections to 5
imagePicker.maximumSelectionsAllowed = 5

//Only allow image media type assets
imagePicker.allowedMediaTypes = Set([PHAssetMediaType.image])

//Change default localized strings displayed to the user
let configuration = OpalImagePickerConfiguration()
configuration.maximumSelectionsAllowedMessage = NSLocalizedString("You cannot select that many images!", comment: "")
imagePicker.configuration = configuration
```

## Installation

**OpalImagePicker** is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod 'OpalImagePicker'
```

## Requirements

- iOS 8.0+
- Xcode 9.0+
- Swift 4 to 5.0

## Author

[OpalOrange](http://opalorange.com) made this with ❤

## Contribute

We would love you to contribute to **OpalImagePicker**

## License

**OpalImagePicker** is available under the MIT license. See the [LICENSE](https://github.com/opalorange/OpalImagePicker/blob/master/LICENSE.md) file for more info.

OpalImagePicker

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

OpalImagePicker

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README