ctrlMapScreenToWorld: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| arma1 |Game name=
| arma1


|1.05|Game version=
|1.05


|gr1= GUI Control - Map |GROUP1=
|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]].|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]].


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


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


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


| [[Array]] - world coordinates in format [[Position2D]] |RETURNVALUE=
| [[Array]] - world coordinates in format [[Position2D]]
   
   
|x1= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] _ScreenCoord;</code> |EXAMPLE1=
|x1= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] _ScreenCoord;</code>
|x2= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] [_x, _y];</code> |EXAMPLE2=
|x2= <code>_worldCoord = _control [[ctrlMapScreenToWorld]] [_x, _y];</code>
|x3= <code>_worldCoord = [[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlMapScreenToWorld]] [0.5, 0.5];</code> |EXAMPLE3=
|x3= <code>_worldCoord = [[findDisplay]] 12 [[displayCtrl]] 51 [[ctrlMapScreenToWorld]] [0.5, 0.5];</code>


| [[ctrlMapWorldToScreen]], [[posScreenToWorld]], [[posWorldToScreen]], [[findDisplay]], [[displayCtrl]] |SEEALSO=
| [[ctrlMapWorldToScreen]], [[posScreenToWorld]], [[posWorldToScreen]], [[findDisplay]], [[displayCtrl]]


}}
}}

Revision as of 00:28, 18 January 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, y]: Array
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

Notes

Posted on April 6, 2007 - 23:41
LowFly
Notes: You can get the screen coordinates by the UI Event Handlers onMouseButtonDown, onMouseButtonUp, onMouseButtonClick, onMouseButtonDblClick. The return Array is in 2-D, 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]; }];
};

Bottom Section