Document Scanning SDK for Apple iOS  2.3.4
Document Scanning SDK for Apple iOS

Pixelnetica Document Scanning SDK (DSSDK) provides developers with an intelligent, highly efficient toolkit, which offers an easy way to add image processing features that are optimized for document photos that are taken by a mobile device or document camera to their applications.

In simple terms, Pixelnetica DSSDK processes paper document photos in order to make them look like they've been scanned with a traditional flatbed scanner.

Most of Document Scanning SDK’s features have been integrated into Pixelnetica SharpScan – mobile document scanner that allows users to scan documents and photos on the go.

For more information about DSSDK main Features and Benefits please visit Pixelnetica website.

System requirements

  • Apple iOS 7 and above.

iOS specific features

  • SDK available as an Embedded Framework with support (slices) for iOS devices on ArmV7, ArmV7s, Arm64 and iOS simulator (i386, x86_64).
  • Bitcode support.
  • SDK package includes documentation and sample application source code (Objective-C).

What's new in Version 2.3.4

  • Added additional license key initialization method - from license.txt file.
  • Application Bundle ID changed to conform Apple App Store requirements.
  • Demo application published at App Store as EasyScan: PDF Doc Scanner
  • Demo application source code available on GitHub.
  • Added license debug info.
  • Demo application UI updates.

For more details on previous updates please view full Change Log.

Installation

Integrating Document Scanning SDK into your project is pretty straightforward.

  1. Copy the DocScanningSDK.framework folder from demo application source (provided with trial package) somewhere inside your project.
  2. Open your project in Xcode.
  3. Navigate to the General section of the project properties for your build target.
  4. Expand Embedded Binaries and click the plus icon to add a new item.
  5. Press Add other...
  6. Locate and select DocScanningSDK.framework .
  7. Leave the default values in the dialog box as is and press Finish.
  8. To use SDK headers in your project, import them as framework-style includes, e.g.:
    #import <DocScanningSDK/PxSDK.h>
    You can also use the DSSDK umbrella header to include all the DSSDK headers at once:
    #import <DocScanningSDK/DocScanningSDK.h>
  9. Initialize your license before any DSSDK functions usage. To initialize the license, just call
    [PxLicense initializeWithKey:@"<license_key>"]
    passing your license key string as parameter. Or load it from file. For example, take a look at sample application source code, file PhotoSliderViewController.m.
  10. Add Run Script phase to strip unused architectures from your project for production. Go to your Target Build Phases section. Add a Run Script step to your build steps, put it after your step to embed frameworks, set it to use /bin/sh and enter the following script:
    AAPP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"
    # This script loops through the frameworks embedded in the application and
    # removes unused architectures.
    find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
    do
    FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
    FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"
    echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"
    EXTRACTED_ARCHS=()
    for ARCH in $ARCHS
    do
    echo "Extracting $ARCH from $FRAMEWORK_EXECUTABLE_NAME"
    lipo -extract "$ARCH" "$FRAMEWORK_EXECUTABLE_PATH" -o "$FRAMEWORK_EXECUTABLE_PATH-$ARCH"
    EXTRACTED_ARCHS+=("$FRAMEWORK_EXECUTABLE_PATH-$ARCH")
    done
    echo "Merging extracted architectures: ${ARCHS}"
    lipo -o "$FRAMEWORK_EXECUTABLE_PATH-merged" -create "${EXTRACTED_ARCHS[@]}"
    rm "${EXTRACTED_ARCHS[@]}"
    echo "Replacing original executable with thinned version"
    rm "$FRAMEWORK_EXECUTABLE_PATH"
    mv "$FRAMEWORK_EXECUTABLE_PATH-merged" "$FRAMEWORK_EXECUTABLE_PATH"
    done

Demo version restrictions

Document Scanning SDK demo libs features are identical to runtime except one thing — it puts watermark on resulted image.

You can start develop your project with demo version. When all necessary feature will be properly implemented and tested you can purchase commercial license and switch to commercial version.

How to switch to commercial version

  1. Make sure you're using latest DSSDK demo version.
  2. Replace demo license key with commercial version.

Demo application.

To demonstrate most of Document Scanning SDK features and how they should be used in real application we prepared demo application available in source codes. Demo application can also be found on Apple App Store as EasyScan: PDF Doc Scanner

⚠️ Important Note.

Demo application source code provided “as is” without warranties of any kind. It could be freely used in commercial product only in case of commercial DSSDK license purchase.

For main demo application features please read our brief guide.

Using SDK in iOS Simulator

We added simulator version only for testing purposes. E.g. when developer needs to test functions not related to Document Scanning SDK.

Do not use simulator version for Image processing quality or speed tests.

Due to some specifics of OpenGL emulation in iOS Simulator there could be discrepancies between Simulator and Device image processing results.

Still have Questions, need Free Trial or Quotation?

Feel free to contact us in case of any inquires at Pixelnetica DSSDK Support.