IRONSOFTWAREHOME

IronOCR ile C##'da Metinleri Görüntü Olarak Vurgulayın

Curtis Chau
Curtis Chau
Updated: 4 Haziran 2026

IronOCR'nin HighlightTextAndSaveAsImages yöntemi, OCR sonuçlarını algılanan metin (karakterler, kelimeler, satırlar veya paragraflar) etrafına sınır kutuları çizerek görselleştirir ve geliştiricilerin OCR doğruluğunu doğrulaması ve tanıma sorunlarını gidermesi için tanı teşhis görüntüleri olarak kaydeder.

OCR sonuçlarını görselleştirmek, motorun görüntüde algıladığı belirli metin öğeleri etrafında kenarlık kutuları oluşturmayı içerir. Bu işlem, bireysel karakterlerin, kelimelerin, satırların veya paragrafların tam konumları üzerine farklı vurgular yerleştirir ve tanınan içeriğin net bir haritasını sağlar.

Bu görsel geri bildirim, OCR çıktısı doğruluğunu doğrulamak ve yazılımın neyi tanımladığını ve hataları nerede yaptığını gösteren hata ayıklama için kritik öneme sahiptir. Karmaşık belgelerle çalışırken veya tanıma sorunlarını giderirken, görsel vurgulama önemli bir teşhis aracı haline gelir.

Bu makale, IronOCR'nin diagnostik yeteneklerini HighlightTextAndSaveAsImages yöntemi ile gösterir. Bu işlev, belirli metin bölümlerini vurgular ve doğrulama için bunları görüntü olarak kaydeder. Bir belge işleme sistemi kuruyorsanız, kalite kontrol önlemleri uyguluyorsanız veya OCR uygulamanızı doğruluyorsanız, bu özellik OCR motorunun algıladığı hakkında anında görsel geri bildirim sağlar.

Başlangıç Yapın: Metinlerinizi PDF'nizde Hızla Vurgulayın

Bu kod parçacığı IronOCR kullanımını gösterir: bir PDF yükleyin ve içindeki her kelimeyi vurgulayın, sonucu görüntüler olarak kaydedin. OCR sonuçlarınız hakkında görsel geri bildirim almak için sadece bir satır.

  1. 1Install IronOCR with NuGet Package Manager

    PM > Install-Package IronOcr

  2. 2Bu kod parçacığını kopyalayın ve çalıştırın.

    new IronOcr.OcrInput().LoadPdf("document.pdf").HighlightTextAndSaveAsImages(new IronOcr.IronTesseract(), "highlight_page_", IronOcr.ResultHighlightType.Word);
    C#
  3. 3Canlı ortamınızda test için dağıtım yapın

    Ücretsiz deneme ile bugün projenizde IronOCR kullanmaya başlayın
    arrow pointer

Metni Vurgulayıp Görüntü Olarak Kaydetmek Nasıl Yapılır?

Metni vurgulamak ve görüntü olarak kaydetmek IronOCR ile basittir. Varolan bir PDF'yi LoadPdf ile yükleyin, ardından metin bölümlerini vurgulamak ve onları görüntü olarak kaydetmek için HighlightTextByType yöntemini çağırın. Bu teknik, OCR doğruluğunu doğrular ve belgelerinizde metin tanıma sorunlarını ayıklar.

Yöntem üç parametre alır: IronTesseract OCR motoru, çıktı dosya adının ön eki ve vurgulanacak metin türünü belirten ResultHighlightType enums. Bu örnek, metin bloklarını paragraflar olarak vurgulamak için ResultHighlightType.Paragraph kullanır. HighlightTextAndSaveAsImages

Lütfen dikkate alın: Bu fonksiyon, çıktı dizi ön ekini kullanır ve her sayfaya ait çıktı görüntü dosya ismine bir sayfa tanımlayıcı (örneğin, "page_0", "page_1") ekler.

Bu örnek, üç paragraf içeren bir PDF kullanır.

Giriş PDF'si Nasıl Görünüyor?

Vurgulama Kodunu Nasıl Uygularım?

Aşağıdaki örnek kod, OcrInput sınıfı kullanılarak temel uygulamayı gösterir.

using IronOcr;

IronTesseract ocrTesseract = new IronTesseract();

using var ocrInput = new OcrInput();
ocrInput.LoadPdf("document.pdf");
ocrInput.HighlightTextAndSaveAsImages(ocrTesseract, "highlight_page_", ResultHighlightType.Paragraph);

Çıktı Görüntüleri Ne Gösteriyor?

Web sayfasında üç paragraf, ortadaki paragraf kırmızı çerçeve ile vurgulandı ve metin seçimi yeteneğini gösteriyor

Yukarıdaki çıktı görüntüsünde gösterildiği gibi, tüm üç paragraf açık kırmızı bir kutu ile vurgulanmıştır. Bu görsel temsil, geliştiricilerin OCR motorunun belgeyi nasıl okunabilir bloklara ayırdığını hızla belirlemesine yardımcı olur.

Farklı ResultHighlightType Seçenekleri Nedir?

Yukarıdaki örnek, metin bloklarını vurgulamak için ResultHighlightType.Paragraph kullandı. IronOCR, bu enum aracılığıyla ek vurgulama seçenekleri sunar. Aşağıda her biri farklı teşhis amaçlarına hizmet eden mevcut türlerin tam bir listesi bulunmaktadır.

Karakter: OCR motoru tarafından algılanan her bir karakterin etrafında bir çerçeve çizer. Özellikle özel dil dosyaları ile çalışırken karakter tanıma veya özel yazı tiplerini ayıklamak için faydalıdır.

Kelime: Motor tarafından tanımlanan her bir tam kelimeyi vurgular. Özellikle barkod ve QR okuma ile birlikte metin tanıması uygularken kelime sınırlarını ve doğru kelime tespiti doğrulamak için idealdir.

Satır: Algılanan her metin satırını vurgular. Satır tanımlama doğrulaması gerektiren karmaşık düzenlere sahip belgeler için kullanışlıdır, örn. tarama belgeleri işlenirken.

Paragraf: Paragraflar olarak gruplanmış tüm metin bloklarını vurgular. Belge düzenini anlamak ve metin blok segmentasyonunu doğrulamak için mükemmeldir, özellikle tablo çıkartma ile çalışırken faydalıdır.

Farklı Vurgulama Türlerini Nasıl Karşılaştırabilirim?

Bu kapsamlı örnek, aynı belgede tüm farklı türler için vurguların oluşturulmasını gösterir, böylece sonuçları karşılaştırabilirsiniz:

using IronOcr;
using System;

// Initialize the OCR engine with custom configuration
IronTesseract ocrTesseract = new IronTesseract();

// Configure for better accuracy if needed
ocrTesseract.Configuration.ReadBarCodes = false; // Disable if not needed for performance
ocrTesseract.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.AutoOsd;

// Load the PDF document
using var ocrInput = new OcrInput();
ocrInput.LoadPdf("document.pdf");

// Generate highlights for each type
Console.WriteLine("Generating character-level highlights...");
ocrInput.HighlightTextAndSaveAsImages(ocrTesseract, "highlight_character_", ResultHighlightType.Character);

Console.WriteLine("Generating word-level highlights...");
ocrInput.HighlightTextAndSaveAsImages(ocrTesseract, "highlight_word_", ResultHighlightType.Word);

Console.WriteLine("Generating line-level highlights...");
ocrInput.HighlightTextAndSaveAsImages(ocrTesseract, "highlight_line_", ResultHighlightType.Line);

Console.WriteLine("Generating paragraph-level highlights...");
ocrInput.HighlightTextAndSaveAsImages(ocrTesseract, "highlight_paragraph_", ResultHighlightType.Paragraph);

Console.WriteLine("All highlight images have been generated successfully!");

Çok Sayfalı Belgeleri Nasıl İşlerim?

Çok sayfalı PDF'leri veya çok çerçeveli TIFF dosyalarını işlerken, vurgulama özelliği her sayfayı ayrı ayrı otomatik olarak yönetir. Bu, PDF OCR metin çıkartma iş akışları uyguladığınızda özellikle kullanışlıdır:

using IronOcr;
using System.IO;

IronTesseract ocrTesseract = new IronTesseract();

// Load a multi-page document
using var ocrInput = new OcrInput();
ocrInput.LoadPdf("multi-page-document.pdf");

// Create output directory if it doesn't exist
string outputDir = "highlighted_pages";
Directory.CreateDirectory(outputDir);

// Generate highlights for each page
// Files will be named: highlighted_pages/page_0.png, page_1.png, etc.
ocrInput.HighlightTextAndSaveAsImages(ocrTesseract, 
    Path.Combine(outputDir, "page_"), 
    ResultHighlightType.Word);

// Count generated files for verification
int pageCount = Directory.GetFiles(outputDir, "page_*.png").Length;
Console.WriteLine($"Generated {pageCount} highlighted page images");

