Struct TextRecognizer 

pub struct TextRecognizer { /* private fields */ }

Available on crate feature recognize_text only.

OCR engine.

Examples

use apple_vision::recognize_text::{TextRecognizer, RecognitionLevel};

let recognizer = TextRecognizer::new()
    .with_recognition_level(RecognitionLevel::Accurate)
    .with_language_correction(true);
let observations = recognizer.recognize_in_path("/tmp/screenshot.png")?;
for obs in &observations {
    println!("{:.2} {:?}: {}", obs.confidence, obs.bounding_box, obs.text);
}

Implementations

impl TextRecognizer

pub const fn new() -> Self

Construct with the Vision defaults: accurate mode + language correction enabled.

pub const fn with_recognition_level(self, level: RecognitionLevel) -> Self

pub const fn with_language_correction(self, enabled: bool) -> Self

pub fn recognize_in_path( &self, path: impl AsRef<Path>, ) -> Result<Vec<RecognizedText>, VisionError>

Recognise text in the image at path. Supports any format CoreGraphics’ ImageIO can read (PNG, JPEG, HEIC, TIFF, …).

Returns observations in Vision’s natural ordering (top-down, left-to-right after layout analysis).

Errors

Returns VisionError::InvalidArgument if path contains an interior NUL byte, VisionError::ImageLoadFailed if the image can’t be read, or VisionError::RequestFailed if Vision rejects the request.

pub fn recognize_in_pixel_buffer( &self, pixel_buffer: &CVPixelBuffer, ) -> Result<Vec<RecognizedText>, VisionError>

Recognise text in a CVPixelBuffer directly, without a PNG round-trip. This is the zero-copy path for live capture pipelines (screencapturekit / videotoolbox decoder / AVCaptureSession).

Errors

Returns VisionError::RequestFailed if Vision rejects the buffer (e.g. unsupported pixel format).

Trait Implementations

impl Clone for TextRecognizer

fn clone(&self) -> TextRecognizer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TextRecognizer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TextRecognizer

fn default() -> Self

Returns the “default value” for a type.