Direct processing API

This guide will in short present you how to process UIImage objects with BlinkID SDK, without starting the camera video capture.

With this feature you can solve various use cases like:

• recognizing text on images in Camera roll
• taking full resolution photo and sending it to processing
• scanning barcodes on images in e-mail
• etc.

This guide will be essentially the same as in the "Getting Started" guide. It also closely follows NoCamera-sample app in the SDK repository.

NoCamera-sample demo app here will present UIImagePickerController for taking full resolution photos, and then process it with MicroBlink SDK to get scanning results using Direct processing API.

1. Initial integration steps

The same as in "Getting Started" guide.

2. Referencing header file

The same as in "Getting Started" guide.

3. Initializing the scanning library

To initiate the scanning process, first decide where in your app you want to add scanning functionality. Usually, users of the scanning library have a button which, when tapped, starts the scanning process. Initialization code is then placed in touch handler for that button. Here we're listing the initialization code as it looks in a touch handler method.

Initialization consists of a method which creates PPCoordinator object, which is the same as in "Getting Started" guide.

/**

• Method allocates and initializes the Scanning coordinator object.
• Coordinator is initialized with settings for scanning
• @param error Error object, if scanning isn't supported
• @return initialized coordinator */

• (PPCoordinator )coordinatorWithError:(NSError*)error {

    // Use the implementation from Getting started guide!
  

}

• (IBAction)takePhoto:(id)sender { NSLog(@"Take photo!");

  /** Instantiate the scanning coordinator */ NSError *error; self.coordinator = [self coordinatorWithError:&error];

  /** If scanning isn't supported, present an error */ if (self.coordinator == nil) { NSString *messageString = [error localizedDescription]; [[[UIAlertView alloc] initWithTitle:@"Warning" message:messageString delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil, nil] show];

    return;
  

  }

  UIImagePickerController *cameraUI = [[UIImagePickerController alloc] init];

  // Use rear camera cameraUI.sourceType = UIImagePickerControllerSourceTypeCamera; cameraUI.cameraDevice = UIImagePickerControllerCameraDeviceRear;

  // Displays a control that allows the user to choose only photos cameraUI.mediaTypes = [[NSArray alloc] initWithObjects: (NSString *)kUTTypeImage, nil];

  // Hides the controls for moving & scaling pictures, or for trimming movies. cameraUI.allowsEditing = NO;

  // Shows default camera control overlay over camera preview. // TODO: set this to NO and provide custom overlay cameraUI.showsCameraControls = YES;

  // set delegate cameraUI.delegate = self;

  // Show view [self presentViewController:cameraUI animated:YES completion:nil]; }

#pragma mark - UIImagePickerControllerDelegate

• (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info { NSString *mediaType = [info objectForKey: UIImagePickerControllerMediaType];

  // Handle a still image capture if (CFStringCompare((CFStringRef) mediaType, kUTTypeImage, 0) == kCFCompareEqualTo) { UIImage *originalImage = (UIImage *)[info objectForKey: UIImagePickerControllerOriginalImage];

    // call process image
    [self.coordinator processImage:originalImage
                    scanningRegion:CGRectMake(0.0, 0.0, 1.0, 1.0)
                          delegate:self];
  

  }

  [self dismissViewControllerAnimated:YES completion:nil]; }

### 4. Registering for scanning events

The same as in ["Getting Started" guide](https://github.com/BlinkID/blinkid-ios/wiki/Getting-started)


### Conclusion

Now you've seen how to implement the Direct processing API.

In essence, this API consists of two steps:

1) Initialization of the scanner. 

2) Call of `processImage:scanningRegion:delegate` method for each `UIImage` you have.