https://github.com/nkmrh/filtercam
A video capture framework that can easily apply your custom filters.
https://github.com/nkmrh/filtercam
avfoundation camera ios swift4 video-capture video-processing video-recording
Last synced: 3 months ago
JSON representation
A video capture framework that can easily apply your custom filters.
- Host: GitHub
- URL: https://github.com/nkmrh/filtercam
- Owner: nkmrh
- License: mit
- Created: 2018-06-16T05:36:19.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-06-02T06:30:16.000Z (over 6 years ago)
- Last Synced: 2025-04-06T15:48:42.267Z (6 months ago)
- Topics: avfoundation, camera, ios, swift4, video-capture, video-processing, video-recording
- Language: Swift
- Homepage:
- Size: 9.99 MB
- Stars: 90
- Watchers: 5
- Forks: 19
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Overview
FilterCam is a simple iOS camera framework for recording videos with custom CIFilters applied. Also FilterCam is made very inspired by [SwiftyCam](https://github.com/Awalz/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:
```xml
NSCameraUsageDescription
To record video
NSMicrophoneUsageDescription
To record audio with video
```
### Getting Started:
If you install FilterCam from Cocoapods, be sure to import the module into your View Controller:
```swift
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`:
```swift
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:
```swift
startRecording()
```
To end the capture of a video, call the `stopRecording` function:
```swift
stopRecording()
```
### Delegate
You must implement the `FilterCamViewControllerDelegate` and set the `cameraDelegate` to your view controller instance:
```swift
class MyCameraViewController : FilterCamViewController, FilterCamViewControllerDelegate {
override func viewDidLoad() {
super.viewDidLoad()
cameraDelegate = self
}
...
}
```
#### Delegate methods:
```swift
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:
```swift
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:
```swift
devicePosition = .front
```
### Configuration
#### Apply filter
You can apply custom filters by specifying an array of filters in the filters property:
```swift
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:
```swift
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**
**nkmrhj@gmail.com**