GetWorldPositionFromMapPosition - Revision history

LordHenry: /* Example */

2023-03-03T05:38:14Z

Example

← Older revision		Revision as of 05:38, 3 March 2023
Line 82:		Line 82:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
	Author: LordHenry		Author: [[User:LordHenry\|LordHenry]]

	==See Also==		==See Also==
	{{Useful_Functions}}		{{Useful_Functions}}

LordHenry: /* Code */

2023-03-03T05:38:02Z

Code

← Older revision		Revision as of 05:38, 3 March 2023
Line 34:		Line 34:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
	'''Author:''' LordHenry		'''Author:''' [[User:LordHenry\|LordHenry]]

	==Example==		==Example==

LordHenry at 21:58, 25 April 2021

2021-04-25T21:58:58Z

← Older revision		Revision as of 21:58, 25 April 2021
Line 3:		Line 3:
	__NOTOC__		__NOTOC__
	[[File:Radar.jpg\|256px\|thumb\|right\|Map being draw on the screen]]		[[File:Radar.jpg\|256px\|thumb\|right\|Map being draw on the screen]]
	This function allows you to get the world position from a clicked map position ~~being draw on the screen~~.		This function allows you to get the world position from a clicked F11 map position.
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">float, float, float getWorldPositionFromMapPosition (float cursorX, float cursorY, bool relative)</syntaxhighlight>		<syntaxhighlight lang="lua">float, float, float getWorldPositionFromMapPosition (float cursorX, float cursorY, bool relative)</syntaxhighlight>

LordHenry: /* Syntax */

2021-04-25T21:34:02Z

Syntax

← Older revision		Revision as of 21:34, 25 April 2021
Line 5:		Line 5:
	This function allows you to get the world position from a clicked map position being draw on the screen.		This function allows you to get the world position from a clicked map position being draw on the screen.
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">float, float, float getWorldPositionFromMapPosition (~~int clickX~~, ~~int clickY~~)</syntaxhighlight>		<syntaxhighlight lang="lua">float, float, float getWorldPositionFromMapPosition (float cursorX, float cursorY, bool relative)</syntaxhighlight>

	===Required arguments===		===Required arguments===
	* '''~~clickX~~''': ~~An integer~~ representing the ~~absolute~~ cursor X position ~~when clicking on the screen~~.		* '''cursorX''': A float representing the cursor X position.
	* '''~~clickY~~''': ~~An integer~~ representing the ~~absolute~~ cursor Y position ~~when clicking on~~ the screen.		* '''cursorY''': A float representing the cursor Y position.
			* '''relative''': A bool that indicates if the cursor x/y positions are relative to the screen or absolute.

	===Return===		===Return===

LordHenry: /* Return */

2021-04-25T21:29:34Z

Return

← Older revision		Revision as of 21:29, 25 April 2021
Line 13:		Line 13:
	===Return===		===Return===
	Returns three ''float''s indicating the world position of the clicked map position, ''x'', ''y'' and ''z'' respectively. Returns ''false'' if the clicked position is out of the map being draw on the screen.		Returns three ''float''s indicating the world position of the clicked map position, ''x'', ''y'' and ''z'' respectively. Returns ''false'' if the clicked position is out of the map being draw on the screen.
	~~{{Warning\|Using a map image at different scale/positions will result in wrong positions.}}~~

	==Code==		==Code==

LordHenry: /* Example */

2021-04-25T21:27:19Z

Example

