CreateBlip

From Multi Theft Auto: Wiki
Revision as of 15:40, 9 January 2008 by Jax (talk | contribs)
Jump to navigation Jump to search

This function creates a blip element, which is displayed as an icon on the client's radar.

Syntax

blip createBlip ( float x, float y, float z, [int icon=0, int size=2, int r=255, int g=0, int b=0, int a=255, int ordering=0, visibleTo=getRootElement()] )

Required Arguments

Optional Arguments

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.

  • icon: The icon that the radar blips should be. Valid values are:
  • 0: Marker       If higher than player:   If lower than player:
  • 1: White_square Note: it's actually white, darkened for display here
  • 2: Centre
  • 3: Map_here
  • 4: North
  • 5: Airyard
  • 6: Gun
  • 7: Barbers
  • 8: Big_smoke
  • 9: Boatyard
  • 10: Burgershot
  • 11: Bulldozer
  • 12: Cat_pink
  • 13: Cesar
  • 14: Chicken
  • 15: Cj
  • 16: Crash1
  • 17: Diner
  • 18: Emmetgun
  • 19: Enemyattack
  • 20: Fire
  • 21: Girlfriend
  • 22: Hospital
  • 23: Loco
  • 24: Madd Dogg
  • 25: Mafia
  • 26: Mcstrap
  • 27: Mod_garage
  • 28: Ogloc
  • 29: Pizza
  • 30: Police
  • 31: Property_green
  • 32: Property_red
  • 33: Race
  • 34: Ryder
  • 35: Savehouse
  • 36: School
  • 37: Mystery
  • 38: Sweet
  • 39: Tattoo
  • 40: Truth
  • 41: Waypoint
  • 42: Toreno_ranch
  • 43: Triads
  • 44: Triads_casino
  • 45: Tshirt
  • 46: Woozie
  • 47: Zero
  • 48: Date_disco
  • 49: Date_drink
  • 50: Date_food
  • 51: Truck
  • 52: Cash
  • 53: Flag
  • 54: Gym
  • 55: Impound
  • 56: Runway_light
  • 57: Runway
  • 58: Gang_b
  • 59: Gang_p
  • 60: Gang_y
  • 61: Gang_n
  • 62: Gang_g
  • 63: Spray
  • size: The size of the radar blip. Default is 2.
  • r: The amount of red in the blip's color (0 - 255). Only applicable to the none icon. Default is 255.
  • g: The amount of green in the blip's color (0 - 255). Only applicable to the none icon. Default is 0.
  • b: The amount of blue in the blip's color (0 - 255). Only applicable to the none icon. Default is 0.
  • a: The amount of alpha in the blip's color (0 - 255). Default is 255.
  • ordering: This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.

Only applies to server side scripting

  • visibleTo: What elements can see the blip. Defaults to visible to everyone. See visibility.

Example

Click to collapse [-]
Server

Example 1: This example creates a radar blip at a random player's position and makes it so that it is only visible to that player.

-- Pick a random player
myPlayer = getRandomPlayer ()
-- Retrieve the player's position and store it in the variables x, y and z
x,y,z = getElementPosition ( myPlayer )
-- Create a radar blip at the player's position, with a 'cash' icon and only visible to the player
myBlip = createBlip ( x, y, z, 51, 0, 0, 0, 255, myPlayer )

Example 2: This example attaches a blip to a player. You can attach a blip to an element by just setting the blip's parent to that element. <syntaxhighlight lang="lua"> -- Pick a random player myPlayer = getRandomPlayer () -- Create a radar blip in the middle of the map myBlip = createBlip ( 0, 0, 0 ) -- Make the player the parent of the blip, so that the blip follows the player around setElementParent ( myBlip, myPlayer )

</syntaxhighlight>

See Also