如何從影像文件中提取文字

如何在C#中使用Iron Tesseract

This article was translated from English: Does it need improvement?
Translated
View the article in English

在C#中使用Iron Tesseract是透過建立一個Read()方法。 這將使用Tesseract 5的優化引擎將文字圖像轉換為可搜尋的PDF。

IronOCR提供了一個直觀的API來使用客製化和優化的Tesseract 5,稱之為Iron Tesseract。 通過使用IronOCR和IronTesseract,您將能夠將文字和掃描的文件圖像轉換為文字和可搜尋的PDF。 該程式庫支援125種國際語言,並包括像條碼閱讀電腦視覺這樣的先進功能。

快速開始:設置IronTesseract配置在C#中

此範例展示如何使用特定設置配置IronTesseract並在一行程式碼中執行OCR。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronOcr

    PM > Install-Package IronOcr
  2. 複製並運行這段程式碼片段。

    var result = new IronOcr.IronTesseract { Language = IronOcr.OcrLanguage.English, Configuration = new IronOcr.TesseractConfiguration { ReadBarCodes = false, RenderSearchablePdf = true, WhiteListCharacters = "ABCabc123" } }.Read(new IronOcr.OcrInput("image.png"));
  3. 部署以在您的實時環境中測試

    今天就開始在您的專案中使用IronOCR,透過免費試用

    arrow pointer

我如何建立一個IronTesseract實例?

使用此程式碼初始化一個Tesseract物件:

:path=/static-assets/ocr/content-code-examples/how-to/irontesseract-initialize-irontesseract.cs
using IronOcr;

IronTesseract ocr = new IronTesseract();
Imports IronOcr

Dim ocr As New IronTesseract()
$vbLabelText   $csharpLabel

您可以通過選擇不同的語言、啟用條碼閱讀以及白名單/黑名單字元來自定義IronTesseract的行為。 IronOCR提供了全面的配置選項以微調您的OCR過程:

:path=/static-assets/ocr/content-code-examples/how-to/irontesseract-configure-irontesseract.cs
IronTesseract ocr = new IronTesseract
{
    Configuration = new TesseractConfiguration
    {
        ReadBarCodes = false,
        RenderHocr = true,
        TesseractVariables = null,
        WhiteListCharacters = null,
        BlackListCharacters = "`ë|^",
    },
    MultiThreaded = false,
    Language = OcrLanguage.English,
    EnableTesseractConsoleMessages = true, // False as default
};
Dim ocr As New IronTesseract With {
	.Configuration = New TesseractConfiguration With {
		.ReadBarCodes = False,
		.RenderHocr = True,
		.TesseractVariables = Nothing,
		.WhiteListCharacters = Nothing,
		.BlackListCharacters = "`ë|^"
	},
	.MultiThreaded = False,
	.Language = OcrLanguage.English,
	.EnableTesseractConsoleMessages = True
}
$vbLabelText   $csharpLabel

一旦配置好,您就可以使用Tesseract功能來讀取OcrInput物件。 OcrInput類提供了靈活的方法來載入各種輸入格式:

:path=/static-assets/ocr/content-code-examples/how-to/irontesseract-read.cs
IronTesseract ocr = new IronTesseract();

using OcrInput input = new OcrInput();
input.LoadImage("attachment.png");
OcrResult result = ocr.Read(input);
string text = result.Text;
Dim ocr As New IronTesseract()

Using input As New OcrInput()
	input.LoadImage("attachment.png")
	Dim result As OcrResult = ocr.Read(input)
	Dim text As String = result.Text
End Using
$vbLabelText   $csharpLabel

對於複雜的場景,您可以利用多執行緒功能同時處理多個文件,大大提高批處理操作的性能。

什麼是高級Tesseract配置變數?

IronOcr Tesseract介面允許通過IronOcr.TesseractConfiguration類全面控制Tesseract配置變數。 這些高級設置使您能夠為特定用例優化OCR性能,例如修正低質量掃描閱讀特定文件型別

如何在程式碼中使用Tesseract配置?

:path=/static-assets/ocr/content-code-examples/how-to/irontesseract-tesseract-configuration.cs
using IronOcr;
using System;

IronTesseract Ocr = new IronTesseract();

Ocr.Language = OcrLanguage.English;
Ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.AutoOsd;

// Configure Tesseract Engine
Ocr.Configuration.TesseractVariables["tessedit_parallelize"] = false;

using var input = new OcrInput();
input.LoadImage("/path/file.png");

OcrResult Result = Ocr.Read(input);
Console.WriteLine(Result.Text);
Imports IronOcr
Imports System

Private Ocr As New IronTesseract()

Ocr.Language = OcrLanguage.English
Ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.AutoOsd

' Configure Tesseract Engine
Ocr.Configuration.TesseractVariables("tessedit_parallelize") = False

Dim input = New OcrInput()
input.LoadImage("/path/file.png")

Dim Result As OcrResult = Ocr.Read(input)
Console.WriteLine(Result.Text)
$vbLabelText   $csharpLabel

IronOCR還提供了針對不同文件型別的專用配置。例如,當閱讀護照處理MICR支票時,您可以應用特定的預處理過濾器和區域檢測以提高準確性。

金融文件的範例配置:

:path=/static-assets/ocr/content-code-examples/how-to/iron-tesseract-6.cs
// Example: Configure for financial documents
IronTesseract ocr = new IronTesseract
{
    Language = OcrLanguage.English,
    Configuration = new TesseractConfiguration
    {
        PageSegmentationMode = TesseractPageSegmentationMode.SingleBlock,
        TesseractVariables = new Dictionary<string, object>
        {
            ["tessedit_char_whitelist"] = "0123456789.$,",
            ["textord_heavy_nr"] = false,
            ["edges_max_children_per_outline"] = 10
        }
    }
};

// Apply preprocessing filters for better accuracy
using OcrInput input = new OcrInput();
input.LoadPdf("financial-document.pdf");
input.Deskew();
input.EnhanceResolution(300);

OcrResult result = ocr.Read(input);
Imports IronOcr

' Example: Configure for financial documents
Dim ocr As New IronTesseract With {
    .Language = OcrLanguage.English,
    .Configuration = New TesseractConfiguration With {
        .PageSegmentationMode = TesseractPageSegmentationMode.SingleBlock,
        .TesseractVariables = New Dictionary(Of String, Object) From {
            {"tessedit_char_whitelist", "0123456789.$,"},
            {"textord_heavy_nr", False},
            {"edges_max_children_per_outline", 10}
        }
    }
}

' Apply preprocessing filters for better accuracy
Using input As New OcrInput()
    input.LoadPdf("financial-document.pdf")
    input.Deskew()
    input.EnhanceResolution(300)

    Dim result As OcrResult = ocr.Read(input)
End Using
$vbLabelText   $csharpLabel

所有Tesseract配置變數的完整列表是什麼?

這些可以使用IronTesseract.Configuration.TesseractVariables["key"] = value;設置。 配置變數允許您微調OCR行為,以便針對特定文件獲得最佳結果。 有關優化OCR性能的詳細指南,請參閱我們的快速OCR配置指南

Tesseract配置變數 Default 含義
classify_num_cp_levels3類剪裁程式的層級數量
textord_debug_tabfind0除錯標籤查找
textord_debug_bugs0啟用關於標籤查找中的錯誤的輸出
textord_testregion_left-1除錯報告矩形的左邊緣
textord_testregion_top-1除錯報告矩形的上邊緣
textord_testregion_right2147483647除錯矩形的右邊緣
textord_testregion_bottom2147483647除錯矩形的底部邊緣
textord_tabfind_show_partitions0顯示分區邊界,若>1則等待
devanagari_split_debuglevel0分割shiro-rekha過程的除錯級別。
edges_max_children_per_outline10字元輪廓內最大子項數量
edges_max_children_layers5字元輪廓內巢狀子項的最大層數
edges_children_per_grandchild10丟棄輪廓的重點比例
edges_children_count_limit45blob中允許的最大孔洞數
edges_min_nonhole12方框中潛在字元的最少像素
edges_patharea_ratio40Max lensq/area for acceptable child outline
textord_fp_chop_error2允許的切割單元最大彎曲度
textord_tabfind_show_images0Show image blobs
textord_skewsmooth_offset4平滑因子
textord_skewsmooth_offset21平滑因子
textord_test_x-2147483647測試點的坐標
textord_test_y-2147483647測試點的坐標
textord_min_blobs_in_row4在梯度计数前的最小Blob數
textord_spline_minblobs8Min blobs in each spline segment
textord_spline_medianwin6Size of window for spline segmentation
textord_max_blob_overlaps4Max number of blobs a big blob can overlap
textord_min_xheight10Min credible pixel xheight
textord_lms_line_trials12Number of linew fits to do
oldbl_holed_losscount10Max lost before fallback line used
pitsync_linear_version6Use new fast algorithm
pitsync_fake_depth1Max advance fake generation
textord_tabfind_show_strokewidths0Show stroke widths
textord_dotmatrix_gap3Max pixel gap for broken pixed pitch
textord_debug_block0Block to do debug on
textord_pitch_range2Max range test on pitch
textord_words_veto_power5Rows required to outvote a veto
equationdetect_save_bi_image0Save input bi image
equationdetect_save_spt_image0Save special character image
equationdetect_save_seed_image0Save the seed image
equationdetect_save_merged_image0Save the merged image
poly_debug0Debug old poly
poly_wide_objects_better1More accurate approx on wide things
wordrec_display_splits0Display splits
textord_debug_printable0Make debug windows printable
textord_space_size_is_variable0If true, word delimiter spaces are assumed to have variable width, even though characters have fixed pitch.
textord_tabfind_show_initial_partitions0Show partition bounds
textord_tabfind_show_reject_blobs0Show blobs rejected as noise
textord_tabfind_show_columns0Show column bounds
textord_tabfind_show_blocks0Show final block bounds
textord_tabfind_find_tables1run table detection
devanagari_split_debugimage0Whether to create a debug image for split shiro-rekha process.
textord_show_fixed_cuts0Draw fixed pitch cell boundaries
edges_use_new_outline_complexity0Use the new outline complexity module
edges_debug0turn on debugging for this module
edges_children_fix0Remove boxy parents of char-like children
gapmap_debug0Say which blocks have tables
gapmap_use_ends0Use large space at start and end of rows
gapmap_no_isolated_quanta0Ensure gaps not less than 2quanta wide
textord_heavy_nr0Vigorously remove noise
textord_show_initial_rows0Display row accumulation
textord_show_parallel_rows0Display page correlated rows
textord_show_expanded_rows0Display rows after expanding
textord_show_final_rows0Display rows after final fitting
textord_show_final_blobs0Display blob bounds after pre-ass
textord_test_landscape0Tests refer to land/port
textord_parallel_baselines1Force parallel baselines
textord_straight_baselines0Force straight baselines
textord_old_baselines1Use old baseline algorithm
textord_old_xheight0Use old xheight algorithm
textord_fix_xheight_bug1Use spline baseline
textord_fix_makerow_bug1Prevent multiple baselines
textord_debug_xheights0Test xheight algorithms
textord_biased_skewcalc1Bias skew estimates with line length
textord_interpolating_skew1Interpolate across gaps
textord_new_initial_xheight1Use test xheight mechanism
textord_debug_blob0Print test blob information
textord_really_old_xheight0Use original wiseowl xheight
textord_oldbl_debug0Debug old baseline generation
textord_debug_baselines0Debug baseline generation
textord_oldbl_paradef1Use para default mechanism
textord_oldbl_split_splines1Split stepped splines
textord_oldbl_merge_parts1Merge suspect partitions
oldbl_corrfix1Improve correlation of heights
oldbl_xhfix0Fix bug in modes threshold for xheights
textord_ocropus_mode0Make baselines for ocropus
textord_tabfind_only_strokewidths0Only run stroke widths
textord_tabfind_show_initialtabs0Show tab candidates
textord_tabfind_show_finaltabs0Show tab vectors
textord_show_tables0Show table regions
textord_tablefind_show_mark0Debug table marking steps in detail
textord_tablefind_show_stats0Show page stats used in table finding
textord_tablefind_recognize_tables0Enables the table recognizer for table layout and filtering.
textord_all_prop0All doc is proportial text
textord_debug_pitch_test0Debug on fixed pitch test
textord_disable_pitch_test0Turn off dp fixed pitch algorithm
textord_fast_pitch_test0Do even faster pitch algorithm
textord_debug_pitch_metric0Write full metric stuff
textord_show_row_cuts0Draw row-level cuts
textord_show_page_cuts0Draw page-level cuts
textord_pitch_cheat0Use correct answer for fixed/prop
textord_blockndoc_fixed0Attempt whole doc/block fixed pitch
textord_show_initial_words0Display separate words
textord_show_new_words0Display separate words
textord_show_fixed_words0Display forced fixed pitch words
textord_blocksall_fixed0Moan about prop blocks
textord_blocksall_prop0Moan about fixed pitch blocks
textord_blocksall_testing0Dump stats when moaning
textord_test_mode0Do current test
textord_pitch_rowsimilarity0.08Fraction of xheight for sameness
words_initial_lower0.5Max initial cluster size
words_initial_upper0.15Min initial cluster spacing
words_default_prop_nonspace0.25Fraction of xheight
words_default_fixed_space0.75Fraction of xheight
words_default_fixed_limit0.6Allowed size variance
textord_words_definite_spread0.3Non-fuzzy spacing region
textord_spacesize_ratiofp2.8Min ratio space/nonspace
textord_spacesize_ratioprop2Min ratio space/nonspace
textord_fpiqr_ratio1.5Pitch IQR/Gap IQR threshold
textord_max_pitch_iqr0.2Xh fraction noise in pitch
textord_fp_min_width0.5Min width of decent blobs
textord_underline_offset0.1Fraction of x to ignore
ambigs_debug_level0Debug level for unichar ambiguities
classify_debug_level0Classify debug level
classify_norm_method1Normalization Method ...
matcher_debug_level0Matcher Debug Level
matcher_debug_flags0Matcher Debug Flags
classify_learning_debug_level0Learning Debug Level:
matcher_permanent_classes_min1Min # of permanent classes
matcher_min_examples_for_ prototyping3Reliable Config Threshold
matcher_sufficient_examples_ for_prototyping5Enable adaption even if the ambiguities have not been seen
classify_adapt_proto_threshold230Threshold for good protos during adaptive 0-255
classify_adapt_feature_threshold230Threshold for good features during adaptive 0-255
classify_class_pruner_threshold229Class Pruner Threshold 0-255
classify_class_pruner_multiplier15Class Pruner Multiplier 0-255:
classify_cp_cutoff_strength7Class Pruner CutoffStrength:
classify_integer_matcher_multiplier10Integer Matcher Multiplier 0-255:
dawg_debug_level0Set to 1 for general debug info, to 2 for more details, to 3 to see all the debug messages
hyphen_debug_level0Debug level for hyphenated words.
stopper_smallword_size2Size of dict word to be treated as non-dict word
stopper_debug_level0Stopper debug level
tessedit_truncate_wordchoice_log10Max words to keep in list
max_permuter_attempts10000Maximum number of different character choices to consider during permutation. This limit is especially useful when user patterns are specified, since overly generic patterns can result in dawg search exploring an overly large number of options.
repair_unchopped_blobs1Fix blobs that aren't chopped
chop_debug0Chop debug
chop_split_length10000Split Length
chop_same_distance2Same distance
chop_min_outline_points6Min Number of Points on Outline
chop_seam_pile_size150Max number of seams in seam_pile
chop_inside_angle-50Min Inside Angle Bend
chop_min_outline_area2000Min Outline Area
chop_centered_maxwidth90Width of (smaller) chopped blobs above which we don't care that a chop is not near the center.
chop_x_y_weight3X / Y length weight
wordrec_debug_level0Debug level for wordrec
wordrec_max_join_chunks4Max number of broken pieces to associate
segsearch_debug_level0SegSearch debug level
segsearch_max_pain_points2000Maximum number of pain points stored in the queue
segsearch_max_futile_classifications20Maximum number of pain point classifications per chunk that did not result in finding a better word choice.
language_model_debug_level0Language model debug level
language_model_ngram_order8Maximum order of the character ngram model
language_model_viterbi_list_ max_num_prunable10Maximum number of prunable (those for which PrunablePath() is true) entries in each viterbi list recorded in BLOB_CHOICEs
language_model_viterbi_list_max_size500Maximum size of viterbi lists recorded in BLOB_CHOICEs
language_model_min_compound_length3Minimum length of compound words
wordrec_display_segmentations0Display Segmentations
tessedit_pageseg_mode6Page seg mode: 0=osd only, 1=auto+osd, 2=auto_only, 3=auto, 4=column, 5=block_vert, 6=block, 7=line, 8=word, 9=word_circle, 10=char,11=sparse_text, 12=sparse_text+osd, 13=raw_line (Values from PageSegMode enum in tesseract/publictypes.h)
tessedit_ocr_engine_mode2Which OCR engine(s) to run (Tesseract, LSTM, both). Defaults to loading and running the most accurate available.
pageseg_devanagari_split_strategy0Whether to use the top-line splitting process for Devanagari documents while performing page-segmentation.
ocr_devanagari_split_strategy0Whether to use the top-line splitting process for Devanagari documents while performing ocr.
bidi_debug0Debug level for BiDi
applybox_debug1Debug level
applybox_page0Page number to apply boxes from
tessedit_bigram_debug0Amount of debug output for bigram correction.
debug_noise_removal0Debug reassignment of small outlines
noise_maxperblob8Max diacritics to apply to a blob
noise_maxperword16Max diacritics to apply to a word
debug_x_ht_level0Reestimate debug
quality_min_initial_alphas_reqd2alphas in a good word
tessedit_tess_adaption_mode39Adaptation decision algorithm for tess
multilang_debug_level0Print multilang debug info.
paragraph_debug_level0Print paragraph debug info.
tessedit_preserve_min_wd_len2Only preserve wds longer than this
crunch_rating_max10For adj length in rating per ch
crunch_pot_indicators1How many potential indicators needed
crunch_leave_lc_strings4Don't crunch words with long lower case strings
crunch_leave_uc_strings4Don't crunch words with long lower case strings
crunch_long_repetitions3Crunch words with long repetitions
crunch_debug0As it says
fixsp_non_noise_limit1How many non-noise blbs either side?
fixsp_done_mode1What constitues done for spacing
debug_fix_space_level0Contextual fixspace debug
x_ht_acceptance_tolerance8Max allowed deviation of blob top outside of font data
x_ht_min_change8Min change in xht before actually trying it
superscript_debug0Debug level for sub & superscript fixer
jpg_quality85Set JPEG quality level
user_defined_dpi0Specify DPI for input image
min_characters_to_try50Specify minimum characters to try during OSD
suspect_level99Suspect marker level
suspect_short_words2Don't suspect dict wds longer than this
tessedit_reject_mode0Rejection algorithm
tessedit_image_border2Rej blbs near image edge limit
min_sane_x_ht_pixels8Reject any x-ht lt or eq than this
tessedit_page_number-1-1 -> All pages, else specific page to process
tessedit_parallelize1Run in parallel where possible
lstm_choice_mode2Allows to include alternative symbols choices in the hOCR output. Valid input values are 0, 1 and 2. 0 is the default value. With 1 the alternative symbol choices per timestep are included. With 2 alternative symbol choices are extracted from the CTC process instead of the lattice. The choices are mapped per character.
lstm_choice_iterations5Sets the number of cascading iterations for the Beamsearch in lstm_choice_mode. Note that lstm_choice_mode must be set to a value greater than 0 to produce results.
tosp_debug_level0Debug data
tosp_enough_space_samples_for_median3or should we use mean
tosp_redo_kern_limit10No.samples reqd to reestimate for row
tosp_few_samples40No.gaps reqd with 1 large gap to treat as a table
tosp_short_row20No.gaps reqd with few cert spaces to use certs
tosp_sanity_method1How to avoid being silly
textord_max_noise_size7Pixel size of noise
textord_baseline_debug0Baseline debug level
textord_noise_sizefraction10Fraction of size for maxima
textord_noise_translimit16Transitions for normal blob
textord_noise_sncount1super norm blobs to save row
use_ambigs_for_adaption0Use ambigs for deciding whether to adapt to a character
prioritize_division0Prioritize blob division over chopping
classify_enable_learning1Enable adaptive classifier
tess_cn_matching0Character Normalized Matching
tess_bn_matching0Baseline Normalized Matching
classify_enable_adaptive_matcher1Enable adaptive classifier
classify_use_pre_adapted_templates0Use pre-adapted classifier templates
classify_save_adapted_templates0Save adapted templates to a file
classify_enable_adaptive_debugger0Enable match debugger
classify_nonlinear_norm0Non-linear stroke-density normalization
disable_character_fragments1Do not include character fragments in the results of the classifier
classify_debug_character_fragments0Bring up graphical debugging windows for fragments training
matcher_debug_separate_windows0Use two different windows for debugging the matching: One for the protos and one for the features.
classify_bln_numeric_mode0Assume the input is numbers [0-9].
load_system_dawg1Load system word dawg.
load_freq_dawg1Load frequent word dawg.
load_unambig_dawg1Load unambiguous word dawg.
load_punc_dawg1Load dawg with punctuation patterns.
load_number_dawg1Load dawg with number patterns.
load_bigram_dawg1Load dawg with special word bigrams.
use_only_first_uft8_step0Use only the first UTF8 step of the given string when computing log probabilities.
stopper_no_acceptable_choices0Make AcceptableChoice() always return false. Useful when there is a need to explore all segmentations
segment_nonalphabetic_script0Don't use any alphabetic-specific tricks. Set to true in the traineddata config file for scripts that are cursive or inherently fixed-pitch
save_doc_words0Save Document Words
merge_fragments_in_matrix1Merge the fragments in the ratings matrix and delete them after merging
wordrec_enable_assoc1Associator Enable
force_word_assoc0force associator to run regardless of what enable_assoc is. This is used for CJK where component grouping is necessary.
chop_enable1Chop enable
chop_vertical_creep0Vertical creep
chop_new_seam_pile1Use new seam_pile
assume_fixed_pitch_char_segment0include fixed-pitch heuristics in char segmentation
wordrec_skip_no_truth_words0Only run OCR for words that had truth recorded in BlamerBundle
wordrec_debug_blamer0Print blamer debug messages
wordrec_run_blamer0Try to set the blame for errors
save_alt_choices1Save alternative paths found during chopping and segmentation search
language_model_ngram_on0Turn on/off the use of character ngram model
language_model_ngram_use_ only_first_uft8_step0Use only the first UTF8 step of the given string when computing log probabilities.
language_model_ngram_space_ delimited_language1Words are delimited by space
language_model_use_sigmoidal_certainty0Use sigmoidal score for certainty
tessedit_resegment_from_boxes0Take segmentation and labeling from box file
tessedit_resegment_from_line_boxes0Conversion of word/line box file to char box file
tessedit_train_from_boxes0Generate training data from boxed chars
tessedit_make_boxes_from_boxes0Generate more boxes from boxed chars
tessedit_train_line_recognizer0Break input into lines and remap boxes if present
tessedit_dump_pageseg_images0Dump intermediate images made during page segmentation
tessedit_do_invert1Try inverting the image in LSTMRecognizeWord
tessedit_ambigs_training0Perform training for ambiguities
tessedit_adaption_debug0Generate and print debug information for adaption
applybox_learn_chars_and_char_frags_mode0Learn both character fragments (as is done in the special low exposure mode) as well as unfragmented characters.
applybox_learn_ngrams_mode0Each bounding box is assumed to contain ngrams. Only learn the ngrams whose outlines overlap horizontally.
tessedit_display_outwords0Draw output words
tessedit_dump_choices0Dump char choices
tessedit_timing_debug0Print timing stats
tessedit_fix_fuzzy_spaces1Try to improve fuzzy spaces
tessedit_unrej_any_wd0Don't bother with word plausibility
tessedit_fix_hyphens1Crunch double hyphens?
tessedit_enable_doc_dict1Add words to the document dictionary
tessedit_debug_fonts0Output font info per char
tessedit_debug_block_rejection0Block and Row stats
tessedit_enable_bigram_correction1Enable correction based on the word bigram dictionary.
tessedit_enable_dict_correction0Enable single word correction based on the dictionary.
enable_noise_removal1Remove and conditionally reassign small outlines when they confuse layout analysis, determining diacritics vs noise
tessedit_minimal_rej_pass10Do minimal rejection on pass 1 output
tessedit_test_adaption0Test adaption criteria
test_pt0Test for point
paragraph_text_based1Run paragraph detection on the post-text-recognition (more accurate)
lstm_use_matrix1Use ratings matrix/beam search with lstm
tessedit_good_quality_unrej1Reduce rejection on good docs
tessedit_use_reject_spaces1Reject spaces?
tessedit_preserve_blk_rej_perfect_wds1Only rej partially rejected words in block rejection
tessedit_preserve_row_rej_perfect_wds1Only rej partially rejected words in row rejection
tessedit_dont_blkrej_good_wds0Use word segmentation quality metric
tessedit_dont_rowrej_good_wds0Use word segmentation quality metric
tessedit_row_rej_good_docs1Apply row rejection to good docs
tessedit_reject_bad_qual_wds1Reject all bad quality wds
tessedit_debug_doc_rejection0Page stats
tessedit_debug_quality_metrics0Output data to debug file
bland_unrej0unrej potential with no checks
unlv_tilde_crunching0Mark v.bad words for tilde crunch
hocr_font_info0Add font info to hocr output
hocr_char_boxes0Add coordinates for each character to hocr output
crunch_early_merge_tess_fails1Before word crunch?
crunch_early_convert_bad_unlv_chs0Take out ~^ early?
crunch_terrible_garbage1As it says
crunch_leave_ok_strings1Don't touch sensible strings
crunch_accept_ok1Use acceptability in okstring
crunch_leave_accept_strings0Don't pot crunch sensible strings
crunch_include_numerals0Fiddle alpha figures
tessedit_prefer_joined_punct0Reward punctuation joins
tessedit_write_block_separators0Write block separators in output
tessedit_write_rep_codes0Write repetition char code
tessedit_write_unlv0Write .unlv output file
tessedit_create_txt0Write .txt output file
tessedit_create_hocr0Write .html hOCR output file
tessedit_create_alto0Write .xml ALTO file
tessedit_create_lstmbox0Write .box file for LSTM training
tessedit_create_tsv0Write .tsv output file
tessedit_create_wordstrbox0Write WordStr format .box output file
tessedit_create_pdf0Write .pdf output file
textonly_pdf0Create PDF with only one invisible text layer
suspect_constrain_1Il0UNLV keep 1Il chars rejected
tessedit_minimal_rejection0Only reject tess failures
tessedit_zero_rejection0Don't reject ANYTHING
tessedit_word_for_word0Make output have exactly one word per WERD
tessedit_zero_kelvin_rejection0Don't reject ANYTHING AT ALL
tessedit_rejection_debug0Adaption debug
tessedit_flip_0O1Contextual 0O O0 flips
rej_trust_doc_dawg0Use DOC dawg in 11l conf. detector
rej_1Il_use_dict_word0Use dictword test
rej_1Il_trust_permuter_type1Don't double check
rej_use_tess_accepted1Individual rejection control
rej_use_tess_blanks1Individual rejection control
rej_use_good_perm1Individual rejection control
rej_use_sensible_wd0Extend permuter check
rej_alphas_in_number_perm0Extend permuter check
tessedit_create_boxfile0Output text with boxes
tessedit_write_images0Capture the image from the IPE
interactive_display_mode0Run interactively?
tessedit_override_permuter1According to dict_word
tessedit_use_primary_params_model0In multilingual mode use params model of the primary language
textord_tabfind_show_vlines0Debug line finding
textord_use_cjk_fp_model0Use CJK fixed pitch model
poly_allow_detailed_fx0Allow feature extractors to see the original outline
tessedit_init_config_only0Only initialize with the config file. Useful if the instance is not going to be used for OCR but say only for layout analysis.
textord_equation_detect0Turn on equation detector
textord_tabfind_vertical_text1Enable vertical detection
textord_tabfind_force_vertical_text0Force using vertical text page mode
preserve_interword_spaces0Preserve multiple interword spaces
pageseg_apply_music_mask1Detect music staff and remove intersecting components
textord_single_height_mode0Script has no xheight, so use a single mode
tosp_old_to_method0Space stats use prechopping?
tosp_old_to_constrain_sp_kn0Constrain relative values of inter and intra-word gaps for old_to_method.
tosp_only_use_prop_rows1Block stats to use fixed pitch rows?
tosp_force_wordbreak_on_punct0Force word breaks on punct to break long lines in non-space delimited langs
tosp_use_pre_chopping0Space stats use prechopping?
tosp_old_to_bug_fix0Fix suspected bug in old code
tosp_block_use_cert_spaces1Only stat OBVIOUS spaces
tosp_row_use_cert_spaces1Only stat OBVIOUS spaces
tosp_narrow_blobs_not_cert1Only stat OBVIOUS spaces
tosp_row_use_cert_spaces11Only stat OBVIOUS spaces
tosp_recovery_isolated_row_stats1Use row alone when inadequate cert spaces
tosp_only_small_gaps_for_kern0Better guess
tosp_all_flips_fuzzy0Pass ANY flip to context?
tosp_fuzzy_limit_all1Don't restrict kn->sp fuzzy limit to tables
textord_no_rejects0Don't remove noise blobs
textord_show_blobs0Display unsorted blobs
textord_show_boxes0Display unsorted blobs
textord_noise_rejwords1Reject noise-like words
textord_noise_rejrows1Reject noise-like rows
textord_noise_debug0Debug row garbage detector
classify_learn_debug_strClass str to debug learning
user_words_fileA filename of user-provided words.
user_words_suffixA suffix of user-provided words located in tessdata.
user_patterns_fileA filename of user-provided patterns.
user_patterns_suffixA suffix of user-provided patterns located in tessdata.
output_ambig_words_fileOutput file for ambiguities found in the dictionary
word_to_debugWord for which stopper debug information should be printed to stdout
tessedit_char_blacklistBlacklist of chars not to recognize
tessedit_char_whitelistWhitelist of chars to recognize
tessedit_char_unblacklistList of chars to override tessedit_char_blacklist
tessedit_write_params_to_fileWrite all parameters to the given file.
applybox_exposure_pattern.expExposure value follows this pattern in the image filename. The name of the image files are expected to be in the form [lang].[fontname].exp [num].tif
chs_leading_punct('`"前置標點符號
chs_trailing_punct1).,;:?!1st Trailing punctuation
chs_trailing_punct2)'`"2nd Trailing punctuation
outlines_odd%|非標準輪廓數量
outlines_2ij!?%":;非標準輪廓數量
numeric_punctuation.,Punct. chs expected WITHIN numbers
unrecognised_char|Output char for unidentified blobs
ok_repeated_ch_non_alphanum_wds-?*=Allow NN to unrej
conflict_set_I_l_1Il1 []Il1 conflict set
file_type.tifFilename extension
tessedit_load_sublangsList of languages to load with this one
page_separatorPage separator (default is form feed control character)
classify_char_norm_range0.2Character Normalization Range ...
classify_max_rating_ratio1.5Veto ratio between classifier ratings
classify_max_certainty_margin5.5Veto difference between classifier certainties
matcher_good_threshold0.125Good Match (0-1)
matcher_reliable_adaptive_result0Great Match (0-1)
matcher_perfect_threshold0.02Perfect Match (0-1)
matcher_bad_match_pad0.15Bad Match Pad (0-1)
matcher_rating_margin0.1New template margin (0-1)
matcher_avg_noise_size12Avg. noise blob length
matcher_clustering_max_angle_delta0.015Maximum angle delta for prototype clustering
classify_misfit_junk_penalty0Penalty to apply when a non-alnum is vertically out of its expected textline position
rating_scale1.5Rating scaling factor
certainty_scale20Certainty scaling factor
tessedit_class_miss_scale0.00390625Scale factor for features not used
classify_adapted_pruning_factor2.5Prune poor adapted results this much worse than best result
classify_adapted_pruning_threshold-1Threshold at which classify_adapted_pruning_factor starts
classify_character_fragments_ garbage_certainty_threshold-3Exclude fragments that do not look like whole characters from training and adaption
speckle_large_max_size0.3Max large speckle size
speckle_rating_penalty10Penalty to add to worst rating for noise
xheight_penalty_subscripts0.125Score penalty (0.1 = 10%) added if there are subscripts or superscripts in a word, but it is otherwise OK.
xheight_penalty_inconsistent0.25Score penalty (0.1 = 10%) added if an xheight is inconsistent.
segment_penalty_dict_frequent_word1Score multiplier for word matches which have good case and are frequent in the given language (lower is better).
segment_penalty_dict_case_ok1.1Score multiplier for word matches that have good case (lower is better).
segment_penalty_dict_case_bad1.3125Default score multiplier for word matches, which may have case issues (lower is better).
segment_penalty_dict_nonword1.25Score multiplier for glyph fragment segmentations which do not match a dictionary word (lower is better).
certainty_scale20Certainty scaling factor
stopper_nondict_certainty_base-2.5Certainty threshold for non-dict words
stopper_phase2_certainty_rejection_offset1Reject certainty offset
stopper_certainty_per_char-0.5Certainty to add for each dict char above small word size.
stopper_allowable_character_badness3Max certaintly variation allowed in a word (in sigma)
doc_dict_pending_threshold0Worst certainty for using pending dictionary
doc_dict_certainty_threshold-2.25Worst certainty for words that can be inserted into the document dictionary
tessedit_certainty_threshold-2.25Good blob limit
chop_split_dist_knob0.5Split length adjustment
chop_overlap_knob0.9Split overlap adjustment
chop_center_knob0.15Split center adjustment
chop_sharpness_knob0.06Split sharpness adjustment
chop_width_change_knob5Width change adjustment
chop_ok_split100OK split limit
chop_good_split50Good split limit
segsearch_max_char_wh_ratio2最大字元寬高比

