RaycastParams
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
O tipo de dado RaycastParams armazena parâmetros para WorldRoot:Raycast() operações.A propriedade FilterDescendantsInstances armazena um conjunto de objetos para usar como uma lista de inclusão ou exclusão com base no RaycastParams.FilterType enum.Se desejado, a propriedade RaycastParams.IgnoreWater pode ser usada para ignorar Terrain a água e a propriedade RaycastParams.CollisionGroup pode especificar um grupo de colisão para a operação de lançamento de raios.
Este objeto é diferente do similarmente chamado RaycastResult que fornece os resultados de um raycast.
Ao contrário da maioria dos tipos de dados em Luau, você pode alterar todos os membros de RaycastParams sem criar um novo Objeto, permitindo que você reutilize o mesmo objeto repetidamente.
Resumo
Construtores
- new()
Propriedades
Um conjunto de objetos cujos descendentes são usados para filtrar candidatos de lançamento de raios.
Determina como o FilterDescendantsInstances é usado.
Determina se o material de água é considerado ao lançar raios contra Terrain .
O grupo de colisão usado para a operação.
Determina se a operação de lançamento de raio considera o valor da propriedade da peça CanCollide sobre seu valor CanQuery.
Quando ativado, a consulta ignorará todas as propriedades de colisão de peças e realizará uma verificação de força bruta em cada peça.
Métodos
Adiciona as instâncias fornecidas a FilterDescendantsInstances.
Construtores
new
Propriedades
FilterDescendantsInstances
Um conjunto de objetos cujos descendentes são usados para filtrar candidatos de lançamento de raios.
FilterType
Determina como o array FilterDescendantsInstances é usado, dependendo do fornecido Enum.RaycastFilterType.
CollisionGroup
Especifica um grupo de colisão para a operação de lançamento de raios.Peças em grupos de colisão que são definidas como não colidem com este grupo são ignoradas.Se esta propriedade for omitida, o raycast assumirá o grupo de colisão padrão Padrão .
RespectCanCollide
Essa propriedade, se true , faz com que a operação de lançamento de raio use o valor da peça intersecada CanCollide em favor de seu valor de CanQuery quando determinar se essa peça está incluída no RaycastResult .
BruteForceAllSlow
Quando ativado, a consulta ignorará todas as propriedades de colisão de peças e realizará uma verificação de força bruta em cada peça.Isso terá impacto negativo no desempenho e não deve ser usado em experiências ao vivo.
Métodos
AddToFilter
Para eficiência e simplicidade, esse método é a maneira preferida de adicionar instâncias ao filtro.Tem a vantagem adicional de permitir que FilterDescendantsInstances seja atualizado a partir de um contexto paralelo.