port, reimplementation of ACE hints (#1036)

* port, reimplementation of ACE hints

* delete dead code line

* parenthesis for macros

* notify tweaks

* Notifications - Polish translation (#1038)

addons/ui/CfgFunctions.hpp

@@ -22,6 +22,7 @@ class CfgFunctions {
             PATHTO_FNC(getFov);
             PATHTO_FNC(getAspectRatio);
             PATHTO_FNC(getUISize);
+            PATHTO_FNC(notify);
         };
     };
 };

addons/ui/CfgUIGrids.hpp

@@ -13,6 +13,17 @@ class CfgUIGrids {
                         0.5 * GUI_GRID_CENTER_W,
                         0.5 * GUI_GRID_CENTER_H
                     };
+
+                    GVAR(notify)[] = {
+                        {
+                            NOTIFY_DEFAULT_X,
+                            NOTIFY_DEFAULT_Y,
+                            NOTIFY_MIN_WIDTH,
+                            NOTIFY_MIN_HEIGHT
+                        },
+                        GUI_GRID_W,
+                        GUI_GRID_H
+                    };
                 };
             };
         };
@@ -21,10 +32,17 @@ class CfgUIGrids {
             class GVAR(grid) {
                 displayName = CSTRING(ProgressBarPositionName);
                 description = CSTRING(ProgressBarPositionDescription);
-                preview = "#(argb,8,8,3)color(0,0,0,1)";
+                preview = "#(argb,8,8,3)color(0,0,0,0.25)";
                 saveToProfile[] = {0,1,2,3};
                 canResize = 1;
             };
+
+            class GVAR(notify) {
+                displayName = CSTRING(NotificationPositionName);
+                description = CSTRING(NotificationPositionDescription);
+                preview = "#(argb,8,8,3)color(0,0,0,0.25)";
+                saveToProfile[] = {0,1};
+            };
         };
     };
 };

addons/ui/fnc_notify.sqf

