Debug mode - Save processing results

Aspose.OCR for Python via .NET provides a Debug Mode that allows you to visually inspect how the input image is transformed during recognition.

When debug mode is enabled, the library saves intermediate processing results as image files:

• The preprocessed image after filters (e.g., binarization, noise removal, resizing).
• The image with highlighted text regions, where red rectangles mark detected text lines or blocks.

This feature is especially useful for troubleshooting recognition errors and fine-tuning preprocessing filters.

Property	Description
set_debug_mode	Enables or disables debug image saving.
set_debug_mode_save_directory	Sets the target folder where images will be saved. If not set, the current working directory is used.

Enabling debug mode

Debug mode is activated using two methods of the AsposeOCR class:

Enable debug mode

from aspose.ocr import *
    api = AsposeOcr()
    api.set_debug_mode_save_directory("C:/output/debug")
    api.set_debug_mode(True)
    #  Recognize image
    input = OcrInput(InputType.PDF)
    input.add(file, 2, 3)

    set = RecognitionSettings()
    result = api.recognize(input, set)

Output examples

When enabled, you will see image files like:

• Preprocessed0.png – image after applying preprocessing filters
• DetectedTextLines0.png – the same image with red rectangles drawn around detected text areas

Each image corresponds to the input from OcrInput.addImage(…) or its index.

Notes

• Debug images do not affect recognition accuracy.
• This feature works with both automatic and manual preprocessing.
• If a temporary license is used, debug mode still functions as expected.