Refactor Aspose.OCR

[ArtemLazarchuk]

Aspose.OCR Image-to-Text

Created Using Ivy

Web application created using Ivy-Framework.

Ivy - The ultimate framework for building internal tools with LLM code generation by unifying front-end and back-end into a single C# codebase. With Ivy, you can build robust internal tools and dashboards using C# and AI assistance based on your existing database.

Ivy is a web framework for building interactive web applications using C# and .NET.

Interactive Example For OCR (Image To Text)

This example showcases extracting text from images using Aspose.OCR with a simple two-panel UI: upload on the left, recognized text on the right.

What This Application Does:

• Upload Image: Select an image file and run OCR
• Text Extraction: Recognize text from the uploaded image
• Monospaced Viewer: See output in a clean, plain-text viewer
• Validation: Basic size check with friendly error messages

Technical Implementation:

• Uses Aspose.OCR AsposeOcr with OcrInput(InputType.SingleImage)
• Adds uploaded image stream via source.Add(stream) and calls Recognize
• Shows the first RecognitionResult.RecognitionText in a CodeInput
• Single C# view (Apps/ImageToTextApp.cs) built with Ivy UI primitives

One-Click Development Environment

Click the badge above to open Ivy Examples repository in GitHub Codespaces with:

• .NET 9.0 SDK pre-installed
• Ready-to-run development environment
• No local setup required

How to Run

1. Prerequisites: .NET 9+ SDK
2. Navigate to the example:

   cd aspose-ocr

3. Restore dependencies:

   dotnet restore

4. Run the application:

   dotnet watch

5. Open your browser to the URL shown in the terminal (typically http://localhost:5010)

How to Deploy

Deploy this example to Ivy's hosting platform:

1. Navigate to the example:

   cd aspose-ocr

2. Deploy to Ivy hosting:

   ivy deploy

This will deploy your OCR application with a single command.

Licensing & Trial Limitations

Aspose.OCR for .NET is a commercial library that can be used in trial (evaluation) mode without a license.

Trial Mode Restrictions

When running without a license, the following limitations apply:

• If the recognized image contains more than 300 characters, only the first 300 characters are recognized.
• If the recognized image contains less than 300 characters, only the first 60% are recognized.

For more licensing options (metered, embedded resources, stream), see the official licensing documentation.

Learn More

• Aspose.OCR for .NET overview: products.aspose.com/ocr/net
• Aspose.OCR Licensing: docs.aspose.com/ocr/net/licensing
• Ivy Documentation: docs.ivy.app

[rorychatt]

@claude review this

[Copilot]

Pull Request Overview

This PR refactors the Aspose.OCR example by simplifying its architecture and improving documentation. The changes modernize the project structure and remove unnecessary abstraction layers while making the example more accessible.

• Replaced project references with NuGet package references for Ivy framework
• Simplified OCR implementation by removing service layer abstractions and implementing OCR directly in the UI component
• Enhanced documentation with comprehensive setup instructions, deployment guide, and licensing information

Reviewed Changes

Copilot reviewed 11 out of 12 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
crm-vc/Vc.csproj	Switched from local project reference to NuGet package reference for Ivy framework
aspose-ocr/README.md	Completely rewrote documentation with detailed setup, deployment, and licensing sections
aspose-ocr/Program.cs	Updated namespace and added custom header with GitHub Codespaces link
aspose-ocr/GlobalUsings.cs	Changed namespace from Ivy.Aspose.OCR.Examples to AsposeOcrExample
aspose-ocr/Connections/OCR/*	Removed OCR service abstraction layer (OCRConnection, IOCRService, AsposeOcrService)
aspose-ocr/AsposeOcrExample.sln	Updated project reference to match new project name
aspose-ocr/AsposeOcrExample.csproj	Updated root namespace and changed Ivy package version to wildcard
aspose-ocr/Apps/ImageToTextApp.cs	Refactored UI layout and moved OCR logic directly into the component
.devcontainer/aspose-ocr/devcontainer.json	Added GitHub Codespaces configuration for one-click development environment

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}