GetActorPos PT
From SA-MP Wiki
GetActorPos
| Está função foi adicionada na versão SA-MP 0.3.7 e não irá funcionar em versões antigas! |
Descrição:
Pega as coordenadas de um actor.
(actorid, &Float:X, &Float:Y, &Float:Z)
| actorid | O ID do actor para pegar as coordenadas. Retornada pela função CreateActor. |
| X | Uma variável float passada por referência, onde será armazenada a coordenada X do ator. |
| Y | Uma variável float passada por referência, onde será armazenada a coordenada Y do ator. |
| Z | Uma variável float passada por referência, onde será armazenada a coordenada Z do ator. |
Valores de retorno:
- 1: Função executada com sucesso.
- 0: Falha na execução da função. O actor não existe.
- As coordenadas do actor são armazenadas nas variáveis especificadas.
Exemplo de uso:
new Float:x, Float:y, Float:z; GetActorPos(actorid, x, y, z); printf("Coordenadas do Actor ID %d", actorid); printf("X: %f\nY: %f\nZ: %f\n", x, y, z);
Funções Relacionadas
As seguintes funções podem ser úteis, pois estão de alguma forma, relacionadas a esta função.
- CreateActor: Cria um ator.
- DestroyActor: Destrói um ator.
- IsActorStreamedIn: Verifica se um ator apareceu para um jogador específico.
- GetActorVirtualWorld: Pega o id do mundo virtual atual do ator.
- ApplyActorAnimation: Aplica uma animação em um ator.
- ClearActorAnimations: Para todas as animações que o ator esteja executando.
- SetActorPos: Seta o ator em uma determinada posição.
- GetActorPos: Pega a posição atual do ator.
- SetActorFacingAngle: Seta a face do ator para um determinado ângulo.
- GetActorFacingAngle: Pega o ângulo que o ator esta olhando.
- SetActorHealth: Altera a vida do ator.
- GetActorHealth: Pega a vida do ator.
- SetActorInvulnerable: Alterna a invulnerabilidade do ator.
- IsActorInvulnerable: Verifica se o ator é invulnerável.
- IsValidActor: Verifica se o id é de um ator válido.
- GetActorPoolSize: Pega o id mais alto do ator criado no servidor.
Callbacks Relacionadas
As seguintes Callbacks podem ser úteis, pois estão relacionadas de alguma forma a esta função.
- OnActorStreamIn: É chamada quando um ator é visível para um jogador.
- OnActorStreamOut: É chamada quando um ator não é mais visível para um jogador.
- OnPlayerGiveDamageActor: É chamada quando jogador da dano em um ator.
