• Stars
    star
    1,300
  • Rank 36,189 (Top 0.8 %)
  • Language
    Objective-C
  • Created almost 10 years ago
  • Updated over 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A fully customisable and modern camera implementation for iOS made with AVFoundation.

Platform License Level

Custom Camera.


Features

  • Extremely simple and easy to use
  • Controls autofocus & exposure
  • Customizable interface
  • Code-made UI assets that do not lose 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

Installation

  • 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.
  • Browse to the directory of the demo app and drag the CustomizableCamera folder into your Xcode project.
  • import "CameraSessionView.h" to the view controller that will invoke the camera.

Usage

Using CustomizableCamera in your app is very fast and simple.

Displaying the camera view and adopting its delegate

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 whether 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
}

Dismissing the camera view

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

License

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.