/vision-camera-dynamsoft-document-normalizer

A React Native Vision Camera frame processor plugin for Dynamsoft Document Normalizer

Primary LanguageJavaMIT LicenseMIT

vision-camera-dynamsoft-document-normalizer

A React Native Vision Camera frame processor plugin for Dynamsoft Document Normalizer.

It can detect document boundaries and run perspective transformation to get a normalized image.

DDN_iOS.MP4

Versions

For vision-camera v2, use versions 0.x.

For vision-camera v3, use versions 1.x - 2.x.

For vision-camera v4, use versions >= 3.0.0.

SDK Versions Used for Different Platforms

Product Android iOS
Dynamsoft Document Normalizer 2.x 2.x

Installation

yarn add vision-camera-dynamsoft-document-normalizer
cd ios && pod install

Add the plugin to your babel.config.js:

module.exports = {
   plugins: [['react-native-worklets-core/plugin']],
    // ...

Note: You have to restart metro-bundler for changes in the babel.config.js file to take effect.

Usage

  1. Scan documents with vision camera.

    import { detect } from 'vision-camera-dynamsoft-document-normalizer';
    
    // ...
    const frameProcessor = useFrameProcessor((frame) => {
      'worklet';
      const detectionResults = detect(frame);
    }, []);
  2. Scan documents from a file.

    let detectionResults = await detectFile(photoPath);
  3. Normalize a document image with the detection result.

    let normalizedImageResult = await normalizeFile(photoPath, detectionResult.location,{saveNormalizationResultAsFile:true});
  4. License initialization (apply for a trial license).

    await initLicense("your license");

Supported Platforms

  • Android
  • iOS

Blog

Build a Document Normalization React Native Vision Camera Plugin

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT