Recognition languages

To recognize text in certain languages, you must install additional recognition models:

• Cyrillic text recognition: aspose-ocr-cyrillic-v1
• Chinese text recognition: aspose-ocr-chinese-v2
• Indic (Devanagari) text recognition: aspose-ocr-hindi-v2
• Arabic text recognition: aspose-ocr-arabic-v1
• Persian (Farsi) text recognition: aspose-ocr-arabic-v1
• Uyghur text recognition: aspose-ocr-arabic-v1
• Urdu text recognition: aspose-ocr-arabic-v1
• Japanese text recognition: aspose-ocr-japanese-v1
• Korean text recognition: aspose-ocr-korean-v1
• Kannada text recognition: aspose-ocr-kannada-v1
• Tamil text recognition: aspose-ocr-tamil-v1
• Telugu text recognition: aspose-ocr-telugu-v1
• Mixed-language Cyrillic/English recognition: aaspose-ocr-cyrillic-v2
• Mongolian text recognition: aspose-ocr-cyrillic-v1

Aspose.OCR for Java can recognize a text in a large number of languages and all popular writing scripts, including texts with mixed languages.

To specify a language for recognition, provide one of the following values in setLanguage method of RecognitionSettings class:

Mixed-language Cyrillic/English text recognition is experimental. If you are absolutely sure about the text language (for example, Ukrainian), it is recommended to specify the language directly.

