edge_detection Flutter Plugin

To implement scanning in Swift, follow these steps:

1. Import the framework: import WeScan.
2. Conform your view controller to the ImageScannerControllerDelegate protocol.
3. Implement the required delegate methods to handle success, failure, and cancellation.
4. Initialize and present the ImageScannerController.

Note: You are responsible for dismissing the ImageScannerController within the delegate methods.

```swift
import WeScan

class YourViewController: UIViewController, ImageScannerControllerDelegate {
    
    // Implement delegate functions
    func imageScannerController(_ scanner: ImageScannerController, didFailWithError error: Error) {
        print(error)
    }

    func imageScannerController(_ scanner: ImageScannerController, didFinishScanningWithResults results: ImageScannerResults) {
        // Handle results and dismiss
        scanner.dismiss(animated: true)
    }

    func imageScannerControllerDidCancel(_ scanner: ImageScannerController) {
        // Dismiss on cancel
        scanner.dismiss(animated: true)
    }

    // Trigger the scanner
    func startScanning() {
        let scannerViewController = ImageScannerController()
        scannerViewController.imageScannerDelegate = self
        present(scannerViewController, animated: true)
    }
}

To use the plugin on iOS, follow these requirements:

1. Minimum Version: Set the minimum platform version to 13.0 or higher in your ios/Podfile.
2. Permissions: Configure permission_handler in your ios/Podfile to allow camera and photo access:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        'PERMISSION_CAMERA=1',
        'PERMISSION_PHOTOS=1',
      ]
    end
  end
end

3. Info.plist Permissions: Add the following keys to ios/Runner/Info.plist with appropriate usage descriptions:

• NSCameraUsageDescription (Privacy - Camera Usage Description)
• NSPhotoLibraryUsageDescription (Privacy - Photo Library Usage Description)
• NSPhotoLibraryAddUsageDescription (Privacy - Photo Library Additions Usage Description)

4. Xcode 15 Fix: If building with Xcode 15, add the following line to your ios/Podfile inside the target 'Runner' do block:

pod 'WeScan', :path => '.symlinks/plugins/edge_detection/ios/WeScan-3.0.0'

5. Localization: You may need to add localizations via Xcode to localize action buttons from the underlying WeScan library.

Use EdgeDetection.detectEdge to start a live camera session that allows edge detection and an option to select from the gallery.

Note: You must first request camera permissions using permission_handler and generate a valid file path where the cropped image will be saved.

import 'package:edge_detection/edge_detection.dart';

// 1. Request permissions
bool isCameraGranted = await Permission.camera.request().isGranted;
if (!isCameraGranted) {
    isCameraGranted = await Permission.camera.request() == PermissionStatus.granted;
}

if (!isCameraGranted) return;

// 2. Generate filepath
String imagePath = join((await getApplicationSupportDirectory()).path,
    "${(DateTime.now().millisecondsSinceEpoch / 1000).round()}.jpeg");

// 3. Detect edges
try {
    bool success = await EdgeDetection.detectEdge(imagePath,
        canUseGallery: true,
        androidScanTitle: 'Scanning',
        androidCropTitle: 'Crop',
        androidCropBlackWhiteTitle: 'Black White',
        androidCropReset: 'Reset',
    );
} catch (e) {
    print(e);
}