@@ -0,0 +1,177 @@
+#include "script_component.hpp"
+/* ----------------------------------------------------------------------------
+Function: CBA_fnc_notify
+
+Description:
+    Display a text message. Multiple incoming messages are queued.
+
+Parameters:
+    _content - ARRAY
+        _line1 - ARRAY
+        _line2 - ARRAY
+        ...
+        _lineN - ARRAY
+            _text  - STRING, NUMBER: Text to display or path to .paa or .jpg image.
+            _size  - NUMBER: Text or image size multiplier, optional, default: 1
+            _color - ARRAY: RGB or RGBA color (range 0-1), optional, default: [1,1,1,1]
+
+Examples:
+    (begin example)
+    (end)
+
+Returns:
+    Nothing
+
+Authors:
+    commy2
+---------------------------------------------------------------------------- */
+
+#define LIFE_TIME 4
+#define FADE_IN_TIME 0.2
+#define FADE_OUT_TIME 1
+
+if (canSuspend) exitWith {
+    [CBA_fnc_notify, _this] call CBA_fnc_directCall;
+};
+
+if (!hasInterface) exitWith {};
+
+// compose structured text
+if !(_this isEqualType []) then {
+    _this = [_this];
+};
+
+if !(_this select 0 isEqualType []) then {
+    _this = [_this];
+};
+
+private _composition = [];
+
+{
+    _composition pushBack lineBreak;
+
+    _x params [["_text", "", ["", 0]], ["_size", 1, [0]], ["_color", [], [[]], [3,4]]];
+
+    _size = _size * 0.55 / (getResolution select 5);
+
+    _color params [
+        ["_r", 1, [0]],
+        ["_g", 1, [0]],
+        ["_b", 1, [0]],
+        ["_a", 1, [0]]
+    ];
+    _color = [_r, _g, _b, _a] call BIS_fnc_colorRGBAtoHTML;
+
+    private _isImage = toLower _text select [count _text - 4] in [".paa", ".jpg"];
+    if (_isImage) then {
+        _composition pushBack parseText format ["<img align='center' size='%2' color='%3' image='%1'/>", _text, _size, _color];
+    } else {
+        _composition pushBack parseText format ["<t align='center' size='%2' color='%3'>%1</t>", _text, _size, _color];
+    };
+} forEach _this;
+
+_composition deleteAt 0;
+
+// add the queue
+if (isNil QGVAR(notifyQueue)) then {
+    GVAR(notifyQueue) = [];
+};
+
+GVAR(notifyQueue) pushBack _composition;
+
+private _fnc_processQueue = {
+    private _composition = _this;
+
+    QGVAR(notify) cutRsc ["RscTitleDisplayEmpty", "PLAIN", 0, true];
+    private _display = uiNamespace getVariable "RscTitleDisplayEmpty";
+
+    private _vignette = _display displayCtrl 1202;
+    _vignette ctrlShow false;
+
+    private _background = _display ctrlCreate ["RscText", -1];
+    _background ctrlSetBackgroundColor [0,0,0,0.25];
+
+    private _text = _display ctrlCreate ["RscStructuredText", -1];
+    _text ctrlSetStructuredText composeText _composition;
+
+    private _controls = [_background, _text];
+
+    private _left = profileNamespace getVariable ['TRIPLES(IGUI,GVAR(notify),x)', NOTIFY_DEFAULT_X];
+    private _top = profileNamespace getVariable ['TRIPLES(IGUI,GVAR(notify),y)', NOTIFY_DEFAULT_Y];
+    private _width = profileNamespace getVariable ['TRIPLES(IGUI,GVAR(notify),w)', NOTIFY_MIN_WIDTH];
+    private _height = profileNamespace getVariable ['TRIPLES(IGUI,GVAR(notify),h)', NOTIFY_MIN_HEIGHT];
+
+    _width = ctrlTextWidth _text max _width;
+
+    // need to set this before reading the text height, to get the correct amount of auto line breaks
+    _text ctrlSetPosition [0, 0, _width, _height];
+    _text ctrlCommit 0;
+
+    private _textHeight = ctrlTextHeight _text;
+    _height = _textHeight max _height;
+
+    // ensure the box not going off screen
+    private _right = _left + _width;
+    private _bottom = _top + _height;
+
+    private _leftEdge = safezoneX;
+    private _rightEdge = safezoneW + safezoneX;
+    private _topEdge = safezoneY;
+    private _bottomEdge = safezoneH + safezoneY;
+
+    if (_right > _rightEdge) then {
+        _left = _left - (_right - _rightEdge);
+    };
+
+    if (_left < _leftEdge) then {
+        _left = _left + (_leftEdge - _left);
+    };
+
+    if (_bottom > _bottomEdge) then {
+        _top = _top - (_bottom - _bottomEdge);
+    };
+
+    if (_top < _topEdge) then {
+        _top = _top + (_topEdge - _top);
+    };
+
+    _background ctrlSetPosition [_left, _top, _width, _height];
+
+    if (_textHeight < _height) then {
+        _top = _top + (_height - _textHeight) / 2;
+    };
+
+    _text ctrlSetPosition [_left, _top, _width, _textHeight];
+
+    // fade in
+    {
+        _x ctrlSetFade 1;
+        _x ctrlCommit 0;
+        _x ctrlSetFade 0;
+        _x ctrlCommit (FADE_IN_TIME);
+    } forEach _controls;
+
+    // pop queue
+    [{
+        params ["_controls", "_fnc_processQueue"];
+
+        GVAR(notifyQueue) deleteAt 0;
+        private _composition = GVAR(notifyQueue) select 0;
+
+        if (!isNil "_composition") then {
+            _composition call _fnc_processQueue;
+        } else {
+            // fade out
+            {
+                _x ctrlSetFade 1;
+                _x ctrlCommit (FADE_OUT_TIME);
+            } forEach _controls;
+        };
+    }, [_controls, _fnc_processQueue], LIFE_TIME] call CBA_fnc_waitAndExecute;
+};
+
+if (count GVAR(notifyQueue) isEqualTo 1) then {
+    _composition call _fnc_processQueue;
+};
+
+nil

addons/ui/script_component.hpp

@@ -32,6 +32,12 @@
 #define POS_W(N) ((N) * GUI_GRID_W)
 #define POS_H(N) ((N) * GUI_GRID_H)
 
+// notify
+#define NOTIFY_DEFAULT_X (safezoneX + safezoneW - 13 * GUI_GRID_W)
+#define NOTIFY_DEFAULT_Y (safezoneY + 6 * GUI_GRID_H)
+#define NOTIFY_MIN_WIDTH (12 * GUI_GRID_W)
+#define NOTIFY_MIN_HEIGHT (3 * GUI_GRID_H)
+
 // Warning: this block below is a duplicate copy of the contents from common.hpp
 // #include "\x\cba\addons\ui\flexiMenu\data\common.hpp"
 

addons/ui/stringtable.xml

@@ -96,5 +96,15 @@
             <French>Les mots de passe ne sont pas enregistrés quand vous vous connectez à un serveur multijoueur.Les mots de passe déjà enregistrés vont être supprimés du profile.</French>
             <Turkish>Çok oyunculu bir sunucuya girerken şifreler kaydedilmez. Zaten kayıtlı olan şifreler bilgisayardan silinir.</Turkish>
         </Key>
+        <Key ID="STR_CBA_Ui_NotificationPositionName">
+            <English>Notification</English>
+            <German>Benachrichtigung</German>
+            <Polish>Powiadomienie</Polish>
+        </Key>
+        <Key ID="STR_CBA_Ui_NotificationPositionDescription">
+            <English>Textual feedback to the player.</English>
+            <German>Textrückmeldung an den Spieler.</German>
+            <Polish>Tekstowa informacja dla gracza.</Polish>
+        </Key>
     </Package>
 </Project>