setAnalogControlState

Aciona um controle analógico por script, ou o solta.

Sintaxe

bool setAnalogControlState ( string controle [, number estado, bool forcar = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
controle	string	—	Um dos 14 nomes de controle analógico listados acima. Não diferencia maiúsculas de minúsculas.
estado	number	—	O quanto pressionar, de 0 a 1; valores fora disso são limitados. Omita para soltar o controle e devolvê-lo ao jogador.
forcar	bool	false	true mantém o seu valor mesmo enquanto o jogador pressiona o controle por conta própria.

Pressionar um lado de um par (left/right, forwards/backwards, vehicle_left/vehicle_right, steer_forward/steer_back e os pares special_control_*) zera o lado oposto.

Retorno

true se o valor foi aplicado, false se o nome não for de um controle analógico. Chamar só com o nome do controle sempre devolve true, mesmo para um nome desconhecido. Um nome de controle que não seja texto registra um aviso e devolve false; um segundo argumento que não seja número nem ausente registra um aviso e devolve false.

Exemplo

-- anda para frente com meio acelerador por três segundos
setAnalogControlState("accelerate", 0.5)
setTimer(function()
    setAnalogControlState("accelerate")
end, 3000, 1)

Veja também

• getAnalogControlState — Lê o quanto um controle analógico está pressionado.
• toggleControl — Liga ou desliga um controle para o jogador local.