Skip to content

shinydevelopment/SDScreenshotCapture

Repository files navigation

SDScreenshotCapture

MIT Licensed  Platform  Version 

SDScreenshotCapture is a class which can be used to capture a screenshot of the app window which excludes the iOS status bar. It includes methods to grab the screenshot directly as a UIImage, share it via a UIActivityViewController, save it to the camera roll or write it directly to the app sandbox in the Documents directory.

Usage

Import the SDScreenshotCapture class and use one of the following methods to capture a screenshot:

// Screenshot and show share sheet
[SDScreenshotCapture takeScreenshotToActivityViewController];
// Screenshot and store to camera roll
[SDScreenshotCapture takeScreenshotToCameraRoll];
// Screenshot and store to documents directory
[SDScreenshotCapture takeScreenshotToDocumentsDirectory];

These methods can be called from anywhere but there are a couple of suggestions on how to trigger a screenshot in a generic way below:

Triggering with a four finger tap gesture on the window

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  UITapGestureRecognizer *tapGesture = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(tapGestureRecognized:)];
  tapGesture.numberOfTouchesRequired = 4;
  [self.window addGestureRecognizer:tapGesture];

  return YES;
}

- (void)tapGestureRecognized:(UITapGestureRecognizer *)tapGesture
{
  [SDScreenshotCapture takeScreenshotToActivityViewController];
}

Triggering with a screenshot taken notification (iOS 7 only)

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(userDidTakeScreenshot:) name:UIApplicationUserDidTakeScreenshotNotification object:nil];

  return YES;
}

- (void)userDidTakeScreenshot:(NSNotification *)notification
{
  [SDScreenshotCapture takeScreenshotToActivityViewController];
}

Note: Unfortunately there is no way to stop the original screenshot being taken if using this method to trigger the SDScreenshotCapture screenshot.

Installation

Just import the SDScreenshotCapture class. Alternatively the class is also available as a CocoaPod:

pod 'SDScreenshotCapture'

Demo

Run the SDScreenshotCapture.xcodeproj project in the Example folder.

Authors

SDScreenshotCapture was written by Dave Verwer and Greg Spiers of Shiny Development.

License

SDScreenshotCapture is available under the MIT license. See the LICENSE file for details.

About

SDScreenshotCapture is a class which can be used to capture a screenshot of the app window which excludes the iOS status bar.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •