Aspose.OCR FOSS for .NET — عیبیابی
این صفحه خطاها و محدودیتهایی را که بیشترین احتمال بروزشان هنگام یکپارچهسازی Aspose.OCR FOSS برای .NET وجود دارد، همراه با علت واقعی هر یک فهرست میکند.
استثناهای پرتابشده توسط Recognize()
AsposeOcr.Recognize() ورودی خود را پیش از اجرای هر مدلی اعتبارسنجی میکند. هر یک از بررسیهای زیر به این ترتیب شکست میخورند:
| Exception | دلیل | اصلاح |
|---|---|---|
ArgumentNullException | OcrInputی که به Recognize() ارسال شده است، null است | همیشه قبل از فراخوانی Recognize()، یک OcrInput بسازید |
NotSupportedException | OcrInput با یک InputType غیر از SingleImage یا PDF ساخته شده بود | فقط InputType.SingleImage و InputType.PDF معتبر هستند |
FileNotFoundException | مسیری که از طریق OcrInput.Add() اضافه شده است، بر روی دیسک وجود ندارد | قبل از فراخوانی Add() هر مسیر را اعتبارسنجی کنید — یک فایل گمشده کل فراخوانی را شکست میدهد، نه فقط آن فایل |
تشخیص هیچ متنی بر نمیگرداند
اگر RecognitionResult.RecognitionText خالی باشد و RecognitionLinesResult هیچ ورودی نداشته باشد، تشخیصگر هیچ ناحیهای از خطوط متن در تصویر پیدا نکرد. این وضعیت انتظار میرود — نه یک اشکال — برای:
- تصاویر بدون متن قابل خواندن، یا متنی که بسیار کوچک، چرخیده یا با کنتراست پایین باشد تا تشخیصگر نتواند آن را به عنوان ناحیهای ثبت کند
- خطوط غیرلاتین: مدل تشخیص تعبیهشده فقط متنهای لاتین و کاراکترهای دیاکریتیسی آن را پوشش میدهد
- تصاویری که مناطق شناساییشده در طول پردازش پس از استخراج فیلتر شدهاند (امتیازهای بسیار پایین احتمال متن)
هیچ امتیاز اطمینانی برای تمایز بین «هیچ چیزی شناسایی نشد» و «شناسایی شد اما نامطمئن» در دسترس نیست — ببینید دامنه و محدودیتها.
تشخیص اجرا میشود اما نتایج نادرست به نظر میرسند
- متن چرخیده یا کجنمایی شده. هیچ تصحیح خودکار کجنمایی یا چرخش وجود ندارد. قبل از فراخوانی تصویر منبع را پیشچرخش کنید
Recognize(). - چیدمان جدول یا فرمها بهنظر درهم و برهم است. کشفکننده فقط مستطیلهای خط محور-محور (axis-aligned) را بر میگرداند — هیچ مفهومی از ستونها، جداول یا ترتیب خواندن فراتر از موقعیت خط ندارد. بازسازی چیدمان مسئولیت فراخوانکننده است.
- موقعیت متن PDF بهنظر میرسد جابجا شده باشد. صفحات PDF همیشه بهصورت داخلی با 150 DPI رندر میشوند؛ مختصات مستطیلها در
RecognitionResult.LinesResult.Lineدر فضای پیکسل تصویر رندر شده هستند، نه در فضای نقطهای PDF.
مشکلات پلتفرم و ساخت
PlatformNotSupportedExceptionیا مشابه آن در زمان اجرا بر روی لینوکس/مکاواس. پردازش تصویر بهSystem.Drawing.Common، که فقط در ویندوز روی .NET 6 و بعد از آن موجود است. مسیر پردازش تصویر این کتابخانه فقط در ویندوز اجرا میشود.- ساخت هنگام هدفگیری شکست میخورد
net9.0/net10.0. ساخت آن اهداف به .NET 10 SDK نیاز دارد — ببینید نحوه ساخت از منبع. - Mixing
InputType.SingleImageandInputType.PDFدر یکOcrInput. پشتیبانی نمیشود — ببینید چگونه چندین تصویر را به صورت دستهای پردازش کنیم.