DE/createMarker

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Diese Funktion kann einen Marker in verschiedenen Formen erstellen.

Es gibt verschiedene Grenzen der Größen von Markern, so dass sie noch sichtbar sind.Siehe hier:

  • Coronas: 32
  • Checkpoints, Rings, Cylinders und Arrows combined: 32

Sie können soviele Marker wie sie wollen erstellen, jedoch kann der Spieler nur die Marker sehen, die in dem Umkreis des Spielers sind. Andere Marker, die nicht in diesem Umkreis sind, werden für den Spieler erst sichtbar wenn er in die Nähe (Umkreis) des Markers tritt.

Syntax

Click to collapse [-]
Server
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() ] )

Benötigte Argumente

  • x: Eine Gleitkomma - Zahl, die zu einem Punkt auf der Karte koordiniert.
  • y: Eine Gleitkomma - Zahl, die zu einem Punkt auf der Karte koordiniert.
  • z: Eine Gleitkomma - Zahl, die zu einem Punkt auf der Karte koordiniert.

Optimale Argumente

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • theType: Die möglichen Formen des Markers. Siehe hier:
    • "checkpoint": A race checkpoint. These are very tall, but not infinite, light pillars. Checkpoints snap to ground and become invisible after going over a certain Z height.
    • "ring": Doughnut shaped ring, normally used for aircraft.
    • "cylinder": Small glowing ground ring. These are the glow markers you walk into to activate missions or events in single player.
    • "arrow": Arrow pointing down. These are the arrows on the doors you can enter in single player, except MTA's are not animated by default.
    • "corona": A glowing ball of light.
  • size: Die Größe des Markers. Diese sind bei verschiedenen Formen begrenzt, sehe dazu oben.
  • r: Der RGB Farbcode "r". (0 - 255)
  • g: Der RGB Farbcode "g". (0 - 255)
  • b: Der RGB Farbcode "b". (0 - 255)
  • a: Diese Transparenz. (0 - 255)

<section name="Client" class="client" show="true">

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 ] )

Benötigte Argumente

  • x: Eine Gleitkomma - Zahl, die zu einem Punkt auf der Karte koordiniert.
  • y: Eine Gleitkomma - Zahl, die zu einem Punkt auf der Karte koordiniert.
  • z: Eine Gleitkomma - Zahl, die zu einem Punkt auf der Karte koordiniert.

Optimale Argumente

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • theType: Die möglichen Formen des Markers. Siehe hier:
    • "checkpoint": A race checkpoint. These are very tall, but not infinite, light pillars. Checkpoints snap to ground and become invisible after going over a certain Z height.
    • "ring": Doughnut shaped ring, normally used for aircraft.
    • "cylinder": Small glowing ground ring. These are the glow markers you walk into to activate missions or events in single player.
    • "arrow": Arrow pointing down. These are the arrows on the doors you can enter in single player, except MTA's are not animated by default.
    • "corona": A glowing ball of light.
  • size: Die Größe des Markers. Diese sind bei verschiedenen Formen begrenzt, sehe dazu oben.
  • r: Der RGB Farbcode "r". (0 - 255)
  • g: Der RGB Farbcode "g". (0 - 255)
  • b: Der RGB Farbcode "b". (0 - 255)
  • a: Diese Transparenz. (0 - 255)

Rücklauf

Erstellt den Marker. Wenn dies nicht möglich ist oder ein Argument falsch oder nicht erkennbar ist gibt es 'false' zurück.

Beispiel

Diese Funktion erstellt einen Marker bei dem aktuellen Standtpunkt des Spielers.

function createMarkerByPlayer(player, cmd)
    local x, y, z = getElementPosition(source)
	if (x, y, z) then
	    local theMarker = createMarker ( x + 2, y + 2, z, "cylinder", 1.5, 255, 255, 0, 170 )
		outputChatBox("Marker wurde erstellt!", source)
	else
	    outputChatBox("Fehler beim erstellen des Markers!", source)
	end
end
addCommandHandler("createmarker", createMarkerByPlayer)

Siehe auch