ca-archived / iOS-NBUImagePicker

Modular image picker with Simulator-compatible AVFondation camera, assets library, filters and more.
http://cyberagent.github.io/iOS-NBUImagePicker
Apache License 2.0
193 stars 48 forks source link
assetslibrary filter gallery gpuimage image-picker ios modular

NBUImagePicker

Platform: iOS Version: 1.6.0 License: Apache 2.0 Dependency Status Build Status

Modular and fully customizable UIImagePickerController replacement with Simulator-compatible AVFondation camera, AssetsLibrary and custom directory assets' browser, and image cropping, filters and gallery.

Uses NBUCore and NBUKit. Supports NBULog.

Demo

A demo project is included in the repository.

Features

Image Picker

Block-based UIImagePickerController replacement with as many/few features as you need.

Screenshot 1

Enable/disable modules or use them stand-alone.

Camera

Customizable AVFoundation-based camera UIView.

Can be embeded into any superview, custom UIViewController or used along NBUCameraViewController. It even takes mock pictures in the iOS Simulator!

Screenshot 2 Screenshot 3

Assets

Multiple classes of all three MVC categories to simplify access to AssetsLibrary while observing its change notifications to stay always in a valid state.

Also support for local assets: Images in custom directories that are displayed like regular Assets Library albums.

Screenshot 4 Screenshot 5

Image Editing

Customizable views and controllers to modify filter and crop images.

Screenshot 6

Uses filters from CoreImage and GPUImage and can be extended to other libraries as well.

Image Gallery

Image slideshow in development inspired by FGallery.

Screenshot 7

Customization

The main goal of NBUImagePicker is to be fully customizable and easy to extend.

Change element's sizes, position, customize picker workflow, add/remove/rename filters, localize for other languages, use cropping features from other libraries, etc.

Screenshot 9 Screenshot 10

Screenshot 8

Installation

Add the following to your CocoaPods' Podfile:

platform :ios, '8.0'
use_frameworks!

# Recommended to keep GPUImage up-to-date
pod 'GPUImage', :head

#pod 'NBUImagePicker'

# Optional for dynamic logging
pod 'NBULog'

# Optional for on-device log console
pod 'LumberjackConsole'

Stand-Alone Modules

Manually specify only the components you need:

pod 'NBUImagePicker/Camera'  # AVFoundation-based camera
pod 'NBUImagePicker/Assets'  # AssetsLibrary and custom path asset selection
pod 'NBUImagePicker/Filters' # CoreImage and GPUImage filters' wrapping
pod 'NBUImagePicker/Image'   # Croping
pod 'NBUImagePicker/Gallery' # Image preview
pod 'NBUImagePicker/Picker'  # Combinations of the modules above except for filters

Documentation

http://cocoadocs.org/docsets/NBUImagePicker/

License

Copyright (c) 2012-2017 CyberAgent Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. 
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.