ctrlMapScreenToWorld: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "</dd> </dl> " to "</dd> </dl> ")
m (Some wiki formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma1
|game1= arma1
|version1= 1.05


|1.05
|game2= arma2
|version2= 1.00
 
|game3= arma2oa
|version3= 1.50
 
|game4= tkoh
|version4= 1.00
 
|game5= arma3
|version5= 0.50


|gr1= GUI Control - Map
|gr1= GUI Control - Map


| Converts map screen coordinates into world coordinates. Unlike [[posScreenToWorld]], this command returns world position is format [x, y], otherwise it is identical to [[posScreenToWorld]].
|descr= Converts map screen coordinates into world coordinates. Unlike [[posScreenToWorld]], this command returns world position is format [x, y], otherwise it is identical to [[posScreenToWorld]].


| control '''ctrlMapScreenToWorld''' [x, y]
|s1= control [[ctrlMapScreenToWorld]] [x, y]


|p1= control: [[Control]] - map control
|p1= control: [[Control]] - map control


|p2= [x, y]: [[Array]]
|p2= x: [[Number]] - screen X
|p3= x: [[Number]] - screen X
 
|p4= y: [[Number]] - screen Y
|p3= y: [[Number]] - screen Y


|r1=[[Array]] - world coordinates in format [[Position2D]]
|r1= [[Array]] - world coordinates in format [[Position2D]]


|x1= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] _ScreenCoord;</code>
|x1= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] _ScreenCoord;</code>
|x2= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] [_x, _y];</code>
|x2= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] [_x, _y];</code>
|x3= <code>_worldCoord = [[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlMapScreenToWorld]] [0.5, 0.5];</code>
|x3= <code>_worldCoord = [[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlMapScreenToWorld]] [0.5, 0.5];</code>


Line 30: Line 43:
<dt><dt>
<dt><dt>
<dd class="notedate">Posted on April 6, 2007 - 23:41</dd>
<dd class="notedate">Posted on April 6, 2007 - 23:41</dd>
<dt class="note">[[User:LowFly|LowFly]]<dd class="note">''Notes:''
<dt class="note">[[User:LowFly|LowFly]]</dt>
 
<dd class="note">You can get the screen coordinates by the [[User_Interface_Event_Handlers|UI Event Handlers]] onMouseButtonDown, onMouseButtonUp, onMouseButtonClick, onMouseButtonDblClick.


You can get the screen coordinates by the [[User_Interface_Event_Handlers|UI Event Handlers]] onMouseButtonDown, onMouseButtonUp, onMouseButtonClick, onMouseButtonDblClick.
The return Array is in 2D, you can use it with all set-position commands.
<code>_x = returnArray [[select]] 0;
_y = returnArray [[select]] 1;</code>
</dd>


The return Array is in 2-D, you can use it with all set-position commands.
<pre>_x = returnArray select 0;
_y = returnArray select 1;</pre>
<dt><dt>
<dt><dt>
<dd class="notedate">
<dd class="notedate">
<dt class="note">[[User:Ceeeb|Ceeeb]]<dd class="note">
<dt class="note">[[User:Ceeeb|Ceeeb]]</dt>
<dd class="note">
The command parameters are screen position coordinates, which may not equate to the map control's coordinates. A map control's screen coordinates and size can be found use the [[ctrlPosition]] command. This is an issue when using the Arma 3 in-game map, which is not fullscreen (all previous titles used full screen map controls, so map control coords did equate to screen coords).
The command parameters are screen position coordinates, which may not equate to the map control's coordinates. A map control's screen coordinates and size can be found use the [[ctrlPosition]] command. This is an issue when using the Arma 3 in-game map, which is not fullscreen (all previous titles used full screen map controls, so map control coords did equate to screen coords).
</dd>
<dt><dt>
<dt><dt>
<dd class="notedate">Posted on August 28, 2017 - 0:05</dd>
<dd class="notedate">Posted on August 28, 2017 - 0:05</dd>
<dt class="note">[[User:Icaruk|Icaruk]]<dd class="note">
<dt class="note">[[User:Icaruk|Icaruk]]</dt>
<dd class="note">
This example creates a RscMapControl and hints you the [x,y] position where you clicked.
This example creates a RscMapControl and hints you the [x,y] position where you clicked.


<code>0 spawn {<br>
<code>0 spawn {
disableSerialization;
disableSerialization;
_map = findDisplay 46 createDisplay "RscCredits" ctrlCreate ["RscMapControl", -1];
_map = findDisplay 46 createDisplay "RscCredits" ctrlCreate ["RscMapControl", -1];
Line 55: Line 74:
_x = _this select 2;
_x = _this select 2;
_y = _this select 3;<br>
_y = _this select 3;<br>
_pos = _ctrl '''ctrlMapScreenToWorld''' [_x, _y];
_pos = _ctrl [[ctrlMapScreenToWorld]] [_x, _y];
hint format ["pos: %1", _pos];
hint format ["pos: %1", _pos];
}];<br>
}];
};</code>
};</code>
</dd>
</dd>


</dl>
</dl>
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Revision as of 19:00, 12 June 2021

Hover & click on the images for description

Description

Description:
Converts map screen coordinates into world coordinates. Unlike posScreenToWorld, this command returns world position is format [x, y], otherwise it is identical to posScreenToWorld.
Groups:
GUI Control - Map

Syntax

Syntax:
control ctrlMapScreenToWorld [x, y]
Parameters:
control: Control - map control
x: Number - screen X
y: Number - screen Y
Return Value:
Array - world coordinates in format Position2D

Examples

Example 1:
_worldCoord = _control ctrlMapScreenToWorld _ScreenCoord;
Example 2:
_worldCoord = _control ctrlMapScreenToWorld [_x, _y];
Example 3:
_worldCoord = findDisplay 12 displayCtrl 51 ctrlMapScreenToWorld [0.5, 0.5];

Additional Information

See also:
ctrlMapWorldToScreenposScreenToWorldposWorldToScreenfindDisplaydisplayCtrl

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
Posted on April 6, 2007 - 23:41
LowFly
You can get the screen coordinates by the UI Event Handlers onMouseButtonDown, onMouseButtonUp, onMouseButtonClick, onMouseButtonDblClick. The return Array is in 2D, you can use it with all set-position commands. _x = returnArray select 0; _y = returnArray select 1;
Ceeeb
The command parameters are screen position coordinates, which may not equate to the map control's coordinates. A map control's screen coordinates and size can be found use the ctrlPosition command. This is an issue when using the Arma 3 in-game map, which is not fullscreen (all previous titles used full screen map controls, so map control coords did equate to screen coords).
Posted on August 28, 2017 - 0:05
Icaruk
This example creates a RscMapControl and hints you the [x,y] position where you clicked. 0 spawn { disableSerialization; _map = findDisplay 46 createDisplay "RscCredits" ctrlCreate ["RscMapControl", -1]; _map ctrlSetPosition [0,0,1,1]; _map ctrlCommit 0;
_map ctrlAddEventHandler ["mouseButtonDown", { _ctrl = _this select 0; _x = _this select 2; _y = _this select 3;
_pos = _ctrl ctrlMapScreenToWorld [_x, _y]; hint format ["pos: %1", _pos]; }]; };