Performans için En İyi Uygulamalar Nedir?

Vurgulama özelliğini kullanırken bu en iyi uygulamaları göz önünde bulundurun:

  1. Dosya Boyutu: Vurgulanan görüntüler, özellikle yüksek çözünürlüklü belgeler için büyük olabilir. Büyük partileri işlerken çıkış dizininin kullanılabilir alanını dikkate alın. Optimizasyon ipuçları için hızlı OCR yapılandırma rehberimize bakın.

  2. Performans: Vurguların oluşturulması işlem yükü ekler. Üretim sistemlerinde vurguların sadece ara sıra gerekli olduğu durumlarda, bunları ana iş akışının bir parçası yerine ayrı bir teşhis işlemi olarak uygulayın. Toplu işlem için çok iş parçacıklı OCR kullanmayı düşünün.

  3. Hata Ayıklama: Dosya işlemleriyle çalışırken her zaman uygun hata ayıklama uygulayın:

try
{
    using var ocrInput = new OcrInput();
    ocrInput.LoadPdf("document.pdf");
    
    // Apply image filters if needed for better recognition
    ocrInput.Deskew(); // Correct slight rotations
    ocrInput.DeNoise(); // Remove background noise
    
    ocrInput.HighlightTextAndSaveAsImages(ocrTesseract, "highlight_", ResultHighlightType.Word);
}
catch (Exception ex)
{
    Console.WriteLine($"Error during highlighting: {ex.Message}");
    // Log error details for debugging
}

Vurgulama OCR Sonuçlarıyla Nasıl Entegre Olur?

Vurgulama özelliği, IronOCR'nin sonuç nesneleri ile sorunsuz bir şekilde çalışır, böylece görsel vurguları çıkarılan metin verileriyle ilişkilendirmenize olanak tanır. Bu, tanınan metnin belirli bölümlerini track OCR progress veya doğrulamanız gerektiğinde özellikle faydalıdır. OcrResult sınıfı, bu yöntemle oluşturulan görsel vurgulara doğrudan karşılık gelen her bir algılanan eleman hakkında ayrıntılı bilgi sağlar.

Problemlerle Karşılaşırsam Ne Yapmalıyım?

Vurgulama özelliğiyle ilgili sorun yaşıyorsa, yaygın çözümler için genel sorun giderme rehberine başvurun. Özellikle vurgulamayla ilgili sorunlar için:

Bunu Üretim Hata Ayıklaması İçin Nasıl Kullanabilirim?

Vurgulama özelliği, mükemmel bir üretim hata ayıklama aracı olarak hizmet eder. Uzun süren işlemler için iptal tokenleri ve zaman aşımları ile entegre edildiğinde güçlü bir teşhis sistemi oluşturabilirsiniz. Uygulamanızda bir hata ayıklama modu uygulamayı düşünün:

public class OcrDebugger
{
    private readonly IronTesseract _tesseract;
    private readonly bool _debugMode;
    
    public OcrDebugger(bool enableDebugMode = false)
    {
        _tesseract = new IronTesseract();
        _debugMode = enableDebugMode;
    }
    
    public OcrResult ProcessDocument(string filePath)
    {
        using var input = new OcrInput();
        input.LoadPdf(filePath);
        
        // Apply preprocessing
        input.Deskew();
        input.DeNoise();
        
        // Generate debug highlights if in debug mode
        if (_debugMode)
        {
            string debugPath = $"debug_{Path.GetFileNameWithoutExtension(filePath)}_";
            input.HighlightTextAndSaveAsImages(_tesseract, debugPath, ResultHighlightType.Word);
        }
        
        // Perform actual OCR
        return _tesseract.Read(input);
    }
}

Bir Sonraki İstikamet Neresi?

Artık vurgulama özelliğini nasıl kullanacağınızı anladığınıza göre, keşfedin:

Üretim kullanımı için, filigranları kaldırmak ve tam işlevselliğe erişmek üzere bir lisans edinin unutmayın.

Sıkça Sorulan Sorular

C# uygulamamda OCR sonuçlarını nasıl görselleştirebilirim?

IronOCR, tespit edilen metin öğeleri (karakterler, kelimeler, satırlar ve paragraflar) etrafına kenarlık çizgileri çizerek ve bunları tanılama görüntüleri olarak kaydederek OCR sonuçlarını görselleştiren HighlightTextAndSaveAsImages yöntemini sağlar. Bu özellik, geliştiricilerin OCR doğruluğunu doğrulamasına ve tanıma sorunlarını hata ayıklamasına yardımcı olur.

