carabina / cool-ios-camera Goto Github PK

• Extremely simple and easy to use
• Customizable interface
• Code-made UI assets that do not loose resolution quality & resize dynamically depending on the screen size of the device.
• Added animations to the UI elements for a more intuitive and responsive feel.
• Overlays over any presented view controller or view
• Made for iPhone & iPad
• Built for iOS 8

• Include the AVFoundation.Framework library in your project, click on your project's target, navigate to Build Phases, then go to Link Binary With Libraries, click on the + and add the AVFoundation.Framework.
• Drag the CustomizableCamera folder found on the demo app into your project.
• import "CameraSessionView.h" to the view controller that will invoke the camera.

Using CustomizableCamera in your app is very fast and simple.

After importing the "CameraSessionView.h" into the view controller, adopt its <CACameraSessionDelegate> delegate.

Next, declare a CameraSessionView property:

@property (nonatomic, strong) CameraSessionView *cameraView;

Now in the place where you would like to invoke the camera view (on the action of a button or viewDidLoad) instantiate it, set it's delegate and add it as a subview:

_cameraView = [[CameraSessionView alloc] initWithFrame:self.view.frame];
_cameraView.delegate = self;
[self.view addSubview:_cameraView];

Now implement one of this two delegate functions depending on weather you would like to get back a UIImage or NSData for an image when the shutter on the camera is pressed,

For a UIImage:

-(void)didCaptureImage:(UIImage *)image {
  //Use the image that is received
}

For NSData:

-(void)didCaptureImageWithData:(NSData *)imageData {
  //Use the image's data that is received
}

You can hide the camera view either by pressing the dismiss button on it or by writing [self.cameraView removeFromSuperview]; on the invoking view controller (it can be written inside one of the two delegate functions in order to dismiss it after taking a photo).

##Customization

Once you have your CameraSessionView instance you can customize the appearance of the camera using its api, below are some samples:

To change the color of the top bar including its transparency:

[_cameraView setTopBarColor:[UIColor colorWithRed:0.97 green:0.97 blue:0.97 alpha: 0.64]];

To hide the flash button:

[_cameraView hideFlashButton]; //On iPad flash is not present, hence it wont appear.

To hide the switch camera's button:

[_cameraView hideCameraToogleButton];

To hide the dismiss button:

[_cameraView hideDismissButton];

If no customization is made, the camera view will use its default look.

##Example

You can find a full example on usage and customization on the Xcode project attached to this repository.

##Contributor

• Christopher Cohen

The MIT License (MIT)

Copyright (c) 2015 Gabriel Alvarado ([email protected])

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.