Changes between Version 73 and Version 74 of Docs/825gen2/Dev/UpdatingLegacyAppsToNewLook

Timestamp:

07/09/25 13:33:10 (2 weeks ago)

Author:

Don Wilson

Comment:

--

Docs/825gen2/Dev/UpdatingLegacyAppsToNewLook

@@ -239 +239 @@
 #if ARM64
         InitLCD(DSP_INIT_NEW_STYLE_APP);
-
-        dspMain.SetZoomWidth(0, dspMain.GetZoomWidth(1));
-        if(dsp_height > 800) {
-                dspMain.SetZoomHeight(0, (int)(dspMain.GetZoomHeight(1) * 0.84));
-        }
-
+        AppDisplayZoomInit();
         InitFonts();
-
         weightScreen.SetupDisplayLocations();
-
+        EnableFullScreenMode();
 #else
         InitLCD();
@@ -255 +249 @@
 }
 }}}
+The EnableFullScreenMode() is optional but recommended for most new apps. However, this will require a little more work to make the app fully functional.
 
 10. Modify all the references to the Show//XXXX// show as ShowGTN() to add the weightScreen instance such as:
@@ -265 +260 @@
 12. Search for all menu and inputs forms such as search for "FORM_INIT" make appropriate changes to use new style FORM_ADD_INPUT2 instead of FORM_ADD_INPUT and FORM_ADD_BUTTON2 instead of FORM_ADD_BUTTON such as:
 
+Following is an example input form if EnableFullScreenMode is not used.
 {{{#!c++
 void PresetScreen(void)
@@ -297 +293 @@
 In the above example notice after FORM_INIT the function !SetupInputFormToUseFontSet is called. !SetupInputFormToUseFontSet is a helper function defined in apphelpers.cpp. This gives the form a pointer to the fonts that were initialized previously. The function also sets the starting positions of the rect, and rectInp rectangles that are used to define where to show the prompts and input fields. The final parameter is a string used to determine the width of the prompts. This should be the longest prompt text in the form. The !AdvanceInputRects function call is used between FORM_ADD_INPUT2 calls to move the rect and rectInp down an appropriate amount for the next input.
 
+Following is an example input form when EnableFullScreenMode is used.
+
+{{{#!c++
+void PresetScreen(void)
+{
+#if ARM64
+        CFormRect rectInpBtn;
+        CFormButton btnOk;
+
+        FORM_INIT(Setup, EventPresetScreenShow, NULL, NULL, NULL, nFormFlgShowHelp | nFormFlgAutoPresentPopup | nFormFlgShowPopupTabKeypad);
+
+        SetupInputFormToUseFontSet(formSetup, rectInpBtn, 0.45, 1.3);
+
+        FORM_ADD_INPUT2(Setup, Thresh,  rectInpBtn, rectKeypad, "On Threshold: ", 6, 0, 999999, NULL, &g_setup.onThresh, FORM_FLOAT, NULL, "Enter the on threshold");
+        rectInpBtn += inputAdvanceY;
+        FORM_ADD_INPUT2(Setup, ViolTot, rectInpBtn, rectKeypad, "Total Violation: ", 6, 0, 999999, NULL, &g_setup.violWt[0], FORM_FLOAT, NULL, "Enter violation weight for total");
+        rectInpBtn += inputAdvanceY;
+        FORM_ADD_INPUT2(Setup, Viol1,   rectInpBtn, rectKeypad, "P1 Violation: ", 6, 0, 999999, NULL, &g_setup.violWt[1], FORM_FLOAT, NULL, "Violation weight for P1");
+
+        formSetup.LeftAlignPromptInputs(inpThres, inpViol1);
+
+        AddFormOkButton(formSetup, btnOk);
+#else
+        FORM_INIT(Setup, EventPresetScreenShow, NULL, NULL, NULL, nFormFlgShowHelp);
+        FORM_ADD_INPUT(Setup, Thresh, 0, FONT_HEIGHT * 2, "On Threshold: ", 6, 0, 999999, NULL, &g_setup.onThresh, FORM_FLOAT, NULL, "Enter the on threshold");
+        FORM_ADD_INPUT(Setup, ViolTot, 0, FONT_HEIGHT * 4, "Total violation: ", 6, 0, 999999, NULL, &g_setup.violWt[0], FORM_FLOAT, NULL, "Enter violation weight for total");
+        FORM_ADD_INPUT(Setup, Viol1, 0, FONT_HEIGHT * 6, "P1 Violation: ", 6, 0, 999999, NULL, &g_setup.violWt[1], FORM_FLOAT, NULL, "Violation weight for P1");
+#endif
+        FORM_SHOW(Setup);
+        int n = FORM_RUN(Setup);
+        if (n != FORM_RESULT_ESC) {
+                SaveSetup();
+        }
+        FORM_HIDE(Setup);
+}
+}}}
+
+In the above example FORM_INIT has additional flags //nFormFlgAutoPresentPopup | nFormFlgShowPopupTabKeypad//. This is to show the popup keypad automatically and include the tab keypad. The function !SetupInputFormToUseFontSet is called. !SetupInputFormToUseFontSet is a helper function defined in apphelpers.cpp. This gives the form a pointer to the fonts that were initialized previously. The function also sets the starting positions of the rect, and rectInp rectangles that are used to define where to show the prompts and input fields. The final parameter is a string used to determine the width of the prompts. This should be the longest prompt text in the form. The !AdvanceInputRects function call is used between FORM_ADD_INPUT2 calls to move the rect and rectInp down an appropriate amount for the next input.
+
+
 {{{#!c++
 EVENT(FileOperationShow)