safeZoneW: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>")
m (Text replacement - "[[Image:" to "[[File:")
 
(11 intermediate revisions by the same user not shown)
Line 15: Line 15:
|gr1= GUI Control - Positioning
|gr1= GUI Control - Positioning


|descr= Returns the width of the screen in screen measurement units. Taken from top left corner of the default viewport (0,0) of the screen and going in the same direction as the X axis, the value will be positive but resulting X will end up beyond the right border. Therefore in order to calculate X of the right screen border, the length of [[safeZoneX]] must be subtracted from [[safeZoneW]], but because it is negative, it must be added instead. {{hl|c= _screenRightBorderX <nowiki>=</nowiki> [[safeZoneW]] + [[safeZoneX]]}}. The measurement units depend on the current screen resolution [[getResolution]]. See also [[SafeZone]]
|descr= [[File:safezone.jpg|right|600px]]
[[Image:safezone.jpg|600px]]
Returns the width of the screen in screen measurement units.
Taken from top left corner of the default viewport (0,0) of the screen and going in the same direction as the X axis, the value will be positive but resulting X will end up beyond the right border.
Therefore in order to calculate X of the right screen border, the length of [[safeZoneX]] must be subtracted from [[safeZoneW]], but because it is negative, it must be added instead.
<sqf inline>_screenRightBorderX = safeZoneW + safeZoneX</sqf>. The measurement units depend on the current screen resolution [[getResolution]]. See also [[SafeZone]].


|s1= [[safeZoneW]]
|s1= [[safeZoneW]]


|r1= [[Number]] - Screen width in screen measurement units
|r1= [[Number]] - screen width in screen measurement units


|x1= <sqf>_screenWidth = safeZoneW;</sqf>
|x1= <sqf>_screenWidth = safeZoneW;</sqf>


|x2= <code>_screenLeftBorderX = safeZoneX;
|x2= <sqf>
_screenRightBorderX = safeZoneW + safeZoneX;</code>
_screenLeftBorderX = safeZoneX;
_screenRightBorderX = safeZoneW + safeZoneX;
</sqf>


|x3= Create control 50% wide, 30% tall, centered on screen:
|x3= Create control 50% wide, 30% tall, centered on screen:
<code>private _ctrl = findDisplay 46 createDisplay "RscDisplayEmpty" ctrlCreate ["RscText", -1];
<sqf>
private _ctrl = findDisplay 46 createDisplay "RscDisplayEmpty" ctrlCreate ["RscText", -1];
_ctrl ctrlSetBackgroundColor [1,0,0,0.5];
_ctrl ctrlSetBackgroundColor [1,0,0,0.5];
private _ctrlWidth = 0.5 * safeZoneW; // 50% of screen width
private _ctrlWidth = 0.5 * safeZoneW; // 50% of screen width
private _ctrlHeight = 0.3 * safeZoneH; // 30% of screen height
private _ctrlHeight = 0.3 * safeZoneH; // 30% of screen height
_ctrl [[ctrlSetPositionW]] _ctrlWidth;
_ctrl ctrlSetPositionW _ctrlWidth;
_ctrl [[ctrlSetPositionH]] _ctrlHeight;
_ctrl ctrlSetPositionH _ctrlHeight;
_ctrl [[ctrlSetPositionX]] (([[safeZoneW]] - _ctrlWidth) / 2 + [[safeZoneX]]); // center it horizontally
_ctrl ctrlSetPositionX ((safeZoneW - _ctrlWidth) / 2 + safeZoneX); // center it horizontally
_ctrl [[ctrlSetPositionY]] (([[safeZoneH]] - _ctrlHeight) / 2 + [[safeZoneY]]); // center it vertically
_ctrl ctrlSetPositionY ((safeZoneH - _ctrlHeight) / 2 + safeZoneY); // center it vertically
_ctrl ctrlCommit 0;</code>
_ctrl ctrlCommit 0;
</sqf>


|seealso= [[SafeZone]] [[safeZoneX]] [[safeZoneY]] [[safeZoneH]] [[safeZoneXAbs]] [[safeZoneWAbs]]
|seealso= [[SafeZone]] [[safeZoneX]] [[safeZoneY]] [[safeZoneH]] [[safeZoneXAbs]] [[safeZoneWAbs]]
}}
}}

Latest revision as of 00:10, 21 November 2023

Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
safezone.jpg

Returns the width of the screen in screen measurement units. Taken from top left corner of the default viewport (0,0) of the screen and going in the same direction as the X axis, the value will be positive but resulting X will end up beyond the right border. Therefore in order to calculate X of the right screen border, the length of safeZoneX must be subtracted from safeZoneW, but because it is negative, it must be added instead.

_screenRightBorderX = safeZoneW + safeZoneX. The measurement units depend on the current screen resolution getResolution. See also SafeZone.
Groups:
GUI Control - Positioning

Syntax

Syntax:
safeZoneW
Return Value:
Number - screen width in screen measurement units

Examples

Example 1:
_screenWidth = safeZoneW;
Example 2:
_screenLeftBorderX = safeZoneX; _screenRightBorderX = safeZoneW + safeZoneX;
Example 3:
Create control 50% wide, 30% tall, centered on screen:
private _ctrl = findDisplay 46 createDisplay "RscDisplayEmpty" ctrlCreate ["RscText", -1]; _ctrl ctrlSetBackgroundColor [1,0,0,0.5]; private _ctrlWidth = 0.5 * safeZoneW; // 50% of screen width private _ctrlHeight = 0.3 * safeZoneH; // 30% of screen height _ctrl ctrlSetPositionW _ctrlWidth; _ctrl ctrlSetPositionH _ctrlHeight; _ctrl ctrlSetPositionX ((safeZoneW - _ctrlWidth) / 2 + safeZoneX); // center it horizontally _ctrl ctrlSetPositionY ((safeZoneH - _ctrlHeight) / 2 + safeZoneY); // center it vertically _ctrl ctrlCommit 0;

Additional Information

See also:
SafeZone safeZoneX safeZoneY safeZoneH safeZoneXAbs safeZoneWAbs

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Retrieved from "https://community.bistudio.com/wiki?title=safeZoneW&oldid=349848"