![]() |
digiKam
|
Provides translation data. More...
#include <donlinetranslator.h>
Classes | |
class | Private |
Signals | |
void | signalFinished () |
Translation finished. | |
Public Member Functions | |
void | abort () |
Cancel translation operation (if any). | |
void | detectLanguage (const QString &text, Engine engine=Google) |
Detect language. | |
DOnlineTranslator (QObject *const parent=nullptr) | |
Create object. | |
TranslationError | error () const |
Last error. | |
QString | errorString () const |
Last error string. | |
bool | isRunning () const |
Check translation progress. | |
bool | isSourceTranscriptionEnabled () const |
Check if source transcription is enabled. | |
bool | isSourceTranslitEnabled () const |
Check if source transliteration is enabled. | |
bool | isTranslationOptionsEnabled () const |
Check if translation options are enabled. | |
bool | isTranslationTranslitEnabled () const |
Check if translation transliteration is enabled. | |
void | setEngineApiKey (Engine engine, const QByteArray &apiKey) |
Set api key for engine. | |
void | setEngineUrl (Engine engine, const QString &url) |
Set the URL engine. | |
void | setSourceTranscriptionEnabled (bool enable) |
Enable or disable source transcription. | |
void | setSourceTranslitEnabled (bool enable) |
Enable or disable source transliteration. | |
void | setTranslationOptionsEnabled (bool enable) |
Enable or disable translation options. | |
void | setTranslationTranslitEnabled (bool enable) |
Enable or disable translation transliteration. | |
QString | source () const |
Source text. | |
Language | sourceLanguage () const |
Source language. | |
QString | sourceLanguageName () const |
Source language name. | |
QString | sourceTranscription () const |
Source transcription. | |
QString | sourceTranslit () const |
Source transliteration. | |
QJsonDocument | toJson () const |
Converts the object to JSON. | |
void | translate (const QString &text, Engine engine=Google, Language translationLang=Auto, Language sourceLang=Auto, Language uiLang=Auto) |
Translate text. | |
QString | translation () const |
Translated text. | |
Language | translationLanguage () const |
Translation language. | |
QString | translationLanguageName () const |
Translation language name. | |
QMap< QString, QVector< DOnlineTranslatorOption > > | translationOptions () const |
Translation options. | |
QString | translationTranslit () const |
Translation transliteration. | |
~DOnlineTranslator () override | |
Static Public Member Functions | |
static QString | engineName (Engine engine) |
static QString | fromRFC3066 (Engine engine, const QString &langCodeRFC3066) |
static bool | isSupportTranslation (Engine engine, Language lang) |
Check if transliteration is supported. | |
static Language | language (const QLocale &locale) |
Language. | |
static Language | language (const QString &langCode) |
Returns general language code. | |
static QString | languageCode (Language lang) |
Language code. | |
static QString | languageName (Language lang) |
Language name. | |
static QStringList | supportedRFC3066 (Engine engine) |
Friends | |
class | DOnlineTts |
Provides translation data.
Represents all languages for translation.
Indicates all possible error conditions found during the processing of the translation.
|
explicit |
Create object.
Constructs an object with empty data and with parent. You can use translate() to send text to object.
parent | the parent object |
References signalFinished(), and Digikam::DOnlineTranslator::Private::stateMachine.
|
override |
void Digikam::DOnlineTranslator::abort | ( | ) |
Cancel translation operation (if any).
References Digikam::DOnlineTranslator::Private::currentReply.
Referenced by detectLanguage(), and translate().
Detect language.
text | the text for language detection |
engine | the engine to use |
References abort(), Auto, Bing, English, Google, language(), LibreTranslate, Digikam::DOnlineTranslator::Private::libreUrl, Lingva, Digikam::DOnlineTranslator::Private::lingvaUrl, Digikam::DOnlineTranslator::Private::onlyDetectLanguage, ParametersError, signalFinished(), Digikam::DOnlineTranslator::Private::source, Digikam::DOnlineTranslator::Private::sourceLang, Digikam::DOnlineTranslator::Private::stateMachine, Digikam::DOnlineTranslator::Private::translationLang, Digikam::DOnlineTranslator::Private::uiLang, and Yandex.
|
static |
Return the engine literal name.
References Bing, LibreTranslate, Lingva, and Yandex.
DOnlineTranslator::TranslationError Digikam::DOnlineTranslator::error | ( | ) | const |
Last error.
Error that was found during the processing of the last translation. If no error was found, returns DOnlineTranslator::NoError. The text of the error can be obtained by errorString().
References Digikam::DOnlineTranslator::Private::error.
QString Digikam::DOnlineTranslator::errorString | ( | ) | const |
Last error string.
A human-readable description of the last translation error that occurred.
References Digikam::DOnlineTranslator::Private::errorString.
|
static |
Convert language RFC3066 to supported language code
References Bing, Google, LibreTranslate, Lingva, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesBing, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesGeneric, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesGoogle, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesLingva, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesYandex, and Yandex.
Referenced by Digikam::s_inlineTranslateString().
bool Digikam::DOnlineTranslator::isRunning | ( | ) | const |
Check translation progress.
true
when the translation is still processing and has not finished or was aborted yet. References Digikam::DOnlineTranslator::Private::stateMachine.
bool Digikam::DOnlineTranslator::isSourceTranscriptionEnabled | ( | ) | const |
Check if source transcription is enabled.
true
if source transcription is enabled References Digikam::DOnlineTranslator::Private::sourceTranscriptionEnabled.
bool Digikam::DOnlineTranslator::isSourceTranslitEnabled | ( | ) | const |
Check if source transliteration is enabled.
true
if source transliteration is enabled References Digikam::DOnlineTranslator::Private::sourceTranslitEnabled.
Check if transliteration is supported.
engine | the engine to use |
lang | language |
true
if the specified engine supports transliteration for specified language References Afrikaans, Albanian, Amharic, Armenian, Azerbaijani, Bashkir, Basque, Belarusian, Bengali, Bing, Bosnian, Bulgarian, Cantonese, Catalan, Cebuano, Chichewa, Corsican, Croatian, Czech, Danish, Dutch, Esperanto, Estonian, Fijian, Filipino, Finnish, Frisian, Galician, Georgian, Google, Greek, Gujarati, HaitianCreole, Hausa, Hawaiian, Hebrew, HillMari, Hmong, Hungarian, Icelandic, Igbo, Irish, Javanese, Kannada, Kazakh, Khmer, Kinyarwanda, Klingon, KlingonPlqaD, Kurdish, Kyrgyz, Lao, Latin, Latvian, LevantineArabic, LibreTranslate, Lingva, Lithuanian, Luxembourgish, Macedonian, Malagasy, Malay, Malayalam, Maltese, Maori, Marathi, Mari, Mongolian, Myanmar, Nepali, NoLanguage, Norwegian, Oriya, Papiamento, Pashto, Persian, Punjabi, QueretaroOtomi, Romanian, Samoan, ScotsGaelic, SerbianCyrillic, SerbianLatin, Sesotho, Shona, SimplifiedChinese, Sindhi, Sinhala, Slovak, Slovenian, Somali, Sundanese, Swahili, Swedish, Tagalog, Tahitian, Tajik, Tamil, Tatar, Telugu, Thai, Tongan, Turkmen, Udmurt, Uighur, Ukrainian, Urdu, Uzbek, Welsh, Xhosa, Yandex, Yiddish, Yoruba, YucatecMaya, and Zulu.
Referenced by translate().
bool Digikam::DOnlineTranslator::isTranslationOptionsEnabled | ( | ) | const |
Check if translation options are enabled.
true
if translation options are enabled References Digikam::DOnlineTranslator::Private::translationOptionsEnabled.
bool Digikam::DOnlineTranslator::isTranslationTranslitEnabled | ( | ) | const |
Check if translation transliteration is enabled.
true
if translation transliteration is enabled References Digikam::DOnlineTranslator::Private::translationTranslitEnabled.
|
static |
Language.
locale | the locale to use |
References Afrikaans, Albanian, Amharic, Arabic, Armenian, Azerbaijani, Basque, Belarusian, Bengali, Bosnian, Bulgarian, Catalan, Corsican, Croatian, Czech, Danish, Dutch, English, Esperanto, Estonian, Filipino, Finnish, French, Frisian, Galician, Georgian, German, Greek, Gujarati, HaitianCreole, Hausa, Hawaiian, Hebrew, Hindi, Hungarian, Icelandic, Igbo, Indonesian, Irish, Italian, Japanese, Javanese, Kannada, Kazakh, Khmer, Kinyarwanda, Korean, Kurdish, Lao, Latin, Latvian, Lithuanian, Luxembourgish, Macedonian, Malagasy, Malay, Malayalam, Maltese, Maori, Marathi, Mongolian, Nepali, Norwegian, Oriya, Pashto, Persian, Polish, Portuguese, Punjabi, Romanian, Russian, Samoan, ScotsGaelic, SerbianCyrillic, Shona, SimplifiedChinese, Sindhi, Sinhala, Slovak, Slovenian, Somali, Spanish, Sundanese, Swahili, Swedish, Tajik, Tamil, Tatar, Telugu, Thai, TraditionalChinese, Turkish, Turkmen, Uighur, Ukrainian, Urdu, Uzbek, Vietnamese, Welsh, Xhosa, Yiddish, Yoruba, and Zulu.
|
static |
Returns general language code.
langCode | code |
References NoLanguage, and Digikam::DOnlineTranslator::Private::s_genericLanguageCodes.
Referenced by detectLanguage(), Digikam::s_inlineTranslateString(), and translate().
|
static |
Language code.
lang | language |
References Digikam::DOnlineTranslator::Private::s_genericLanguageCodes.
|
static |
Language name.
lang | language |
References Afrikaans, Albanian, Amharic, Arabic, Armenian, Auto, Azerbaijani, Bashkir, Basque, Belarusian, Bengali, Bosnian, Bulgarian, Cantonese, Catalan, Cebuano, Chichewa, Corsican, Croatian, Czech, Danish, Dutch, English, Esperanto, Estonian, Fijian, Filipino, Finnish, French, Frisian, Galician, Georgian, German, Greek, Gujarati, HaitianCreole, Hausa, Hawaiian, Hebrew, HillMari, Hindi, Hmong, Hungarian, Icelandic, Igbo, Indonesian, Irish, Italian, Japanese, Javanese, Kannada, Kazakh, Khmer, Kinyarwanda, Klingon, KlingonPlqaD, Korean, Kurdish, Kyrgyz, Lao, Latin, Latvian, LevantineArabic, Lithuanian, Luxembourgish, Macedonian, Malagasy, Malay, Malayalam, Maltese, Maori, Marathi, Mari, Mongolian, Myanmar, Nepali, Norwegian, Oriya, Papiamento, Pashto, Persian, Polish, Portuguese, Punjabi, QueretaroOtomi, Romanian, Russian, Samoan, ScotsGaelic, SerbianCyrillic, SerbianLatin, Sesotho, Shona, SimplifiedChinese, Sindhi, Sinhala, Slovak, Slovenian, Somali, Spanish, Sundanese, Swahili, Swedish, Tagalog, Tahitian, Tajik, Tamil, Tatar, Telugu, Thai, Tongan, TraditionalChinese, Turkish, Turkmen, Udmurt, Uighur, Ukrainian, Urdu, Uzbek, Vietnamese, Welsh, Xhosa, Yiddish, Yoruba, YucatecMaya, and Zulu.
Referenced by sourceLanguageName(), translate(), and translationLanguageName().
void Digikam::DOnlineTranslator::setEngineApiKey | ( | Engine | engine, |
const QByteArray & | apiKey | ||
) |
Set api key for engine.
Affects only LibreTranslate.
engine | the engine to use |
apiKey | your key for this particular instance |
References Digikam::DOnlineTranslator::Private::libreApiKey, and LibreTranslate.
void Digikam::DOnlineTranslator::setEngineUrl | ( | Engine | engine, |
const QString & | url | ||
) |
Set the URL engine.
Only affects LibreTranslate and Lingva because these engines have multiple instances. You need to call this function to specify the URL of an instance for them.
engine | the engine to use |
url | engine url |
References LibreTranslate, Digikam::DOnlineTranslator::Private::libreUrl, Lingva, and Digikam::DOnlineTranslator::Private::lingvaUrl.
void Digikam::DOnlineTranslator::setSourceTranscriptionEnabled | ( | bool | enable | ) |
Enable or disable source transcription.
enable | whether to enable source transcription |
References Digikam::DOnlineTranslator::Private::sourceTranscriptionEnabled.
void Digikam::DOnlineTranslator::setSourceTranslitEnabled | ( | bool | enable | ) |
Enable or disable source transliteration.
enable | whether to enable source transliteration |
References Digikam::DOnlineTranslator::Private::sourceTranslitEnabled.
void Digikam::DOnlineTranslator::setTranslationOptionsEnabled | ( | bool | enable | ) |
Enable or disable translation options.
enable | whether to enable translation options |
References Digikam::DOnlineTranslator::Private::translationOptionsEnabled.
void Digikam::DOnlineTranslator::setTranslationTranslitEnabled | ( | bool | enable | ) |
Enable or disable translation transliteration.
enable | whether to enable translation transliteration |
References Digikam::DOnlineTranslator::Private::translationTranslitEnabled.
|
signal |
Translation finished.
This signal is emitted when the translation is complete.
Referenced by Digikam::AltLangStrEdit::AltLangStrEdit(), detectLanguage(), DOnlineTranslator(), Digikam::s_inlineTranslateString(), and translate().
QString Digikam::DOnlineTranslator::source | ( | ) | const |
DOnlineTranslator::Language Digikam::DOnlineTranslator::sourceLanguage | ( | ) | const |
Source language.
References Digikam::DOnlineTranslator::Private::sourceLang.
QString Digikam::DOnlineTranslator::sourceLanguageName | ( | ) | const |
Source language name.
References languageName(), and Digikam::DOnlineTranslator::Private::sourceLang.
QString Digikam::DOnlineTranslator::sourceTranscription | ( | ) | const |
Source transcription.
References Digikam::DOnlineTranslator::Private::sourceTranscription.
QString Digikam::DOnlineTranslator::sourceTranslit | ( | ) | const |
Source transliteration.
References Digikam::DOnlineTranslator::Private::sourceTranslit.
|
static |
Return a list of all supported language in RFC3066.
References Bing, Google, LibreTranslate, Lingva, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesBing, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesGeneric, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesGoogle, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesLingva, Digikam::DOnlineTranslator::Private::s_rfc3066LanguageCodesYandex, and Yandex.
Referenced by Digikam::LocalizeSelector::populateTranslationEntries().
QJsonDocument Digikam::DOnlineTranslator::toJson | ( | ) | const |
Converts the object to JSON.
References Digikam::DOnlineTranslator::Private::source, Digikam::DOnlineTranslator::Private::sourceTranscription, Digikam::DOnlineTranslator::Private::sourceTranslit, Digikam::DOnlineTranslator::Private::translation, translationOptions(), Digikam::DOnlineTranslator::Private::translationOptions, and Digikam::DOnlineTranslator::Private::translationTranslit.
void Digikam::DOnlineTranslator::translate | ( | const QString & | text, |
Engine | engine = Google , |
||
Language | translationLang = Auto , |
||
Language | sourceLang = Auto , |
||
Language | uiLang = Auto |
||
) |
Translate text.
text | the text to translate |
engine | online engine to use |
translationLang | language to translation |
sourceLang | language of the passed text |
uiLang | ui language to use for display |
References abort(), Auto, Bing, Google, isSupportTranslation(), language(), languageName(), LibreTranslate, Digikam::DOnlineTranslator::Private::libreUrl, Lingva, Digikam::DOnlineTranslator::Private::lingvaUrl, Digikam::DOnlineTranslator::Private::onlyDetectLanguage, ParametersError, signalFinished(), Digikam::DOnlineTranslator::Private::source, Digikam::DOnlineTranslator::Private::sourceLang, Digikam::DOnlineTranslator::Private::stateMachine, Digikam::DOnlineTranslator::Private::translationLang, Digikam::DOnlineTranslator::Private::uiLang, and Yandex.
QString Digikam::DOnlineTranslator::translation | ( | ) | const |
Translated text.
References Digikam::DOnlineTranslator::Private::translation.
DOnlineTranslator::Language Digikam::DOnlineTranslator::translationLanguage | ( | ) | const |
Translation language.
References Digikam::DOnlineTranslator::Private::translationLang.
QString Digikam::DOnlineTranslator::translationLanguageName | ( | ) | const |
Translation language name.
References languageName(), and Digikam::DOnlineTranslator::Private::translationLang.
QMap< QString, QVector< DOnlineTranslatorOption > > Digikam::DOnlineTranslator::translationOptions | ( | ) | const |
Translation options.
References Digikam::DOnlineTranslator::Private::translationOptions.
Referenced by toJson().
QString Digikam::DOnlineTranslator::translationTranslit | ( | ) | const |
Translation transliteration.
References Digikam::DOnlineTranslator::Private::translationTranslit.
|
friend |