為了獲得最佳效果,建議在應用OCR之前使用IronOCR的圖像預處理濾鏡。 這些濾鏡可以顯著提高準確性,特別是在處理低質量掃描或像表格這樣的複雜文件時。

常見問題

如何在 C# 中配置 IronTesseract 進行 OCR?

要配置 IronTesseract,請建立 IronTesseract 實例,並設置如 Language 和 Configuration 等屬性。您可以指定 OCR 語言(從 125 個支援語言中),啟用條碼閱讀,配置可搜尋 PDF 輸出,及設置字元白名單。例如:var tesseract = new IronOcr.IronTesseract { Language = IronOcr.OcrLanguage.English, Configuration = new IronOcr.TesseractConfiguration { ReadBarCodes = false, RenderSearchablePdf = true } };

IronTesseract 支援哪些輸入格式?

IronTesseract 接受透過 OcrInput 類的各種輸入格式。您可以處理影像(PNG、JPG等)、PDF 檔案及掃描文件。OcrInput 類提供靈活的方法來載入這些不同格式,讓您可以輕鬆地對幾乎任何包含文字的文件進行 OCR。

我可以使用 IronTesseract 同時讀取條碼和文字嗎?

可以,IronTesseract 包括進階的條碼閱讀功能。您可以在 TesseractConfiguration 中設定 ReadBarCodes = true 來啟用條碼檢測。這允許您在單次 OCR 操作中從同一文件提取文字及條碼資料。

