CreateMarker: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Needs_Checking|Are there going to be more than the two marker types? what about ring markers? (Note from [[User:EAi|EAi]]: isn't that what coronas are?)|[[User:Vandalite|Vandalite]]}}
{{Needs_Checking|Shouldn't we support triangle/upside down cone markers too?|[[User:EAi|EAi]]}}
==Description==
This function creates a marker and returns a handle to the created marker. If it fails, it will return false.
This function creates a marker and returns a handle to the created marker. If it fails, it will return false.


Line 13: Line 8:
* '''x''': A floating point number representing the X coordinate on the map.
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y 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.
* '''z''': A floa{{Needs_Checking|Are there going to be more than the two marker types? what about ring markers? (Note from [[User:EAi|EAi]]: isn't that what coronas are?)|[[User:Vandalite|Vandalite]]}}
ting point number representing the Z coordinate on the map.
* '''type''': The visual type of the marker to be created.
* '''type''': The visual type of the marker to be created.
* '''size''': The size of the marker to be created.
* '''size''': The size of the marker to be created.

Revision as of 22:45, 16 May 2006

This function creates a marker and returns a handle to the created marker. If it fails, it will return false.

Syntax

marker createMarker ( float x, float y, float z, [int type, int size, int r, int g, int b, int a] )

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 floa
Dialog-information.png This article needs checking.

Reason(s): Are there going to be more than the two marker types? what about ring markers? (Note from EAi: isn't that what coronas are?)

ting point number representing the Z coordinate on the map.

  • type: The visual type of the marker to be created.
  • size: The size of the marker to be created.
  • r: An integer number representing the amount of red to use in the colouring of the marker.
  • g: An integer number representing the amount of green to use in the colouring of the marker.
  • b: An integer number representing the amount of blue to use in the colouring of the marker.
  • a: An integer number representing the amount of alpha to use in the colouring of the marker.

Acceptable type values

  • 0: Checkpoint
  • 1: Corona (doughnut-shaped)
  • 2: Cylinder
  • 3: Cone

Example

function onPlayerChat ( player, chat )
  if ( strtok ( chat, 1, 32 ) == "!createmarker" ) then
    x, y, z = getPlayerPosition ( player )
    createMarker ( x + 5, y, z, 0, 1, 255, 0, 0, 255 )
    playerPM ( player, "You got a red marker" )
  end
end