createMarker

Cria um marcador em uma posição do mundo.

Sintaxe

-- servidor
marker createMarker ( number x, number y, number z [, string tipo = "default", number tamanho = 4.0, number r = 0, number g = 0, number b = 255, number a = 255, element visivelPara = root, bool ignorarLimiteAlpha = false ] )

-- cliente
marker createMarker ( number x, number y, number z [, string tipo = "default", number tamanho = 4.0, number r = 0, number g = 0, number b = 255, number a = 255, bool ignorarLimiteAlpha = false ] )

O décimo argumento não é o mesmo nos dois lados

No servidor, a décima posição é visivelPara, e ignorarLimiteAlpha vem depois dela. No cliente não existe visivelPara: ignorarLimiteAlpha já ocupa a décima posição.

Ou seja, uma chamada de servidor copiada para o cliente coloca o elemento no lugar de ignorarLimiteAlpha. Sempre confira o final da chamada quando levar código de um lado para o outro.

Parâmetros

Nome	Tipo	Padrão	Descrição
x, y, z	number	—	Posição do marcador.
tipo	string	"default"	Um dos tipos da tabela acima.
tamanho	number	4.0	Raio do marcador em unidades do jogo.
r	number	0	Canal vermelho, 0 – 255.
g	number	0	Canal verde, 0 – 255.
b	number	255	Canal azul, 0 – 255.
a	number	255	Opacidade, 0 – 255.
visivelPara	element	root	Só no servidor. Elemento que enxerga o marcador. Com o root, todos veem.
ignorarLimiteAlpha	bool	false	Permite que checkpoints e setas usem a opacidade real.

Retorno

O marcador criado, ou false se o tipo for desconhecido ou se algum canal de cor estiver fora de 0 – 255. No servidor também devolve false se visivelPara receber um valor que não é um elemento válido.

No cliente os canais de cor são tratados de outro jeito: um canal negativo faz a chamada falhar com um aviso, e um valor acima de 255 não é recusado, mas dá a volta (só o byte mais baixo é mantido, então 300 vira 44). Um tipo desconhecido devolve false lá sem aviso, e ignorarLimiteAlpha só é mantido em marcadores "checkpoint" e "arrow".

Nota

No servidor, passar false ou nil em visivelPara significa “todo mundo”, igual a deixar o argumento de fora. Um marcador criado no cliente aparece só na tela daquele jogador, e por isso não tem esse argumento.

Exemplo

-- servidor: entrada de loja, cilindro verde no chão
local entrada = createMarker(1315.0, -898.0, 39.5, "cylinder", 1.5, 0, 255, 0, 180)

addEventHandler("onMarkerHit", entrada, function(jogador)
    outputDebugString("Bem-vindo à loja!")
end)

-- cliente: mesmo marcador, com a opacidade real, só nesta tela
local entrada = createMarker(1315.0, -898.0, 39.5, "cylinder", 1.5, 0, 255, 0, 180, true)

Veja também

• getMarkerCount — Conta quantos marcadores existem no servidor.
• getMarkerType — Devolve o tipo de um marcador.
• getMarkerSize — Devolve o tamanho de um marcador.
• getMarkerColor — Devolve a cor de um marcador.
• getMarkerTarget — Devolve a posição de destino de um marcador, usada pela seta do checkpoint.
• getMarkerIcon — Devolve o ícone de um marcador.
• getMarkerTargetArrowProperties — Devolve a cor e o tamanho da seta que aponta para o alvo do checkpoint.
• setMarkerType — Troca o tipo de um marcador.