Multi Theft Auto: Wiki - User contributions [en]

CreateMarker

2013-10-11T06:16:43Z

Manster:

__NOTOC__
{{Server client function}}
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.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<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 ] )

</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
* '''visibleTo''': Every element that is a child of this element can see the marker. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<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 ] )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
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
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Example 2" class="both" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("marker", -- Type In Console 'marker' To Create The Marker
function ( player, commandName )
local x,y,z = getElementPosition ( player ) -- Get The Player's Position
local Marker = createMarker(x,y,z-1, "cylinder", 2, 255, 0, 0) -- Create Marker To The Position Of Player
end
)
</syntaxhighlight>
</section>

==See Also==
{{Marker functions}}
[[ru:createMarker]]

AR/playSoundFrontEnd

2013-08-31T20:48:37Z

Manster: /* Syntax */

{{Server client function}}
__NOTOC__
. هذه الدالة تشغل الواجهة الأمامية الصوت للمشغل المحدد
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( player thePlayer, int sound )
</syntaxhighlight>

===الارقومنتات المطلوبه===
*'''thePlayer:''' [[player]] انت تريد الصوت يشتغل الى ؟.
*'''sound:''' [[int]] تحديد ايدي الصوت للتشغيل :
{{Sounds}}
</section>
<section name="Client" class="client" show="false">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( int sound )
</syntaxhighlight>

===الارقومنتات المطلوبه===
*'''sound:''' [[int]] تحديد الاي دي الصوت للتشغيل :
{{Sounds}}
</section>

===Returns===
Returns ''true'' = اذا تم تشغيل الصوت بنجاح, ''false'' = اذا لم يتم تشغيله.

==مثال==
<section name="server" class="server" show="true">
هذا المثال يشغل الصوت عند السباون
<syntaxhighlight lang="lua">
function onPlayerSpawn ( theSpawnpoint, theTeam )
playSoundFrontEnd ( source, 16 )
end
addEventHandler ( "onPlayerSpawn", getRootElement(), onPlayerSpawn ) --- الحدث عند السباون
</syntaxhighlight>
</section>
<section name="client" class="client" show="true">
'/sound' هذا المثال عندما الاعب يكتب في الشات
<syntaxhighlight lang="lua">
function onSoundEvent ( )
playSoundFrontEnd ( 16 )
end
addCommandHandler("sound", onSoundEvent)
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

[[de:playSoundFrontEnd]]

AR/playSoundFrontEnd

2013-08-31T20:47:22Z

Manster: /* مثال */

{{Server client function}}
__NOTOC__
. هذه الدالة تشغل الواجهة الأمامية الصوت للمشغل المحدد
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( player thePlayer, int sound )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' [[player]] انت تريد الصوت يشتغل الى ؟.
*'''sound:''' [[int]] تحديد ايدي الصوت للتشغيل :
{{Sounds}}
</section>
<section name="Client" class="client" show="false">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( int sound )
</syntaxhighlight>

===الارقومنتات المطلوبه===
*'''sound:''' [[int]] تحديد الاي دي الصوت للتشغيل :
{{Sounds}}
</section>

===Returns===
Returns ''true'' = اذا تم تشغيل الصوت بنجاح, ''false'' = اذا لم يتم تشغيله.

==مثال==
<section name="server" class="server" show="true">
هذا المثال يشغل الصوت عند السباون
<syntaxhighlight lang="lua">
function onPlayerSpawn ( theSpawnpoint, theTeam )
playSoundFrontEnd ( source, 16 )
end
addEventHandler ( "onPlayerSpawn", getRootElement(), onPlayerSpawn ) --- الحدث عند السباون
</syntaxhighlight>
</section>
<section name="client" class="client" show="true">
'/sound' هذا المثال عندما الاعب يكتب في الشات
<syntaxhighlight lang="lua">
function onSoundEvent ( )
playSoundFrontEnd ( 16 )
end
addCommandHandler("sound", onSoundEvent)
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

[[de:playSoundFrontEnd]]

AR/playSoundFrontEnd

2013-08-31T20:46:47Z

Manster: /* Syntax */

{{Server client function}}
__NOTOC__
. هذه الدالة تشغل الواجهة الأمامية الصوت للمشغل المحدد
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( player thePlayer, int sound )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' [[player]] انت تريد الصوت يشتغل الى ؟.
*'''sound:''' [[int]] تحديد ايدي الصوت للتشغيل :
{{Sounds}}
</section>
<section name="Client" class="client" show="false">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( int sound )
</syntaxhighlight>

===الارقومنتات المطلوبه===
*'''sound:''' [[int]] تحديد الاي دي الصوت للتشغيل :
{{Sounds}}
</section>

===Returns===
Returns ''true'' = اذا تم تشغيل الصوت بنجاح, ''false'' = اذا لم يتم تشغيله.

