Skip to main content
Version: Next

Interface: OCRType

Defined in: types/ocr.ts:85

Return type for the useOCR hook. Manages the state and operations for Optical Character Recognition (OCR).

Properties

downloadProgress

downloadProgress: number

Defined in: types/ocr.ts:104

Represents the total download progress of the model binaries as a value between 0 and 1.


error

error: RnExecutorchError | null

Defined in: types/ocr.ts:89

Contains the error object if the models failed to load, download, or encountered a runtime error during recognition.


forward()

forward: (input) => Promise<OCRDetection[]>

Defined in: types/ocr.ts:118

Executes the OCR pipeline (detection and recognition) on the provided image.

Supports two input types:

  1. String path/URI: File path, URL, or Base64-encoded string
  2. PixelData: Raw pixel data from image libraries (e.g., NitroImage)

Note: For VisionCamera frame processing, use runOnFrame instead.

Parameters

input

Image source (string or PixelData object)

string | PixelData

Returns

Promise<OCRDetection[]>

A Promise that resolves to the OCR results (recognized text and bounding boxes).

Throws

If the models are not loaded or are currently processing another image.


isGenerating

isGenerating: boolean

Defined in: types/ocr.ts:99

Indicates whether the model is currently processing an image.


isReady

isReady: boolean

Defined in: types/ocr.ts:94

Indicates whether both detector and recognizer models are loaded and ready to process images.


runOnFrame

runOnFrame: (frame, isFrontCamera) => OCRDetection[] | null

Defined in: types/ocr.ts:135

Synchronous worklet function for VisionCamera frame processing. Automatically handles native buffer extraction and cleanup.

Use this for VisionCamera frame processing in worklets. For async processing, use forward() instead.

Note: OCR is a two-stage pipeline (detection + recognition) and may not achieve real-time frame rates. Frames may be dropped if inference is still running.

Available after model is loaded (isReady: true).

Param

VisionCamera Frame object

Param

Whether the front camera is active, used for mirroring corrections.

Returns

Array of OCRDetection results for the frame.