Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/remirobert/CameraEngine
:monkey::camera: Camera engine for iOS, written in Swift, above AVFoundation. :monkey:
https://github.com/remirobert/CameraEngine
camera capture detection image photo-capture video
Last synced: 8 days ago
JSON representation
:monkey::camera: Camera engine for iOS, written in Swift, above AVFoundation. :monkey:
- Host: GitHub
- URL: https://github.com/remirobert/CameraEngine
- Owner: remirobert
- License: mit
- Archived: true
- Created: 2015-09-11T09:43:46.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2019-01-16T01:36:38.000Z (almost 6 years ago)
- Last Synced: 2024-11-14T16:26:41.131Z (29 days ago)
- Topics: camera, capture, detection, image, photo-capture, video
- Language: Swift
- Homepage: https://github.com/remirobert/CameraEngine
- Size: 182 KB
- Stars: 585
- Watchers: 22
- Forks: 106
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - CameraEngine - Camera engine for iOS, written in Swift, above AVFoundation. (Hardware / Camera)
- awesome-ios-star - CameraEngine - Camera engine for iOS, written in Swift, above AVFoundation. (Hardware / Camera)
README
🌟 The most advanced Camera framework in Swift 🌟
[](https://raw.githubusercontent.com/remirobert/CameraEngine/master/LICENSE)
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/?q=CameraEngine)
[](https://travis-ci.org/remirobert/CameraEngine)
[](http://cocoapods.org/?q=CameraEngine)
[](https://www.apple.com/nl/ios/)
[](https://codebeat.co/projects/github-com-remirobert-cameraengine)
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=2MUNQRB8KTSM8 "Donate")
**CameraEngine** *is an iOS camera engine library that allows easy integration of special capture features and camera customization in your iOS app.*
## :fire: Features
| | CameraEngine |
----------|-----------------
:relaxed: | Support iOS8 - iOS9
:triangular_ruler: | Support orientation device
:checkered_flag: | Fast capture
:camera: | Photo capture
:movie_camera: | Video capture
:chart_with_upwards_trend: | quality settings presset video / photo capture
:raising_hand: | switch device (front, back)
:bulb: | flash mode management
:flashlight: | torch mode management
:mag_right: | focus mode management
:bowtie: | detection face, barecode, and qrcode
:rocket: | GIF encoder
## 🔨 Installation
#### CocoaPods
- Add `pod "CameraEngine"` to your Podfile.
- Run `pod install` or `pod update`.
- import CameraEngine
#### Carthage
- Add `github "remirobert/CameraEngine"` to your Cartfile.
- Run `carthage update` and add the framework to your project.
- import CameraEngine
#### Manually
- Download all the files in the CameraEngine subdirectory.
- Add the source files to your Xcode project.
- import CameraEngine
To add the Framework, you can also create a **workspace** for your project, then add the **CameraEngine.xcodeproj**, and the **CameraEngine**, then you should be able to compile the framework, and import it in your app project.
**CameraEngine** supports *swift3*, see the development branch for a swift 3 integration.
## :rocket: Quick start
> First let's init and start the camera session. You can call that in viewDidLoad, or in appDelegate.
```Swift
override func viewDidLoad() {
super.viewDidLoad()
self.cameraEngine.startSession()
}
```
> Next time to display the preview layer
```Swift
override func viewDidLayoutSubviews() {
let layer = self.cameraEngine.previewLayer
layer.frame = self.view.bounds
self.view.layer.insertSublayer(layer, atIndex: 0)
self.view.layer.masksToBounds = true
}
```
> Capture a photo
```Swift
self.cameraEngine.capturePhoto { (image: UIImage?, error: NSError?) -> (Void) in
//get the picture tooked in the 👉 image
}
```
> Capture a video
```Swift
private func startRecording() {
guard let url = CameraEngineFileManager.documentPath("video.mp4") else {
return
}
self.cameraEngine.startRecordingVideo(url, blockCompletion: { (url, error) -> (Void) in
})
}
private func stopRecording() {
self.cameraEngine.stopRecordingVideo()
}
```
> Generate animated image GIF
```swift
guard let url = CameraEngineFileManager.documentPath("animated.gif") else {
return
}
self.cameraEngine.createGif(url, frames: self.frames, delayTime: 0.1, completionGif: { (success, url) -> (Void) in
//Do some crazy stuff here
})
```
## :wrench: configurations
CameraEngine, allows you to set some parameters, such as management of **flash**, **torch** and **focus**. But also on the quality of the media, which also has an impact on the size of the output file.
> Flash
```swift
self.cameraEngine.flashMode = .On
self.cameraEngine.flashMode = .Off
self.cameraEngine.flashMode = .Auto
```
> Torch
```swift
self.cameraEngine.torchMode = .On
self.cameraEngine.torchMode = .Off
self.cameraEngine.torchMode = .Auto
```
> Focus
| CameraEngine focus
--------------------------|------------------------------------------------------------
.Locked | means the lens is at a fixed position
.AutoFocus | means setting this will cause the camera to focus once automatically, and then return back to Locked
.ContinuousAutoFocus | means the camera will automatically refocus on the center of the frame when the scene changes
```swift
self.cameraEngine.cameraFocus = .Locked
self.cameraEngine.cameraFocus = .AutoFocus
self.cameraEngine.cameraFocus = .ContinuousAutoFocus
```
> Camera presset Photo
```swift
self.cameraEngine.sessionPresset = .Low
self.cameraEngine.sessionPresset = .Medium
self.cameraEngine.sessionPresset = .High
...
```
> Camera presset Video
```swift
self.cameraEngine.videoEncoderPresset = .Preset640x480
self.cameraEngine.videoEncoderPresset = .Preset960x540
self.cameraEngine.videoEncoderPresset = .Preset1280x720
self.cameraEngine.videoEncoderPresset = .Preset1920x1080
self.cameraEngine.videoEncoderPresset = .Preset3840x2160
```
## :eyes: Object detection
CameraEngine can detect **faces**, **QRcodes**, or **barcode**. It will return all metadata on each frame, when it detects something. To exploit you whenever you want later.
> Set the detection mode
```swift
self.cameraEngine.metadataDetection = .Face
self.cameraEngine.metadataDetection = .QRCode
self.cameraEngine.metadataDetection = .BareCode
self.cameraEngine.metadataDetection = .None //disable the detection
```
> exploiting face detection
```swift
self.cameraEngine.blockCompletionFaceDetection = { faceObject in
let frameFace = (faceObject as AVMetadataObject).bounds
self.displayLayerDetection(frame: frameFace)
}
```
> exploiting code detection (barecode and QRCode)
```swift
self.cameraEngine.blockCompletionCodeDetection = { codeObject in
let valueCode = codeObject.stringValue
let frameCode = (codeObject as AVMetadataObject).bounds
self.displayLayerDetection(frame: frameCode)
}
```
## :car::dash: Example
You will find a sample project, which implements all the features of CameraEngine, with an interface that allows you to test and play with the settings.
To run the example projet, run `pod install`, because it uses the current prod version of CameraEngine.
## Contributors 🍻
- [eyaldar](https://github.com/eyaldar)
- [davidlondono](https://github.com/davidlondono)
- [patthehuman](https://github.com/patthehuman)
- [jnoh](https://github.com/jnoh)
## License
This project is licensed under the terms of the MIT license. See the LICENSE file.
> This project is in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs.
If you want to support the development of this library, feel free to
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=2MUNQRB8KTSM8 "Donate"). Thanks to all contributors so far!