==مثال==
<section name="server" class="server" show="true">
هذه المثال يشغل الصوت عند السباون
<syntaxhighlight lang="lua">
function onPlayerSpawn ( theSpawnpoint, theTeam )
playSoundFrontEnd ( source, 16 )
end
addEventHandler ( "onPlayerSpawn", getRootElement(), onPlayerSpawn ) --- الحدث عند السباون
</syntaxhighlight>
</section>
<section name="client" class="client" show="true">
'/sound' هذه المثال عندما الاعب يكتب في الشات
<syntaxhighlight lang="lua">
function onSoundEvent ( )
playSoundFrontEnd ( 16 )
end
addCommandHandler("sound", onSoundEvent)
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

[[de:playSoundFrontEnd]]

AR/playSoundFrontEnd

2013-08-31T20:45:48Z

Manster: /* Syntax */

{{Server client function}}
__NOTOC__
. هذه الدالة تشغل الواجهة الأمامية الصوت للمشغل المحدد
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( player thePlayer, int sound )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' [[player]] انت تريد الصوت يشتغل الى ؟.
*'''sound:''' [[int]] تحديد ايدي الصوت للتشغيل :
{{Sounds}}
</section>
<section name="Client" class="client" show="false">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( int sound )
</syntaxhighlight>

===الارقومنتات المطلوبه===
*'''sound:''' [[int]] تحديد الاي دي الصوت للتشغيل :
{{Sounds}}
</section>

===Returns===
Returns ''true''= اذا تم تشغيل الصوت بنجاح, ''false''= اذا لم يتم تشغيله.

==مثال==
<section name="server" class="server" show="true">
هذه المثال يشغل الصوت عند السباون
<syntaxhighlight lang="lua">
function onPlayerSpawn ( theSpawnpoint, theTeam )
playSoundFrontEnd ( source, 16 )
end
addEventHandler ( "onPlayerSpawn", getRootElement(), onPlayerSpawn ) --- الحدث عند السباون
</syntaxhighlight>
</section>
<section name="client" class="client" show="true">
'/sound' هذه المثال عندما الاعب يكتب في الشات
<syntaxhighlight lang="lua">
function onSoundEvent ( )
playSoundFrontEnd ( 16 )
end
addCommandHandler("sound", onSoundEvent)
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

[[de:playSoundFrontEnd]]

AR/playSoundFrontEnd

2013-08-31T20:42:17Z

Manster: /* Syntax */

{{Server client function}}
__NOTOC__
. هذه الدالة تشغل الواجهة الأمامية الصوت للمشغل المحدد
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( player thePlayer, int sound )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' [[player]] انت تريد الصوت يشتغل الى ؟.
*'''sound:''' [[int]] تحديد ايدي الصوت للتشغيل :
{{Sounds}}
</section>
<section name="Client" class="client" show="false">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( int sound )
</syntaxhighlight>

===Required Arguments===
*'''sound:''' [[int]] تحديد الاي دي الصوت للتشغيل :
{{Sounds}}
</section>

===Returns===
Returns ''true'' اذا تم تشغيل الصوت بنجاح, ''false'' اذا لم يتم تشغيله.

==مثال==
<section name="server" class="server" show="true">
هذه المثال يشغل الصوت عند السباون
<syntaxhighlight lang="lua">
function onPlayerSpawn ( theSpawnpoint, theTeam )
playSoundFrontEnd ( source, 16 )
end
addEventHandler ( "onPlayerSpawn", getRootElement(), onPlayerSpawn ) --- الحدث عند السباون
</syntaxhighlight>
</section>
<section name="client" class="client" show="true">
'/sound' هذه المثال عندما الاعب يكتب في الشات
<syntaxhighlight lang="lua">
function onSoundEvent ( )
playSoundFrontEnd ( 16 )
end
addCommandHandler("sound", onSoundEvent)
</syntaxhighlight>
</section>

==أنظر أيضاً==
{{AR/Audio_functions}}

[[de:playSoundFrontEnd]]

CreateMarker

2013-08-31T18:46:48Z

Manster: /* Example */

__NOTOC__
{{Server client function}}
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.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<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 ] )

</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
* '''visibleTo''': Every element that is a child of this element can see the marker. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<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 ] )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
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
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Example 2" class="both" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("marker", -- Type In Console 'marker' To Create The Marker
function ( player, commandName )
local x,y,z = getELementPosition ( player ) -- Get The Player's Position
local Marker = createMarker(x,y,z-1, "cylinder", 2, 255, 0, 0) -- Create Marker To The Position Of Player
end
)
</syntaxhighlight>
</section>

==See Also==
{{Marker functions}}
[[ru:createMarker]]

CreateMarker