Bir PDF belgesindeki kelimeleri en basit şekilde nasıl vurgularım?

IronOCR ile sadece bir satır kodla bir PDF'deki kelimeleri vurgulayabilirsiniz: new IronOcr.OcrInput().LoadPdf("document.pdf").HighlightTextAndSaveAsImages(new IronOcr.IronTesseract(), "highlight_page_", IronOcr.ResultHighlightType.Word). Bu, PDF'yi yükler ve vurgulanan kelimelerle birlikte görüntüler oluşturur.

HighlightTextAndSaveAsImages yöntemi hangi parametreleri gerektirir?

IronOCR içinde HighlightTextAndSaveAsImages yöntemi üç parametre gerektirir: IronTesseract OCR motoru örneği, çıktı dosya adı ön eki için bir dize ve hangi metin öğelerinin vurgulanacağını belirten bir ResultHighlightType enum değeri (Karakter, Kelime, Satır veya Paragraf).

Metin vurgulama kullanılırken çıktı görüntüleri nasıl adlandırılır?

IronOCR otomatik olarak belirtilen ön ek ile bir sayfa tanımlayıcıyı birleştirerek çıktı görüntülerini adlandırır. Örneğin, "highlight_page_" ön eki kullanılırsa, yöntem belge içindeki her sayfa için "highlight_page_0", "highlight_page_1", vb. gibi adlandırılmış dosyalar oluşturur.

OCR geliştirme için görsel vurgulamanın önemi nedir?

IronOCR'dakı görsel vurgulama, OCR motorunun tam olarak hangi metni tespit ettiğini ve olası hataların nerede oluştuğunu göstererek kapsamlı tanılama geri bildirimi sağlar. Bu görsel harita, geliştiricilerin tanıma sorunlarını çözmesine, OCR doğruluğunu doğrulamasına ve karmaşık belgelerde problemlerin üstesinden gelmesine yardımcı olur.

Kelime dışında farklı metin öğelerini de vurgulayabilir miyim?

Evet, IronOCR'nun ResultHighlightType enum'u, bireysel Karakterler, Kelimeler, Satırlar veya tüm Paragraflar dahil olmak üzere çeşitli metin öğelerini vurgulamanıza olanak tanır. HighlightTextAndSaveAsImages yöntemini çağırırken istenen türü belirtmeniz yeterlidir.

How can I address issues with blank output images in IronOCR?

Ensure the input document contains readable text, and that the OCR engine is configured correctly. You may also need image optimization or orientation adjustments to improve results.

What performance best practices should I follow when using IronOCR highlights?

Manage large highlighted images by ensuring enough available space and consider implementing multithreading for improved speed. Proper error handling should also be in place for file operations.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...
Daha Fazla Oku

Başlamaya Hazır mısınız?

Nuget Downloads 6,236,385Sürüm:2026.9yeni yayınlandı

Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez
PDF için C# NuGet Kütüphanesi
NuGet ile yükleyin

Sürüm: 2026.9

PM > Install-Package IronOcr
nuget.org/packages/IronOcr/
  1. Çözüm Gezgini'nde Referanslar'a sağ tıklayın, NuGet Paketlerini Yönet
  2. "IronOCR" aratıp seçin
  3. Paketi seçin ve yükleyin
C# PDF DLL
DLL İndir

Sürüm: 2026.9

veya buradan Windows Yükleyicisini indirin.

  1. IronOCR'u ~/Libs gibi bir yere indirip sıkıştırmasını açın, Çözüm dizininizde
  2. Visual Studio Çözüm Gezgini'nde, Referanslar'a sağ tıklayın. Gözat'ı seçin, "IronOCR.dll"

$999'dan itibaren lisanslar

Key in blue circle

Ücretsiz 30 günlük Deneme Anahtarınızı anında edinin.

Your trial license will be sent to your email address

Herhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.

bullet_checkedKredi kartı veya hesap oluşturma gerektirmezHerhangi bir sınırlama yoktur. %100 erişim. Kredi kartı gerekmez.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Bağımsız Danışmanlık Alın
Aşağıdaki formu doldurun veya sales@ironsoftware.com adresine e-posta gönderin
Bilgileriniz daima gizli kalacaktır.
Dünya Çapında Milyonlarca Mühendisin Güvendiği
Iron Software müşteri logoları
Ücretsiz 30 Günlük Deneme Anahtarınızı anında alın.
Kredi kartı veya hesap oluşturma gerektirmez