oar-ocr-core 0.6.3

Core types and predictors for oar-ocr
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! Document Rectification Predictor
//!
//! This module provides a high-level API for document rectification (dewarp).

use super::builder::PredictorBuilderState;
use crate::TaskPredictorBuilder;
use crate::core::OcrResult;
use crate::core::traits::OrtConfigurable;
use crate::core::traits::adapter::AdapterBuilder;
use crate::core::traits::task::ImageTaskInput;
use crate::domain::adapters::UVDocRectifierAdapterBuilder;
use crate::domain::tasks::document_rectification::{
    DocumentRectificationConfig, DocumentRectificationTask,
};
use crate::predictors::TaskPredictorCore;
use image::RgbImage;
use std::path::Path;

/// Document rectification prediction result
#[derive(Debug, Clone)]
pub struct DocumentRectificationResult {
    /// Rectified images
    pub images: Vec<RgbImage>,
}

/// Document rectification predictor
pub struct DocumentRectificationPredictor {
    core: TaskPredictorCore<DocumentRectificationTask>,
}

impl DocumentRectificationPredictor {
    pub fn builder() -> DocumentRectificationPredictorBuilder {
        DocumentRectificationPredictorBuilder::new()
    }

    /// Predict document rectification for the given images.
    pub fn predict(&self, images: Vec<RgbImage>) -> OcrResult<DocumentRectificationResult> {
        let input = ImageTaskInput::new(images);
        let output = self.core.predict(input)?;
        Ok(DocumentRectificationResult {
            images: output.rectified_images,
        })
    }
}

#[derive(TaskPredictorBuilder)]
#[builder(config = DocumentRectificationConfig)]
pub struct DocumentRectificationPredictorBuilder {
    state: PredictorBuilderState<DocumentRectificationConfig>,
}

impl DocumentRectificationPredictorBuilder {
    pub fn new() -> Self {
        Self {
            state: PredictorBuilderState::new(DocumentRectificationConfig {
                rec_image_shape: [3, 0, 0],
            }),
        }
    }

    pub fn build<P: AsRef<Path>>(self, model_path: P) -> OcrResult<DocumentRectificationPredictor> {
        let (config, ort_config) = self.state.into_parts();
        let mut adapter_builder = UVDocRectifierAdapterBuilder::new().with_config(config.clone());

        if let Some(ort_cfg) = ort_config {
            adapter_builder = adapter_builder.with_ort_config(ort_cfg);
        }

        let adapter = Box::new(adapter_builder.build(model_path.as_ref())?);
        let task = DocumentRectificationTask::new(config.clone());
        Ok(DocumentRectificationPredictor {
            core: TaskPredictorCore::new(adapter, task, config),
        })
    }
}

impl Default for DocumentRectificationPredictorBuilder {
    fn default() -> Self {
        Self::new()
    }
}