FilterCam
FilterCam copied to clipboard
A video capture framework that can easily apply your custom filters.
Overview
FilterCam is a simple iOS camera framework for recording videos with custom CIFilters applied. Also FilterCam is made very inspired by SwiftyCam.
Features
FilterCam | |
---|---|
:+1: | Support iOS 10.0+ |
:movie_camera: | Video capture |
:eyeglasses: | Custom filter |
:chart_with_upwards_trend: | Manual image quality settings |
:tada: | Front and rear camera support |
:flashlight: | Support torch |
:eyes: | Supports manual focus |
:speaker: | Background audio support |
Requirements
-
iOS 10.0+
-
Swift 4.1+
License
FilterCam is available under the MIT license. See the LICENSE file for more info.
Installation
Carthage:
Add this to Cartfile
github "nkmrh/FilterCam"
$ carthage update FilterCam
Cocoapods:
FilterCam is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "FilterCam"
Manual Installation:
Simply copy the contents of the FilterCam folder into your project.
Usage
Using FilterCam is very simple.
Prerequisites:
As of iOS 10, Apple requires the additon of the NSCameraUsageDescription and NSMicrophoneUsageDescription strings to the info.plist of your application. Example:
<key>NSCameraUsageDescription</key>
<string>To record video</string>
<key>NSMicrophoneUsageDescription</key>
<string>To record audio with video</string>
Getting Started:
If you install FilterCam from Cocoapods, be sure to import the module into your View Controller:
import FilterCam
FilterCam is a drop-in convenience framework. To create a Camera instance, create a new UIViewController subclass. Replace the UIViewController subclass declaration with FilterCamViewController
:
class MyCameraViewController : FilterCamViewController
That is all that is required to setup the AVSession for photo and video capture. FilterCam will prompt the user for permission to use the camera/microphone, and configure both the device inputs and outputs.
Capture
Capturing Video is just as easy. To begin recording video, call the startRecording
function:
startRecording()
To end the capture of a video, call the stopRecording
function:
stopRecording()
Delegate
You must implement the FilterCamViewControllerDelegate
and set the cameraDelegate
to your view controller instance:
class MyCameraViewController : FilterCamViewController, FilterCamViewControllerDelegate {
override func viewDidLoad() {
super.viewDidLoad()
cameraDelegate = self
}
...
}
Delegate methods:
func filterCamDidStartRecording(_ filterCam: FilterCamViewController) {
// Called when startRecording() is called
}
func filterCamDidFinishRecording(_ filterCame: FilterCamViewController) {
// Called when stopRecording() is called
}
func filterCam(_ filterCam: FilterCamViewController, didFinishWriting outputURL: URL) {
// Called when stopRecording() is called and the video is finished processing
// Returns a URL in the temporary directory where video is stored
}
func filterCam(_ filterCam: FilterCamViewController, didFocusAtPoint tapPoint: CGPoint) {
// Called when a user initiates a tap gesture on the preview layer
// Returns a CGPoint of the tap location on the preview layer
}
func filterCam(_ filterCam: FilterCamViewController, didFailToRecord error: Error) {
// Called when recorder fail to record
}
Torch
The torch can be enabled by changing the torchLevel property:
torchLevel = 1
Torch level specifies the value between 0.0 and 1.0.
Switching Camera
By default, FilterCam will launch to the rear facing camera. This can be changed by changing the defaultCamera property in viewDidLoad:
devicePosition = .front
Configuration
Apply filter
You can apply custom filters by specifying an array of filters in the filters property:
filters = [CIFilter(name: "CIPhotoEffectInstant")!, CIFilter(name: "CIPhotoEffectNoir")!]
filters property type is an array of CIFilter. It is applied sequentially from the first filter.
Preview view
If you want to specify the preview frame, you can use custom initializer:
MyCameraViewController(previewViewRect: CGRect)
Video Quality
Video quality can be set by the videoQuality property of FilterCamViewController. The choices available AVCaptureSessionPreset.
Contact
If you have any questions, requests, or enhancements, feel free to submit a pull request, create an issue.
Hajime Nakamura [email protected]