GTRANS - Revision history

Tectu: /* API reference */

2021-08-23T17:25:52Z

‎API reference

Tectu: /* Basic Example */

2021-08-23T13:57:14Z

‎Basic Example

Tectu at 15:46, 3 August 2021

2021-08-03T15:46:20Z

Tectu: /* Example with widgets */

2016-08-17T12:37:59Z

‎Example with widgets

Tectu: /* Example with widgets */

2016-08-17T12:36:37Z

‎Example with widgets

Inmarket at 02:13, 29 February 2016

2016-02-29T02:13:29Z

Tectu: /* Basic Example */

2016-02-09T11:38:15Z

‎Basic Example

Tectu: /* Basic Example */

2016-02-09T11:38:05Z

‎Basic Example

Tectu: /* Basic Example */

2016-02-09T11:13:12Z

‎Basic Example

Tectu: /* Basic Example */

2016-02-09T11:00:37Z

‎Basic Example

@@ Line 2: / Line 2: @@
 == API reference ==
-The API reference of the GTRANS module can be found [http://api.ugfx.org/group___g_t_r_a_n_s.html here].
+The API reference of the GTRANS module can be found [http://api.ugfx.io/group___g_t_r_a_n_s.html here].
 == Intended usage ==

@@ Line 36: / Line 36: @@
 #define COLOR_TEXT          Black
-font_t font;
+gFont font;
 // English Translation

← Older revision		Revision as of 15:46, 3 August 2021
Line 1:		Line 1:
−	The GTRANS module allows ~~you~~ to manage language translations. The language of an application can be changed dynamically during ~~run-time~~ using the GTRANS module.	+	The GTRANS module allows to manage language translations. The language of an application can be changed dynamically during runtime using the GTRANS module.

	== API reference ==		== API reference ==

@@ Line 116: / Line 116: @@
 === Example with widgets ===
-The GTRANS module can also be used to translate widget texts. GWIN doesn't do anything with the text set by <code>gwinSetText()</code> except displaying it. Therefore, the <code>gtransString()</code> (or <code>gt()</code> respectively) function can be used directly inside of the <code>gwinSetText()</code> call. When the current language changes, these strings must be updated manually. There's currently no way to tell GWIN to automatically use the string for the currently active language as this would add a lot of overhead to both the GWIN core module as well as to each widget rendering function in order to support parameter substitution.
+The GTRANS module can also be used to translate widget texts. GWIN doesn't do anything with the text set by <code>gwinSetText()</code> except displaying it. Therefore, the <code>gtransString()</code> (or <code>gt()</code> respectively) function can be used directly inside of the <code>gwinSetText()</code> call. When the current language changes, the <code>gwinSetText()</code> function must be re-called manually. There's currently no way to tell GWIN to automatically use the string for the currently active language as this would add a lot of overhead to both the GWIN core module as well as to each widget rendering function in order to support parameter substitution.
 Example:

@@ Line 116: / Line 116: @@
 === Example with widgets ===
-The following example demonstrates how the language of an application using widgets can be translated using GTRANS. The user can select the language using [[PushButton|buttons]].
+The GTRANS module can also be used to translate widget texts. GWIN doesn't do anything with the text set by <code>gwinSetText()</code> except displaying it. Therefore, the <code>gtransString()</code> (or <code>gt()</code> respectively) function can be used directly inside of the <code>gwinSetText()</code> call. When the current language changes, these strings must be updated manually. There's currently no way to tell GWIN to automatically use the string for the currently active language as this would add a lot of overhead to both the GWIN core module as well as to each widget rendering function in order to support parameter substitution.
 <source lang="c">
-ToDo
+gwinSetText(ghMyButton, gt("The temperature is %d degrees"));
 </source>

← Older revision		Revision as of 02:13, 29 February 2016
Line 1:		Line 1:
−	The GTRANS module allows to manage language translations. The language of an application can be changed dynamically during run-time using the GTRANS module.	+	The GTRANS module allows you to manage language translations. The language of an application can be changed dynamically during run-time using the GTRANS module.

	== API reference ==		== API reference ==

@@ Line 30: / Line 30: @@
 The following code is a very simple usage example showing how the GTRANS module is used. This is a very minimalistic example with no dependencies other than the [[GDISP]] module to interface a display.
 <source lang="c">
 #include <stdio.h>
 #include "gfx.h"

@@ Line 30: / Line 30: @@
 The following code is a very simple usage example showing how the GTRANS module is used. This is a very minimalistic example with no dependencies other than the [[GDISP]] module to interface a display.
 <source lang="c">
 #include "gfx.h"
 static const char* EnglishStrings[] = {
      "Welcome",
-     "The number %s has the value %d",
+     "The temperature is %d degrees",
-     "Goodbye"
+     "Goodbye",
 };
 static const transTable EnglishTranslation = { sizeof(EnglishStrings)/sizeof(EnglishStrings[0]), EnglishStrings };
 static const char* GermanStrings[] = {
      "Herzlich Willkommen",
-     "Die Zahl %s hat den Wert %d",
+     "Die Temperatur beträgt %d Grad",
-     "Auf Wiedersehen"
+     "Auf Wiedersehen",
 };
 static const transTable GermanTranslation = { sizeof(GermanStrings)/sizeof(GermanStrings[0]), GermanStrings };
-int main(void)
+// French translation
+{
-     size_t i, j;
+     coord_t width = 400;
-     font_t font;
+     coord_t height = 30;
      gfxInit();
-     gdispClear(Silver);
+     gdispClear(COLOR_BACKGROUND);
      font = gdispOpenFont("*");
      gtransSetBaseLanguage(&EnglishTranslation);
-     gtransSetLanguage(&EnglishTranslation);
+     // Loop through the languages
-    i = 0;
+    while (TRUE) {
-    for (j = 0; j < EnglishTranslation.numEntries; j++) {
+        // English
-         gdispFillStringBox(20+300*i, 35*j, 300, 35, gtransIndex(j), font, Black, Silver, justifyLeft);
+        gtransSetLanguage(&EnglishTranslation);
+        updateText();
-    gtransSetLanguage(&GermanTranslation);
+        // German
-    i = 1;
+        gtransSetLanguage(&GermanTranslation);
-    for (j = 0; j < EnglishTranslation.numEntries; j++) {
+        updateText();
-         gdispFillStringBox(20+300*i, 35*j, 300, 35, gtransIndex(j), font, Black, Silver, justifyLeft);
+        gfxSleepMilliseconds(3000);
+     }
-     gdispFillStringBox(20, 300, 300, 25, gt("Welcome"), font, Black, Silver, justifyLeft);
+     return 0;
-−
-	while (TRUE) {
-		gfxSleepMilliseconds(500);
-−
-−
-	return 0;
+}
 </source>