User Interface Colors: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (revert + fix)
Tag: Undo
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:Take On Helicopters: Editing]]
[[{{tkoh}}]] introduced ability to recolor menu and HUD colors. Community creators can define new presets or use user's colors using following configs and functions.
[[Take On Helicopters]] introduced ability to recolor menu and HUD colors. Community creators can define new presets or use user's colors using following configs and functions.
{{TOC|none}}


== Presets ==
== Presets ==
[[File:UI InterfaceColors.jpg|thumb|200px|Interface Colors menu]]
[[File:UI InterfaceColors.jpg|thumb|200px|Interface Colors menu]]
Presets are avaiable for users in Options > Game Options > Interface Colors menu. Anybody can define new presets and categories.
Presets are avaiable for users in Options > Game Options > Interface Colors menu. Anybody can define new presets and categories.
  class CfgUIDefault
  class CfgUIDefault
  {
  {
  {{codecomment|//--- Tag}}
  {{cc|--- Tag}}
  class <span style="color:orange;">'''IGUI'''</span>
  class <span style="color:orange;">'''IGUI'''</span>
  {
  {
  {{codecomment|//--- Name displayed in menu}}
  {{cc|--- Name displayed in menu}}
  displayName = $STR_HSIM_CfgUIDefault_IGUI_0;
  displayName = $STR_HSIM_CfgUIDefault_IGUI_0;
  {{codecomment|//--- Color variables}}
  {{cc|--- Color variables}}
  class Variables
  class Variables
  {
  {
  {{codecomment|//--- Identification class ised by presets and scripts}}
  {{cc|--- Identification class ised by presets and scripts}}
  class <span style="color:green;">'''TEXT_RGB'''</span>
  class <span style="color:green;">'''TEXT_RGB'''</span>
  {
  {
  {{codecomment|//--- Name displayed in menu}}
  {{cc|--- Name displayed in menu}}
  displayName = $STR_HSIM_CfgUIDefault_IGUI_Variables_TEXT_RGB_0;
  displayName = $STR_HSIM_CfgUIDefault_IGUI_Variables_TEXT_RGB_0;
  {{codecomment|//--- Preview picture background}}
  {{cc|--- Preview picture background}}
  previewBackground = "\hsim\UI_H\data\loadscreen_generic_co.paa";
  previewBackground = "\hsim\UI_H\data\loadscreen_generic_co.paa";
  {{codecomment|//--- Preview picture (when 1 instead of [[String]], whole menu is recolored instead)}}
  {{cc|--- Preview picture (when 1 instead of [[String]], whole menu is recolored instead)}}
  preview = "\hsim\UI_H\data\cursor_w_view_gs.paa";
  preview = "\hsim\UI_H\data\cursor_w_view_gs.paa";
  {{codecomment|//--- Preview picture width}}
  {{cc|--- Preview picture width}}
  previewW = 4 * GUI_GRID_W;
  previewW = 4 * GUI_GRID_W;
  {{codecomment|//--- Preview picture height}}
  {{cc|--- Preview picture height}}
  previewH = 4 * GUI_GRID_H;
  previewH = 4 * GUI_GRID_H;
  };
  };
  };
  };
  {{codecomment|//--- Color presets}}
  {{cc|--- Color presets}}
  class Presets
  class Presets
  {
  {
  class PresetDefault
  class PresetDefault
  {
  {
  {{codecomment|//--- Name displayed in menu}}
  {{cc|--- Name displayed in menu}}
  displayName = $STR_HSIM_CfgUIDefault_IGUI_Presets_PresetGreen_0;
  displayName = $STR_HSIM_CfgUIDefault_IGUI_Presets_PresetGreen_0;
  {{codecomment|//--- Class of modified variable (TEXT_RGB) with RGBA values}}
  {{cc|--- Class of modified variable (TEXT_RGB) with RGBA values}}
  <span style="color:green;">'''TEXT_RGB'''</span>[] = {0,1,0.05,0.8};
  <span style="color:green;">'''TEXT_RGB'''</span>[] = {0,1,0.05,0.8};
  {{codecomment|//--- When 1, preset is used as default}}
  {{cc|--- When 1, preset is used as default}}
  default = 1;
  default = 1;
  };
  };
Line 53: Line 54:


== Macros ==
== Macros ==
=== Adding new ===
=== Adding new ===
System stores preset variables into [[profileNameSpace]] upon startup. UI controls can link to them using [[getVariable]] command.


Using macros helps to keep the code simple and maintain in through development.
System stores preset variables into [[profileNamespace]] upon startup. UI controls can link to them using [[getVariable]] command.
  #define IGUI_TEXT_RGB_R "(profileNameSpace getVariable ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_R',0])"
 
  #define IGUI_TEXT_RGB_G "(profileNameSpace getVariable ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_G',1])"
Using [[PreProcessor_Commands|macros]] helps to keep the code simple and maintain in through development.
  #define IGUI_TEXT_RGB_B "(profileNameSpace getVariable ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_B',0.05])"
  #define IGUI_TEXT_RGB_R "([[profileNamespace]] [[getVariable]] ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_R', 0])"
  #define IGUI_TEXT_RGB_A "(profileNameSpace getVariable ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_A',0.8])"
  #define IGUI_TEXT_RGB_G "([[profileNamespace]] [[getVariable]] ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_G', 1])"
  #define IGUI_TEXT_RGB_B "([[profileNamespace]] [[getVariable]] ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_B', 0.05])"
  #define IGUI_TEXT_RGB_A "([[profileNamespace]] [[getVariable]] ['<span style="color:orange;">'''IGUI'''</span>_<span style="color:green;">'''TEXT_RGB'''</span>_A', 0.8])"


Explanation:
Explanation:
* '''#define IGUI_TEXT_RGB_R''' - macro name. Can be anything, but naming it based on preset is recommended.
* '''#define IGUI_TEXT_RGB_R''' - macro name. Can be anything, but naming it based on preset is recommended.
* '''"(profileNameSpace getVariable ['IGUI_TEXT_RGB_R',0])"''' - actual value. Must be [[String]], otherwise macro would be terminated after first comma (,)
* '''"(profileNamespace getVariable ['IGUI_TEXT_RGB_R',0])"''' - actual value. Must be [[String]], otherwise macro would be terminated after first comma (,)
** '''IGUI_TEXT_RGB''' - variable created by system based on preset. Created from <tag>_<variable>
** '''IGUI_TEXT_RGB''' - variable created by system based on preset. Created from <tag>_<variable>
** '''0''' - default value in case variable is not found (used on first game start)
** '''0''' - default value in case variable is not found (used on first game start)


=== Existing ===


=== Existing ===
Color macros are defined in ''defineCommon.inc'' (see [[User Interface Macros]] for more details). Following defines are based on user modifiable colors:
Color macros are defined in ''defineCommon.inc'' (see [[User Interface Macros]] for more details). Following defines are based on user modifiable colors:


Line 82: Line 85:
** '''IGUI_TEXT_COLOR''' - HUD color RGBA
** '''IGUI_TEXT_COLOR''' - HUD color RGBA


=== Sample Configs ===


=== Sample Configs ===
Set text/picture color to HUD color
Set text/picture color to HUD color
colorText[] = IGUI_TEXT_COLOR;
<syntaxhighlight lang="cpp">
colorText[] = IGUI_TEXT_COLOR;
</syntaxhighlight>
Set text/picture color to HUD color with fixed alpha (e.g. override user transparency settings)
Set text/picture color to HUD color with fixed alpha (e.g. override user transparency settings)
colorText[] = {IGUI_TEXT_RGB,1};
<syntaxhighlight lang="cpp">
colorText[] = { IGUI_TEXT_RGB, 1 };
</syntaxhighlight>




== Functions ==
== Functions ==
* [[BIS_fnc_displayColorGet]]
* [[BIS_fnc_displayColorGet]]
* [[BIS_fnc_displayColorSet]]
* [[BIS_fnc_displayColorSet]]
{{GameCategory|tkoh|Editing}}

Revision as of 22:50, 29 January 2021

Take On Helicopters introduced ability to recolor menu and HUD colors. Community creators can define new presets or use user's colors using following configs and functions.

Presets

Interface Colors menu

Presets are avaiable for users in Options > Game Options > Interface Colors menu. Anybody can define new presets and categories. 

class CfgUIDefault
{
	// --- Tag
	class IGUI
	{
		// --- Name displayed in menu
		displayName = $STR_HSIM_CfgUIDefault_IGUI_0;
		// --- Color variables
		class Variables
		{
			// --- Identification class ised by presets and scripts
			class TEXT_RGB
			{
				// --- Name displayed in menu
				displayName = $STR_HSIM_CfgUIDefault_IGUI_Variables_TEXT_RGB_0;
				// --- Preview picture background
				previewBackground = "\hsim\UI_H\data\loadscreen_generic_co.paa";
				// --- Preview picture (when 1 instead of String, whole menu is recolored instead)
				preview = "\hsim\UI_H\data\cursor_w_view_gs.paa";
				// --- Preview picture width
				previewW = 4 * GUI_GRID_W;
				// --- Preview picture height
				previewH = 4 * GUI_GRID_H;
			};
		};
		// --- Color presets
		class Presets
		{
			class PresetDefault
			{
				// --- Name displayed in menu
				displayName = $STR_HSIM_CfgUIDefault_IGUI_Presets_PresetGreen_0;
				// --- Class of modified variable (TEXT_RGB) with RGBA values
				TEXT_RGB[] = {0,1,0.05,0.8};
				// --- When 1, preset is used as default
				default = 1;
			};
			class PresetBlue
			{
				displayName = $STR_HSIM_CfgUIDefault_IGUI_Presets_PresetDefault_0;
				TEXT_RGB[] = {0,1,1,0.8};
			};
		};
	};
};


Macros

Adding new

System stores preset variables into profileNamespace upon startup. UI controls can link to them using getVariable command.

Using macros helps to keep the code simple and maintain in through development. 

#define IGUI_TEXT_RGB_R	"(profileNamespace getVariable ['IGUI_TEXT_RGB_R', 0])"
#define IGUI_TEXT_RGB_G	"(profileNamespace getVariable ['IGUI_TEXT_RGB_G', 1])"
#define IGUI_TEXT_RGB_B	"(profileNamespace getVariable ['IGUI_TEXT_RGB_B', 0.05])"
#define IGUI_TEXT_RGB_A	"(profileNamespace getVariable ['IGUI_TEXT_RGB_A', 0.8])"

Explanation:

  • #define IGUI_TEXT_RGB_R - macro name. Can be anything, but naming it based on preset is recommended.
  • "(profileNamespace getVariable ['IGUI_TEXT_RGB_R',0])" - actual value. Must be String, otherwise macro would be terminated after first comma (,)
    • IGUI_TEXT_RGB - variable created by system based on preset. Created from <tag>_<variable>
    • 0 - default value in case variable is not found (used on first game start)

Existing

Color macros are defined in defineCommon.inc (see User Interface Macros for more details). Following defines are based on user modifiable colors:

  • GUI (menus)
    • GUI_BCG_RGB - menu background RGB
    • GUI_BCG_COLOR - menu background RGBA
    • GUI_BCG_MEDIUM_RGB - button background RGB (darker version of GUI_BCG_RGB)
    • GUI_BCG_MEDIUM_COLOR - button background RGBA
    • GUI_BCG_ACTIVE_RGB - active button background color (e.g. focused buttons) RGB
  • IGUI (HUD)
    • IGUI_TEXT_RGB - HUD color RGB
    • IGUI_TEXT_COLOR - HUD color RGBA

Sample Configs

Set text/picture color to HUD color 

colorText[] = IGUI_TEXT_COLOR;

Set text/picture color to HUD color with fixed alpha (e.g. override user transparency settings) 

colorText[] = { IGUI_TEXT_RGB, 1 };


Functions

Retrieved from "https://community.bistudio.com/wiki?title=User_Interface_Colors&oldid=225065"