Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hyperoslo/ImagePicker
:camera: Reinventing the way ImagePicker works.
https://github.com/hyperoslo/ImagePicker
imagepicker ios swift
Last synced: 9 days ago
JSON representation
:camera: Reinventing the way ImagePicker works.
- Host: GitHub
- URL: https://github.com/hyperoslo/ImagePicker
- Owner: hyperoslo
- License: other
- Created: 2015-08-04T08:13:33.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-08-27T11:37:38.000Z (2 months ago)
- Last Synced: 2024-10-15T13:41:26.641Z (19 days ago)
- Topics: imagepicker, ios, swift
- Language: Swift
- Homepage:
- Size: 13.8 MB
- Stars: 4,866
- Watchers: 100
- Forks: 677
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Support: SupportFiles/Info.plist
Awesome Lists containing this project
- awesome-swift-cn - ImagePicker - A nicely designed and super easy to use ImagePicker. (Libs / UI)
- awesome-swift - ImagePicker - A nicely designed and super easy to use ImagePicker. :camera: (UI)
README
[](https://github.com/Carthage/Carthage)
[](http://cocoadocs.org/docsets/ImagePicker)
[](http://cocoadocs.org/docsets/ImagePicker)
## Description
**ImagePicker** is an all-in-one camera solution for your iOS app. It lets your users select images from the library and take pictures at the same time. As a developer you get notified of all the user interactions and get the beautiful UI for free, out of the box, it's just that simple.
**ImagePicker** has been optimized to give a great user experience, it passes around referenced images instead of the image itself which makes it less memory consuming. This is what makes it smooth as butter.
## Usage
**ImagePicker** works as a normal controller, just instantiate it and present it.
```swift
let imagePickerController = ImagePickerController()
imagePickerController.delegate = self
present(imagePickerController, animated: true, completion: nil)
```
**ImagePicker** has three delegate methods that will inform you what the users are up to:
```swift
func wrapperDidPress(_ imagePicker: ImagePickerController, images: [UIImage])
func doneButtonDidPress(_ imagePicker: ImagePickerController, images: [UIImage])
func cancelButtonDidPress(_ imagePicker: ImagePickerController)
```
**ImagePicker** supports limiting the amount of images that can be selected, it defaults
to zero, which means that the user can select as many images as he/she wants.
```swift
let imagePickerController = ImagePickerController()
imagePickerController.imageLimit = 5
```
### Optional bonus
##### Configuration
You can inject `Configuration` instance to ImagePicker, which allows you to configure text, colors, fonts and camera features
```swift
var configuration = Configuration()
configuration.doneButtonTitle = "Finish"
configuration.noImagesTitle = "Sorry! There are no images here!"
configuration.recordLocation = false
let imagePicker = ImagePickerController(configuration: configuration)
```
##### Resolve assets
As said before, **ImagePicker** works with referenced images, that is really powerful because it lets you download the asset and choose the size you want. If you want to change the default implementation, just add a variable in your controller.
```swift
public var imageAssets: [UIImage] {
return AssetManager.resolveAssets(imagePicker.stack.assets)
}
```
And when you call any delegate method that returns images, add in the first line:
```swift
let images = imageAssets
```
## FAQ
### Limiting selection to 1 item
```swift
let config = Configuration()
config.allowMultiplePhotoSelection = false
let imagePicker = ImagePickerController(configuration: config)
imagePicker.delegate = self
```
## Installation
**ImagePicker** is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'ImagePicker'
```
**ImagePicker** is also available through [Carthage](https://github.com/Carthage/Carthage).
To install just write into your Cartfile:
```ruby
github "hyperoslo/ImagePicker"
```
## Author
[Hyper](http://hyper.no) made this with ❤️
## Contribute
We would love you to contribute to **ImagePicker**, check the [CONTRIBUTING](https://github.com/hyperoslo/ImagePicker/blob/master/CONTRIBUTING.md) file for more info.
## License
**ImagePicker** is available under the MIT license. See the [LICENSE](https://github.com/hyperoslo/ImagePicker/blob/master/LICENSE.md) file for more info.