Skip to content

Latest commit

 

History

History
89 lines (65 loc) · 3.57 KB

README.md

File metadata and controls

89 lines (65 loc) · 3.57 KB
Raw

TFCamera

TFCamera is a very simple camera component based on Snapchat's control scheme for iOS 8+.

Version

0.1.13

Tech

TFCamera is built off AVFoundation with speed and simplicity in mind. It doesn't have a lot of extra bells and whistles, but rather it strives to be a good starting point for any app that's in need of a quick camera component as a jumping off point. For now it includes the following features:

  • pinch to zoom
  • tap to focus
  • double tap to swap cameras
  • hold shutter button to record video
  • selfie flash
  • a basic shutter animation

TFCamera is dependant on two other Cocoapods to function correctly:

  • pop - Facebook's awesome animation framework
  • JWGCircleCounter - a simple circle counter that's incredibly convenient and easy to use

Installation

TFCamera is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "TFCamera"

Usage

Getting started with TFCamera is obscenely easy! Simply instantiate the camera ViewController and set its delegate with the following code and then present it wherever you'd like to use it (works great as a view in a UIPageViewController):

TFCameraViewController *cameraVC = [[TFCameraViewController alloc] initWithInterface];
cameraVC.delegate = self;

Then call the following delegate methods:

- (void)cameraDidTakePhoto:(UIImage *)photo;
- (void)cameraDidTakeVideo:(NSURL *)videoURL;

Once a photo has been taken a UIImage will be passed back (selfies are already flipped to match what the user sees on their screen so no need to worry about that). Likewise, once a video is recorded an NSURL to its location will be passed back. TFCamera always overrites the video file it just took, so need to worry about it taking up a large amount of space on your user's device.

It also allows for easily changing the interface color (just set the appColor property after instantiation). Feel free to register it for a color change notififcation as well if you want the user to be able to change the ui color on the fly with the following method:

- (void) registerCameraForColorChangeNotification: (NSString *) notificationString;

Customization

TFCamera has the following properties you can set to customize the camera functionality and appearance

@property (nonatomic) BOOL enableDoubleTapSwitch; //Default is YES
@property (nonatomic) BOOL enableSelfieFlash; //Default is YES

@property (nonatomic) CGFloat maxVideoLength; //Default is 16 seconds
@property (nonatomic) CGFloat shutterAnimationSpeed; //Default is .15 seconds 

@property (strong, nonatomic) UIColor *appColor; //Default is white

/*!
Use these methods to swap the button images after instantiaiton of the ViewController
*/
- (void) changeFlashOnImage: (UIImage *) flashOnImage;
- (void) changeFlashOffImage: (UIImage *) flashOffImage;
- (void) changeSwapCameraImage: (UIImage *) swapCameraImage;

Author

Tarik Fayad, [email protected]

Todos

  • Write Tests
  • Add Code Comments
  • Add Night Mode

License

TFCamera is available under the MIT license. See the LICENSE file for more info.