← Older revision		Revision as of 21:27, 25 April 2021
Line 38:		Line 38:
	==Example==		==Example==
	<section name="Example" class="client" show="true">		<section name="Example" class="client" show="true">
	This example creates a blip on the ~~Radar~~ and F11 map where the player clicked. The player must ~~click on a custom map created by using~~ /map command.		This example creates a blip on the radar and F11 map where the player clicked. The player must use /map command instead of F11 to show the map with cursor.
	<syntaxhighlight lang="lua">~~local screenX, screenY = guiGetScreenSize()~~		<syntaxhighlight lang="lua">local theBlip = false
	~~local mapImage = dxCreateTexture ("radar.jpg") -- Can be found at: MTA San Andreas 1.5\MTA\cgui\images\radar.jpg~~
	local theBlip = false

	function mapClick (~~button~~, ~~state, absoluteX, absoluteY~~)		function mapClick (cursorPosX, cursorPosY)
	if (~~rendering) then -- If the map is rendering, then:~~		if (getWorldPositionFromMapPosition (cursorPosX, cursorPosY, true)) then -- If the user clicked inside the map area, then:
	if (~~state == "up" and button == "left") then -- If the button released was the left mouse button~~, ~~then:~~		if (isElement (theBlip)) then
	~~if (getWorldPositionFromMapPosition (absoluteX~~, ~~absoluteY~~)) then -- If the user clicked inside the map area, then:		destroyElement (theBlip)
	if (isElement (theBlip)) then		theBlip = nil
	destroyElement (theBlip)		playSoundFrontEnd(40)
	theBlip = nil		else
	~~outputChatBox~~ (~~"Blip removed."~~)		local posX, posY, posZ = getWorldPositionFromMapPosition (cursorPosX, cursorPosY, true)
	else		theBlip = createBlip (posX, posY, posZ)
	local posX, posY, posZ = getWorldPositionFromMapPosition (~~absoluteX~~, ~~absoluteY~~)		playSoundFrontEnd(40)
	theBlip = createBlip (posX, posY, posZ)
	~~outputChatBox~~ (~~"Blip created at: X = "..posX..", Y = "..posY..", Z = "..posZ~~)
	~~end~~
	~~end~~
	end		end
	end		end
	end		end
	~~addEventHandler ("onClientClick", root, mapClick)~~

	function ~~renderMap~~ ()		function toggleCustomMap (cmd)
	~~dxDrawImage~~ (~~screenX/2 - screenY/2~~, 0, ~~screenY~~, ~~screenY~~, ~~mapImage~~) ~~-- Draws the map on the center of the screen.~~ (~~the blip won't show here, only on Radar and F11 map~~)		if (isPlayerMapVisible()) then
			removeEventHandler ("onClientKey", root, mapControls)
			forcePlayerMap (false)
			showCursor (false)
			else
			addEventHandler ("onClientKey", root, mapControls)
			forcePlayerMap (true)
			showCursor (true)
			end
	end		end
			addCommandHandler ("map", toggleCustomMap) -- Show F11 map, cursor and enables the blip creation buttons.

	function ~~toggleCustomMap~~ (~~cmd~~)		function mapControls (button, pressing)
	if ~~rendering~~ then		if (pressing) then -- Avoid double triggering.
	~~removeEventHandler~~ ("~~onClientRender~~", ~~root~~, ~~renderMap~~)		if (button == "mouse1") then -- If left mouse button is used, create/remove the blip from the map.
	~~else~~		local cursorPos = Vector2 (getCursorPosition()) -- Get cursor relative position.
	~~addEventHandler~~ ("~~onClientRender~~", ~~root, renderMap~~)		mapClick (cursorPos.x, cursorPos.y)
			elseif (button == "mouse2") then -- If right mouse button is used, hide F11 map and disable blip creation buttons.
			toggleCustomMap()
			elseif (button == getKeyBoundToCommand ("radar")) then -- If F11 map is visible using /map command, disable F11 so the player must use right mouse button to hide it.
			cancelEvent()
			end
	end		end
	~~rendering = not rendering~~
	~~showCursor (rendering)~~
	end		end
	~~addCommandHandler ("map", toggleCustomMap) -- Show/hide custom map and cursor.~~
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

LordHenry: /* Code */

2021-04-25T21:21:01Z

Code

← Older revision		Revision as of 21:21, 25 April 2021
Line 17:		Line 17:
	==Code==		==Code==
	<section name="Client" class="client" show="true">		<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">function getWorldPositionFromMapPosition (~~clickX~~, ~~clickY)~~		<syntaxhighlight lang="lua">function getWorldPositionFromMapPosition (cursorX, cursorY, relative)
	~~local screen = Vector2(guiGetScreenSize()~~)		if (relative) then
	if (~~clickX >= screen.x/2 - screen.y/2) and (clickX <= screen.x/2 + screen.y/2~~) then ~~-- If the user clicked inside the map area, then:~~		local screen = Vector2(guiGetScreenSize()) -- Get screen resolution.
	local ~~worldPosX~~ = ((~~(screen.x/2 - clickX) / (screen.y/2~~)) * -~~1) * 3000~~ -~~- Converts the clicked X map position to world X coordinate~~.		cursorX, cursorY = cursorX * screen.x, cursorY * screen.y -- Converts cursor relative position to absolute position.
	~~local worldPosY~~ = ~~(((~~screen.~~y-1) - clickY~~~~2) / (~~screen.y~~-1)) 3000~~ -- Converts ~~the clicked Y map~~ position to ~~world Y coordinate.~~
	~~local worldPosZ = getGroundPosition (worldPosX, worldPosY, 530) -- It becomes 0 if the~~ position ~~is too far away from the localPlayer~~.
	~~return worldPosX, worldPosY, worldPosZ~~
	end		end
	return false		local mx, my, Mx, My = getPlayerMapBoundingBox() -- Get map start and finish positions,
			local mapMin = Vector2(mx, my) -- Separate map start position in a Vector2 variable.
			local mapMax = Vector2(Mx, My) -- Separata map finish position in a Vector2 variable.
			if (cursorX >= mapMin.x and cursorY >= mapMin.y and cursorX <= mapMax.x and cursorY <= mapMax.y) then -- If the user clicked inside the map area, then:
			local relPos = Vector2((cursorX - mapMin.x) / (mapMax.x - mapMin.x), (cursorY - mapMin.y) / (mapMax.y - mapMin.y)) -- Make cursor position relative to map position and scale.
			local worldPlanePos = Vector2(6000 * (relPos.x - 0.5), 3000 - (relPos.y * 6000)) -- Converts relative map position to world position.
			return worldPlanePos.x, worldPlanePos.y, getGroundPosition(worldPlanePos.x, worldPlanePos.y, 530) -- Returns the world position. Also adds a Z value to the position, it becomes 0 if the position is too far away from localPlayer.
			end
			return false -- Returns false if the clicked position is out of the map.
	end		end
	</syntaxhighlight>		</syntaxhighlight>

LordHenry: Created page with "{{Useful Function}} NOTOC Map being draw on the screen This function allows you to get the world position from a cli..."

2021-04-25T19:13:49Z

Created page with "{{Useful Function}} <lowercasetitle/> __NOTOC__ 256px|thumb|right|Map being draw on the screen This function allows you to get the world position from a cli..."

New page

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
[[File:Radar.jpg|256px|thumb|right|Map being draw on the screen]]
This function allows you to get the world position from a clicked map position being draw on the screen.
==Syntax==
<syntaxhighlight lang="lua">float, float, float getWorldPositionFromMapPosition (int clickX, int clickY)</syntaxhighlight>

===Required arguments===
* '''clickX''': An integer representing the absolute cursor X position when clicking on the screen.
* '''clickY''': An integer representing the absolute cursor Y position when clicking on the screen.

===Return===
Returns three ''float''s indicating the world position of the clicked map position, ''x'', ''y'' and ''z'' respectively. Returns ''false'' if the clicked position is out of the map being draw on the screen.
{{Warning|Using a map image at different scale/positions will result in wrong positions.}}

==Code==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">function getWorldPositionFromMapPosition (clickX, clickY)
local screen = Vector2(guiGetScreenSize())
if (clickX >= screen.x/2 - screen.y/2) and (clickX <= screen.x/2 + screen.y/2) then -- If the user clicked inside the map area, then:
local worldPosX = (((screen.x/2 - clickX) / (screen.y/2)) * -1) * 3000 -- Converts the clicked X map position to world X coordinate.
local worldPosY = (((screen.y-1) - clickY*2) / (screen.y-1)) * 3000 -- Converts the clicked Y map position to world Y coordinate.
local worldPosZ = getGroundPosition (worldPosX, worldPosY, 530) -- It becomes 0 if the position is too far away from the localPlayer.
return worldPosX, worldPosY, worldPosZ
end
return false
end
</syntaxhighlight>
</section>
'''Author:''' LordHenry

==Example==
<section name="Example" class="client" show="true">
This example creates a blip on the Radar and F11 map where the player clicked. The player must click on a custom map created by using /map command.
<syntaxhighlight lang="lua">local screenX, screenY = guiGetScreenSize()
local mapImage = dxCreateTexture ("radar.jpg") -- Can be found at: MTA San Andreas 1.5\MTA\cgui\images\radar.jpg
local theBlip = false

function mapClick (button, state, absoluteX, absoluteY)
if (rendering) then -- If the map is rendering, then:
if (state == "up" and button == "left") then -- If the button released was the left mouse button, then:
if (getWorldPositionFromMapPosition (absoluteX, absoluteY)) then -- If the user clicked inside the map area, then:
if (isElement (theBlip)) then
destroyElement (theBlip)
theBlip = nil
outputChatBox ("Blip removed.")
else
local posX, posY, posZ = getWorldPositionFromMapPosition (absoluteX, absoluteY)
theBlip = createBlip (posX, posY, posZ)
outputChatBox ("Blip created at: X = "..posX..", Y = "..posY..", Z = "..posZ)
end
end
end
end
end
addEventHandler ("onClientClick", root, mapClick)

function renderMap ()
dxDrawImage (screenX/2 - screenY/2, 0, screenY, screenY, mapImage) -- Draws the map on the center of the screen. (the blip won't show here, only on Radar and F11 map)
end

function toggleCustomMap (cmd)
if rendering then
removeEventHandler ("onClientRender", root, renderMap)
else
addEventHandler ("onClientRender", root, renderMap)
end
rendering = not rendering
showCursor (rendering)
end
addCommandHandler ("map", toggleCustomMap) -- Show/hide custom map and cursor.
</syntaxhighlight>
</section>
Author: LordHenry

==See Also==
{{Useful_Functions}}

GetWorldPositionFromMapPosition - Revision history

LordHenry: /* Example */

LordHenry: /* Code */

LordHenry at 21:58, 25 April 2021

LordHenry: /* Syntax */

LordHenry: /* Return */

LordHenry: /* Example */

LordHenry: /* Code */

LordHenry: Created page with "{{Useful Function}} __NOTOC__ Map being draw on the screen This function allows you to get the world position from a cli..."

LordHenry: Created page with "{{Useful Function}} NOTOC Map being draw on the screen This function allows you to get the world position from a cli..."