Value	Alphabet
Language.ExtLatin	Auto-detect all supported Latin characters and diacritics
Language.Cyrillic	All supported Cyrillic characters (auto-detect)
Language.Chinese	All Chinese languages. Mixed-language Chinese/English texts also supported.
Language.Devanagari Language.Indic	Indic texts based on Devanagari script, including mixed Devanagari/English texts.
Language.European	Mixed-language Cyrillic/English texts (experimental).
Language.Afr	Afrikaans
Language.Aln	Albanian
Language.Ara	Arabic (mixed texts in Arabic and English are also supported)
Language.Awa	Awadhi
Language.Azb	Azerbaijani (Azeri)
Language.Bcl	Bikol
Language.Bel	Belarusan (Belorussian)
Language.Bem	Bemba (Chibemba)
Language.Bew	Betawi
Language.Bgc	Haryanvi
Language.Bho	Bhojpuri
Language.Bhr	Malagasy
Language.Bjj	Kanauji
Language.Bos	Bosnian
Language.Bul	Bulgarian
Language.Cat	Catalan
Language.Ccx	Zhuang
Language.Cdo	Min Dong
Language.Ceb	Cebuano
Language.Ces	Czech
Language.Che	Chechen
Language.Cmn	Mandarin (Chinese)
Language.Cpx	Pu-Xian
Language.Dan	Danish
Language.Deu	German
Language.Dhd	Dhundari
Language.Diq	Dimli
Language.Doc	Dong
Language.Eng	English
Language.Est	Estonian
Language.Fin	Finnish
Language.Fra	French
Language.Gan	Gan
Language.Gax	Oromo
Language.Gbm	Garhwali
Language.Glg	Galician
Language.Glk	Gilaki
Language.Guz	Gusii
Language.Hak	Hakka
Language.Hau	Hausa
Language.Hbs	Serbo-Croatian (Latin)
Language.Hil	Hiligaynon
Language.Hin	Hindi
Language.Hmn	Hmong
Language.Hne	Chattisgarhi (Laria, Khaltahi)
Language.Hrv	Croatian
Language.Hsn	Xiang
Language.Hun	Hungarian (Magyar)
Language.Ilo	Ilocano
Language.Ind	Indonesian
Language.Ita	Italian
Language.Jpn	Japanese (mixed texts in Japanese and English are also supported)
Language.Kan	Mixed-language Kannada/English texts.
Language.Kaz	Kazakh
Language.Kbd	Kabardian
Language.Kfy	Kumauni
Language.Kin	Rwanda
Language.Kln	Nandi
Language.Kmr	Kurdish (Kurmanji)
Language.Knc	Kanuri
Language.Knn	Konkani
Language.Kon	Kikongo
Language.Kor	Korean (mixed texts in Korean and English are also supported)
Language.Latin	Latin
Language.Lav	Latvian
Language.Lit	Lithuanian
Language.Lmn	Lamani (Lambadi)
Language.Lnc	Occitan
Language.Luo	Luo
Language.Mag	Magahi
Language.Mai	Maithili
Language.Mak	Makassar (Makasar)
Language.Mar	Marathi
Language.Mer	Meru
Language.Min	Minangkabau
Language.Mly	Malay (Melayu)
Language.Mnp	Min Bei
Language.Mon	Mongolian
Language.Mtq	Muong
Language.Mtr	Mewari
Language.Mui	Musi
Language.Mup	Malvi
Language.Nan	Min Nan
Language.Nbl	Ndebele
Language.Nds	Low German
Language.Nep	Nepali
Language.Nld	Dutch
Language.Nor	Norwegian
Language.Nso	Sotho (Northern)
Language.Nya	Chichewa (Chewa, Nyanja)
Language.Pag	Pangasinan
Language.Pam	Kapampangan
Language.Pcc	Bouyei (Buyi, Giáy)
Language.Pes	Persian (Farsi); mixed texts in Persian and English are also supported
Language.Plm	Palembang
Language.Pol	Polish
Language.Por	Portuguese
Language.Quc	K’iche'
Language.Qxa	Quechua
Language.Rjb	Rajbanshi
Language.Ron	Romanian
Language.Ruf	Luguru
Language.Rus	Russian
Language.Rwr	Marwari
Language.Sas	Sasak
Language.Slk	Slovak
Language.Slv	Slovene (Slovenian)
Language.Sna	Shona (Karanga)
Language.Som	Somali
Language.Sot	Sotho (Southern)
Language.Spa	Spanish
Language.Srp	Serbian (Cyrillic)
Language.Srr	Serer-Sine
Language.Ssw	Swati (Swazi)
Language.Suk	Sukuma
Language.Sun	Sundanese (Sunda)
Language.Swe	Swedish
Language.Swh	Swahili
Language.Tam	Mixed-language Tamil/English texts.
Language.Tel	Mixed-language Telugu/English texts.
Language.Tgl	Tagalog (Pilipino)
Language.Toi	Tonga
Language.Tsn	Tswana
Language.Tso	Tsonga
Language.Tuk	Turkmen
Language.Tum	Tumbuka
Language.Tur	Turkish
Language.Uig	Uyghur; mixed texts in Uyghur and English are also supported
Language.Ukr	Ukrainian
Language.Umb	Umbundu
Language.Urd	Urdu; mixed texts in Urdu and English are also supported
Language.Vie	Vietnamese
Language.Vmw	Makua (Makhuwa)
Language.Wal	Wolaytta
Language.War	Waray-Waray
Language.Wbr	Wagdi
Language.Wtm	Mewati
Language.Wuu	Wu (Changzhou)
Language.Xho	Xhosa
Language.Yao	Yao
Language.Yor	Yoruba
Language.Yue	Cantonese
Language.Zul	Zulu

If this parameter is omitted, the OCR engine will assume that the text is written in extended Latin.

Make sure you specify the correct language for the image. If you try to recognize Cyrillic text using Language.Eng, only the characters that look the same in both languages (for example, с and c) will be correctly recognized. Other characters will be replaced with similar-looking alternatives.

Example

The following code sample demonstrates how to specify the recognition language:

AsposeOCR api = new AsposeOCR();
RecognitionSettings recognitionSettings = new RecognitionSettings();
// Recognize Ukrainian text
recognitionSettings.setLanguage(Language.Ukr);
RecognitionResult result = api.RecognizePage("source.png", recognitionSettings);
System.out.println("Recognition result:\n" + result.recognitionText + "\n\n");