safeZoneY: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "[[Image:" to "[[File:")
 
(32 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma2
|game1= arma2
|version1= 1.00


|1.00
|game2= arma2oa
|version2= 1.50


|gr1= GUI Control
|game3= tkoh
|version3= 1.00


| [[Image:safezone.jpg|600px]]<br><br>
|game4= arma3
|version4= 0.50


Returns the Y of the top border of the screen, which is also a distance in screen measurement units from top left corner of the default viewport (0,0) of the screen to the top border of the screen. Since it is going in opposite way of the Y axis, <u>the value is negative</u>. The measurement units depend on the current screen resolution [[getResolution]]. See also [[SafeZone]]
|gr1= GUI Control - Positioning


| [[safeZoneY]]
|descr= [[File:safezone.jpg|right|600px]] Returns the Y of the top border of the screen, which is also a distance in screen measurement units from top left corner of the default viewport (0,0) of the screen to the top border of the screen.
Since it is going in opposite way of the Y axis, <u>the value is negative</u>. The measurement units depend on the current screen resolution [[getResolution]]. See also [[SafeZone]].


| [[Number]]
|s1= [[safeZoneY]]


| x1= <code>_screenTopBorderY = [[safeZoneY]]; // returns a float value < 0</code>
|r1= [[Number]]


| x2= Create control 50% wide, 30% tall, centered on screen:<code>[[private]] _ctrl = [[findDisplay]] 46 [[createDisplay]] "RscDisplayEmpty" [[ctrlCreate]] ["RscText", -1];
|x1= <sqf>_screenTopBorderY = safeZoneY; // returns a float value < 0</sqf>
_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;</code>


|seealso= [[SafeZone]], [[safeZoneX]], [[safeZoneW]], [[safeZoneH]], [[safeZoneXAbs]]
|x2= Create control 50% wide, 30% tall, centered on screen:
<sqf>
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;
</sqf>
 
|seealso= [[SafeZone]] [[safeZoneX]] [[safeZoneW]] [[safeZoneH]] [[safeZoneXAbs]] [[safeZoneWAbs]]
}}
}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 23:11, 20 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 Y of the top border of the screen, which is also a distance in screen measurement units from top left corner of the default viewport (0,0) of the screen to the top border of the screen. Since it is going in opposite way of the Y axis, the value is negative. The measurement units depend on the current screen resolution getResolution. See also SafeZone.
Groups:
GUI Control - Positioning

Syntax

Syntax:
safeZoneY
Return Value:
Number

Examples

Example 1:
_screenTopBorderY = safeZoneY; // returns a float value < 0
Example 2:
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 safeZoneW 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=safeZoneY&oldid=350006"