File: ccTranslationManager.h

package info (click to toggle)
cloudcompare 2.13.2%2Bgit20240821%2Bds-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 151,196 kB
  • sloc: cpp: 687,219; ansic: 165,269; python: 31,109; xml: 25,906; sh: 940; makefile: 516; java: 229; asm: 204; fortran: 160; javascript: 73; perl: 18
file content (78 lines) | stat: -rw-r--r-- 3,079 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
#pragma once
//##########################################################################
//#                                                                        #
//#                              CLOUDCOMPARE                              #
//#                                                                        #
//#  This program is free software; you can redistribute it and/or modify  #
//#  it under the terms of the GNU General Public License as published by  #
//#  the Free Software Foundation; version 2 or later of the License.      #
//#                                                                        #
//#  This program is distributed in the hope that it will be useful,       #
//#  but WITHOUT ANY WARRANTY; without even the implied warranty of        #
//#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the          #
//#  GNU General Public License for more details.                          #
//#                                                                        #
//#          COPYRIGHT: CloudCompare project                               #
//#                                                                        #
//##########################################################################

#include "CCAppCommon.h"

//Qt
#include <QMenu>
#include <QPair>
#include <QVector>

//! Translation manager
class CCAPPCOMMON_LIB_API ccTranslationManager : public QObject
{
	Q_OBJECT

public:
	static ccTranslationManager& Get();

	~ccTranslationManager() override = default;

	//! Register a file prefix for translation files.
	/** The files should be named <prefix>_<lang>.ts where <lang> is the 2-letter ISO 639
		language code in lowercase.
		 e.g. CloudCompare_fr.ts
		\param prefix	The prefix of the file to register
		\param path		The path to look for the files in
	**/
	void registerTranslatorFile(const QString& prefix, const QString& path);

	//! Using the translation file prefixes that were registered, load the actual translations
	inline void loadTranslations() { loadTranslation(languagePref()); }

	//! Using the translation file prefixes that were registered, load the actual
	//! translation by the 2-letter ISO 639 language code in lowercase.
	void loadTranslation(QString language);

	//! Populate the menu with a list of languages found using files in 'pathToTranslationFiles'
	void populateMenu(QMenu *menu, const QString &pathToTranslationFiles);

protected:
	explicit ccTranslationManager() = default;

private: // methods
	struct CCAPPCOMMON_LIB_API TranslatorFile
	{
		QString	prefix;
		QString path;
	};
	using TranslatorFileList = QVector<TranslatorFile>;

	using TranslationInfo = QPair<QString, QString>;
	using LanguageList = QVector<TranslationInfo>;

	QString languagePref() const;

	//! Generate a list of available languages based on the files in the "translation" directory.
	LanguageList availableLanguages(const QString& appName, const QString& pathToTranslationFiles) const;

	void setLanguagePref(const QString& languageCode);

private: // members
	TranslatorFileList	mTranslatorFileInfo;
};