CreateMarker - Revision history

FileEX: Add new argument

2024-07-15T18:37:17Z

Add new argument

← Older revision		Revision as of 18:37, 15 July 2024
Line 19:		Line 19:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, element visibleTo = getRootElement( ) ] )		marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, element visibleTo = getRootElement( ), bool ignoreAlphaLimits = false ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|\|Marker}}		{{OOP\|\|Marker}}
Line 37:		Line 37:
	* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).		* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).
	* '''visibleTo''': This defines which elements can see the marker. Defaults to visible to everyone. See [[visibility]].		* '''visibleTo''': This defines which elements can see the marker. Defaults to visible to everyone. See [[visibility]].
			{{New feature/item\|9.0161\|1.6.0\|22620\|
			* '''ignoreAlphaLimits''': This argument is only valid for '''checkpoint''' and '''arrow''' markers. It defines whether the alpha of these markers can be changed. If the argument is false, the marker has a constant alpha as before, i.e. checkpoint always 128 and arrow always 255. If the argument is true, alpha can be changed.
			}}
	</section>		</section>
	<section name="Client" class="client" show="true">		<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255 ] )		marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, bool ignoreAlphaLimits = false ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|\|Marker}}		{{OOP\|\|Marker}}
Line 57:		Line 60:
	* '''b''': An integer number representing the amount of blue to use in the colouring of the marker (0 - 255).		* '''b''': An integer number representing the amount of blue to use in the colouring of the marker (0 - 255).
	* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).		* '''a''': An integer number representing the amount of alpha to use in the colouring of the marker (0 - 255 where 0 is transparent and 255 is opaque).
	</section>		{{New feature/item\|9.0161\|1.6.0\|22620\|
			* '''ignoreAlphaLimits''': This argument is only valid for '''checkpoint''' and '''arrow''' markers. It defines whether the alpha of these markers can be changed. If the argument is false, the marker has a constant alpha as before, i.e. checkpoint always 128 and arrow always 255. If the argument is true, alpha can be changed.
			}}</section>

	===Returns===		===Returns===

IManGaaX at 12:39, 10 October 2023

2023-10-10T12:39:56Z

← Older revision		Revision as of 12:39, 10 October 2023
Line 66:		Line 66:
	This example creates a marker next to the player when they type 'createmarker':		This example creates a marker next to the player when they type 'createmarker':
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- this function is called whenever someone types 'createmarker' in the ~~console~~:		-- this function is called whenever someone types 'createmarker' in the chat:
	function chatCreateMarker ( thePlayer, commandName )		function chatCreateMarker ( thePlayer, commandName )
	if ( thePlayer ) then		if ( thePlayer ) then
Line 73:		Line 73:
	local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )		local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
	if isElement ( theMarker ) then -- check if the marker was created successfully		if isElement ( theMarker ) then -- check if the marker was created successfully
	~~outputChatbox~~ ( "Marker created successfully", thePlayer, 0, 255, 0 )		outputChatBox ( "Marker created successfully", thePlayer, 0, 255, 0 )
	else		else
	~~outputChatbox~~ ( "Failed to create marker", thePlayer, 255, 0, 0 )		outputChatBox ( "Failed to create marker", thePlayer, 255, 0, 0 )
	end		end
	end		end

IManGaaX at 12:39, 10 October 2023

2023-10-10T12:39:04Z

← Older revision		Revision as of 12:39, 10 October 2023
Line 67:		Line 67:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- this function is called whenever someone types 'createmarker' in the console:		-- this function is called whenever someone types 'createmarker' in the console:
	function ~~consoleCreateMarker~~ ( thePlayer, commandName )		function chatCreateMarker ( thePlayer, commandName )
	if ( thePlayer ) then		if ( thePlayer ) then
	local x, y, z = getElementPosition ( thePlayer ) -- get the player's position		local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
Line 79:		Line 79:
	end		end
	end		end
	addCommandHandler ( "createmarker", ~~consoleCreateMarker~~ )		addCommandHandler ( "createmarker", chatCreateMarker )
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

IManGaaX: edit the example

2023-10-10T12:38:07Z

edit the example

