Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maryamfekri/mfcameramanager
MF Camera Manager
https://github.com/maryamfekri/mfcameramanager
barcode barcode-scanner camera camera-manager camera-preview capture crop crop-image ios ios-app scan scanner swift swift3
Last synced: 4 months ago
JSON representation
MF Camera Manager
- Host: GitHub
- URL: https://github.com/maryamfekri/mfcameramanager
- Owner: maryamfekri
- License: mit
- Created: 2017-02-05T10:37:57.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-09-07T21:24:22.000Z (over 4 years ago)
- Last Synced: 2024-10-12T14:23:06.847Z (4 months ago)
- Topics: barcode, barcode-scanner, camera, camera-manager, camera-preview, capture, crop, crop-image, ios, ios-app, scan, scanner, swift, swift3
- Language: Swift
- Homepage:
- Size: 27.5 MB
- Stars: 42
- Watchers: 8
- Forks: 17
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# CameraManager Features :
● manage camera session
● get image from camera
● crop image in a frame
● scan barcode and get the image asynchronously
# Requirements :
iOS 8.0+
Xcode 8.1+
Swift 3.0+ (Support Swift 4)
---------------------------------------------------------------------------
**Demo :**
---------------------------------------------------------------------------
# Installation :
**CocoaPods :**
```
pod 'MFCameraManager'
```
**or download CustomCameraManagerClass directory and add it manually to your project**
# Setup :
Now in your view add a UIView to storyboard view controller or programmetically initiate an UIView which will be your camera preview. then follow steps to display the camera :
**If you just need the camera session and capturing image you have to use CameraManager.swift class, as it has StillImageOutput.**
**but if you need the camera session to scan barcode beside capturing image you have to use ScanBarcodeCameraManager.swift class, as it has StillImageOutput.**
**initial step**
---------------------------------------------------------------------------
Create a variable of which class you prefer (ScanBarcodeCameraManager.swift or CameraManager.swift) :
` var cameraManager = CameraManager() `
or
` var cameraManager = ScanBarcodeCameraManager() `
from now on below 4 steps are similar in each class you instantiated :
1 - on your viewDidLoad setup the camera with your UIView created to show the camera preview inside it, and your camera position which its default is back :
` cameraManager.captureSetup(in: self.cameraView, with: .back) `
2 - in viewWillApear delegate call this method :
` cameraManager.startRunning() `
3 - in viewDidDisapear delegate call below method :
` cameraManager.stopRunning() `
4 - to support landscape transitions add below code to viewWillTransition Delegate :
` cameraManager.transitionCamera() `
**Features in CameraManager class**
----------------------------
- to capture an image showing on camera :
```
self.cameraManager.getcroppedImage { (UIImage, error) in
//your code here to handle with error or if error == nil , get the UIImage
}
```
- to get the image inside a frame or CGRect , give the frame as a params to getcroppedImage function like below :
```
self.cameraManager.getcroppedImage(with: self.rectLayer.frame) { (UIImage, error) in
//your code here to handle with error or if error == nil , get the UIImage
}
```
**Features in ScanBarcodeCameraManager class**
----------------------------
- to get the scanned barcode and capture an image :
should conform to protocol ScanBarcodeCameraManagerDelegate and :
```
self.cameraManager.delegate = self
```
then implement the function to get the barcode objects and also the captured image :
```
func scanBarcodeCameraManagerDidRecognizeBarcode(barcode: Array, image: UIImage?) {
self.scanBarcodeCameraManager.stopRunning()
print(barcode)
// to whatever you like to the barcode objects and the image
scanBarcodeCameraManager.startRunning()
}
```
**Extra features in all classess**
----------------------------
- to enable torch mode use below code with level of torch mode default is 1 :
`cameraManager.enableTorchMode(level: 1)`
# Communication :
- If you found a bug, open an issue.
- If you have a feature request, open an issue.
- If you want to contribute, submit a pull request.