如何從掃描文件建立可搜索的 PDF?

IronTesseract 可以通過在 TesseractConfiguration 中設定 RenderSearchablePdf = true 將掃描文件和圖像轉換成可搜尋的 PDF。這樣做會建立文字可選取和搜尋的 PDF 檔案,同時保留原始文件的外觀。

IronTesseract 支援哪幾種語言的 OCR?

IronTesseract 支援 125 種國際語言的文字識別。您可以設置 IronTesseract 實例的 Language 屬性來指定語言,如 IronOcr.OcrLanguage.English、西班牙語、中文、阿拉伯語等。

我可以限制 OCR 識別哪些字元嗎?

可以,IronTesseract 允許透過 TesseractConfiguration 中的 WhiteListCharacters 屬性進行字元白名單和黑名單設定。當您知道預期的字元集時,此功能有助於提高準確性,例如僅限於識別字母及數字字元。

如何同時對多個文件進行 OCR?

IronTesseract 支援多執行緒功能以進行批量處理。您可以利用平行處理同時對多個文件進行 OCR,從而大幅提升處理大量圖像或 PDF 檔案的效能。

IronOCR 使用哪一個版本的 Tesseract?

IronOCR 使用一個自定義且經過優化的 Tesseract 5 版本,稱為 Iron Tesseract。這個增強引擎在提高準確度及性能的同時,仍保持與 .NET 應用程式的相容性。