2013-08-31T18:20:53Z

Manster: /* Example */

__NOTOC__
{{Server client function}}
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.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<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 ] )

</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
* '''visibleTo''': Every element that is a child of this element can see the marker. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<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 ] )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
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
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Example 2" class="both" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("marker", -- Type In Console 'marker' To Create The Marker
function ( player, commandName )
local x,y,z = getELementPosition ( player ) -- Get The Player's Position
Marker = createMarker(x,y,z-1, "cylinder", 2, 255, 0, 0) -- Create Marker To The Position Of Player
end
)
</syntaxhighlight>
</section>

==See Also==
{{Marker functions}}
[[ru:createMarker]]

CreateMarker

2013-08-31T18:19:06Z

Manster: /* Example */

__NOTOC__
{{Server client function}}
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.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<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 ] )

</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
* '''visibleTo''': Every element that is a child of this element can see the marker. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<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 ] )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
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
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Example 2" class="both" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("marker", -- Type In Console 'marker' To Create The Marker
function ( player, commandName )
local x,y,z = getELementPosition ( player ) -- Get The Player's Position
Marker = createMarker(x,y,z-1, "cylinder", 2, 255, 0, 0) -- Create Marker Next To The Player
end
)
</syntaxhighlight>
</section>

==See Also==
{{Marker functions}}
[[ru:createMarker]]

CreateMarker

2013-08-31T18:17:06Z

Manster: /* Example */

__NOTOC__
{{Server client function}}
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.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<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 ] )

</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
* '''visibleTo''': Every element that is a child of this element can see the marker. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<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 ] )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
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
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Example 2" class="both" show="true">
Create A marker by using marker
<syntaxhighlight lang="lua">
addCommandHandler("marker", -- Type In Console 'marker' To Create The Marker
function ( player, commandName )
local x,y,z = getELementPosition ( player ) -- Get The Player's Position
Marker = createMarker(x,y,z-1, "cylinder", 2, 255, 0, 0) -- Create Marker Next To The Player
end
)
</syntaxhighlight>
</section>

==See Also==
{{Marker functions}}
[[ru:createMarker]]

CreateMarker

2013-08-31T18:00:47Z

Manster: /* Syntax */

__NOTOC__
{{Server client function}}
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.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<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 ] )

</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
* '''visibleTo''': Every element that is a child of this element can see the marker. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<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 ] )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
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
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Example 2" class="both" show="true">
Create a marker at the coordinates 0, 0, 20:
<syntaxhighlight lang="lua">
createMarker ( 0, 0, 20 )
</syntaxhighlight>
</section>

==See Also==
{{Marker functions}}
[[ru:createMarker]]

CreateMarker

2013-08-31T17:59:04Z

Manster: /* Syntax */

__NOTOC__
{{Server client function}}
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.

There are various limits that govern the maximum number of each type that can be visible at once. These are:
* Coronas: 32
* Checkpoints, Rings, Cylinders and Arrows combined: 32

You are able to create as many markers as you wish (memory and element limit permitting), but the player will only be able to see the nearest ones up to the limit.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("marker",
function marker( source, commandName)
local x, y, z = getElementPosition ( source )
marker = createMarker ( x, y, z, "cylinder", 2, 255, 0, 0 )
end
addCommandHandler ( "marker", marker )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
* '''visibleTo''': Every element that is a child of this element can see the marker. See [[visibility]].
</section>
<section name="Client" class="client" show="true">
<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 ] )
</syntaxhighlight>

===Required Arguments===
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional arguments===
{{OptionalArg}}
* '''theType''': The visual type of the marker to be created. Possible values:
{{Marker_types}}
* '''size''': The diameter of the marker to be created, in meters.
* '''r''': An integer number representing the amount of red to use in the colouring of the marker (0 - 255).
* '''g''': An integer number representing the amount of green 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).
</section>

===Returns===
Returns the [[marker]] element that was created, or ''false'' if the arguments are incorrect.

==Example==
<section name="Example 1" class="server" show="true">
This example creates a marker next to the player when they type 'createmarker':
<syntaxhighlight lang="lua">
-- this function is called whenever someone types 'createmarker' in the console:
function consoleCreateMarker ( thePlayer, commandName )
if ( thePlayer ) then
local x, y, z = getElementPosition ( thePlayer ) -- get the player's position
-- create a cylindrical marker next to the player:
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
outputConsole ( "Marker created successfully", thePlayer )
else
outputConsole ( "Failed to create marker", thePlayer )
end
end
end
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Example 2" class="both" show="true">
Create a marker at the coordinates 0, 0, 20:
<syntaxhighlight lang="lua">
createMarker ( 0, 0, 20 )
</syntaxhighlight>
</section>

==See Also==
{{Marker functions}}
[[ru:createMarker]]