sdscreenshotcapture's Introduction

SDScreenshotCapture

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.