IronOCR如何提高資料精確性?

IronOCR通過其先進的識別算法和影像校正功能提高資料精確性,確保文字提取過程既可靠又精確。

IronOCR有免費試用版嗎?

有的,Iron Software提供IronOCR的免費試用版,允許使用者在做出購買決定前測試其功能和能力。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發,Curtis對物聯網(IoT)有濃厚的興趣,探索創新的方法來整合硬體和軟體。在空閒時間,他喜歡玩遊戲和建立Discord機器人,結合他對技術的熱愛與創造力。

由...審核
Jeff Fritz
Jeffrey T. Fritz
首席計劃經理 - .NET社區團隊
Jeff還是.NET和Visual Studio團隊的首席計劃經理。他是.NET Conf虛擬會議系列的執行製作人,並主持每週兩次的開發者直播節目'Fritz and Friends',在節目中討論技術並與觀眾一起撰寫程式碼。Jeff撰寫工作坊、演講和內容計劃,為微軟開發者的最大活動如Microsoft Build、Microsoft Ignite、.NET Conf和Microsoft MVP Summit提供內容支援。
準備開始了嗎?
Nuget 下載 6,175,195 | 版本: 2026.7 剛剛發布
Still Scrolling Icon

還在滾動?

想要快速證明? PM > Install-Package IronOcr
執行範例 觀看您的圖像轉變為可搜尋文字。