← Older revision		Revision as of 12:38, 10 October 2023
Line 72:		Line 72:
	-- create a cylindrical marker next to the player:		-- create a cylindrical marker next to the player:
	local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )		local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
	if ( theMarker ) then -- check if the marker was created successfully		if isElement ( theMarker ) then -- check if the marker was created successfully
	~~outputConsole~~ ( "Marker created successfully", thePlayer )		outputChatbox ( "Marker created successfully", thePlayer, 0, 255, 0 )
	else		else
	~~outputConsole~~ ( "Failed to create marker", thePlayer )		outputChatbox ( "Failed to create marker", thePlayer, 255, 0, 0 )
	end		end
	end		end

Tracer: Added another warning

2021-11-16T05:50:36Z

Added another warning

← Older revision		Revision as of 05:50, 16 November 2021
Line 2:		Line 2:
	{{Server client function}}		{{Server client function}}
	{{Warning\|When using type "arrow" markers, you may experience positioning issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground to avoid issues.}}		{{Warning\|When using type "arrow" markers, you may experience positioning issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground to avoid issues.}}
			{{Warning\|"cylinder" marker type doesn't have the same size for collisions and visible textures. Note that the marker collisions are around 10-20% bigger than the visible texture.}}

	[[Image:Mtasa_markers.png\|thumb\|337px\|This image shows all the different marker types available using this function.]]		[[Image:Mtasa_markers.png\|thumb\|337px\|This image shows all the different marker types available using this function.]]

Woovie at 04:44, 12 October 2020

2020-10-12T04:44:47Z

← Older revision		Revision as of 04:44, 12 October 2020
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server client function}}		{{Server client function}}

	{{Warning\|When using type "arrow" markers, you may experience positioning issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground to avoid issues.}}		{{Warning\|When using type "arrow" markers, you may experience positioning issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground to avoid issues.}}

Woovie at 04:44, 12 October 2020

2020-10-12T04:44:29Z

← Older revision		Revision as of 04:44, 12 October 2020
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Server client function}}		{{Server client function}}

			{{Warning\|When using type "arrow" markers, you may experience positioning issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground to avoid issues.}}

	[[Image:Mtasa_markers.png\|thumb\|337px\|This image shows all the different marker types available using this function.]]		[[Image:Mtasa_markers.png\|thumb\|337px\|This image shows all the different marker types available using this function.]]

	{{Warning\|When using type "arrow" markers, you may experience positioning issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground to avoid issues.}}

	This function creates a marker. A marker is a 3D model in the world that can highlight a particular point or area, often used to instruct players where to go to perform actions such as entering buildings.		This function creates a marker. A marker is a 3D model in the world that can highlight a particular point or area, often used to instruct players where to go to perform actions such as entering buildings.

Woovie at 04:44, 12 October 2020

2020-10-12T04:44:13Z

← Older revision		Revision as of 04:44, 12 October 2020
Line 3:		Line 3:

	[[Image:Mtasa_markers.png\|thumb\|337px\|This image shows all the different marker types available using this function.]]		[[Image:Mtasa_markers.png\|thumb\|337px\|This image shows all the different marker types available using this function.]]

			{{Warning\|When using type "arrow" markers, you may experience positioning issues. This is a known issue with how GTA creates these types of markers. It is recommended you keep the position at least 1 game unit above the ground to avoid issues.}}

	This function creates a marker. A marker is a 3D model in the world that can highlight a particular point or area, often used to instruct players where to go to perform actions such as entering buildings.		This function creates a marker. A marker is a 3D model in the world that can highlight a particular point or area, often used to instruct players where to go to perform actions such as entering buildings.

DezZolation at 22:51, 17 March 2019

2019-03-17T22:51:24Z

← Older revision		Revision as of 22:51, 17 March 2019
Line 17:		Line 17:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, ~~bool~~ visibleTo = getRootElement( ) ] )		marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, element visibleTo = getRootElement( ) ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|\|Marker}}		{{OOP\|\|Marker}}

NanoBob: Missing argument type

2019-03-08T09:48:49Z

Missing argument type

← Older revision		Revision as of 09:48, 8 March 2019
Line 17:		Line 17:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, visibleTo = getRootElement( ) ] )		marker createMarker ( float x, float y, float z [, string theType = "checkpoint", float size = 4.0, int r = 0, int g = 0, int b = 255, int a = 255, bool visibleTo = getRootElement( ) ] )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|\|Marker}}		{{OOP\|\|Marker}}