OverlapParams
*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 OverlapParams
Ao contrário da maioria dos tipos de dados no Luau, você pode alterar todos os membros de OverlapParams sem criar um novo Objeto, permitindo que você reutilize o mesmo objeto repetidamente.
Resumo
Construtores
- new()
Propriedades
Um array de objetos cujos descendentes são usados para filtrar candidatos.
Determina como a lista OverlapParams.FilterDescendantsInstances é usada.
A quantidade máxima de peças a serem devolvidas pela consulta.
O grupo de colisão usado para a operação.
Determina se a operação de BasePart.CanCollide considera o valor de propriedade BasePart.CanQuery de uma peça sobre seu valor Class.BasePart.CanQuery.
Quando ativado, a query ignorará todas as propriedades de colisão de partes e executará um teste de força bruta em cada parte.
Métodos
Adiciona as instâncias fornecidas a FilterDescendantsInstances .
Construtores
new
Propriedades
FilterDescendantsInstances
Um array de objetos cujos descendentes são usados para filtrar candidatos.
FilterType
Determina como o arrego OverlapParams.FilterDescendantsInstances é usado, dependendo do arrego Enum.RaycastFilterType fornecido. O padrão é Enum.RaycastFilterType.Exclude.
MaxParts
A quantidade máxima de peças a serem devolvidas pela consulta. O valor padrão de zero ( 0 ) representa nenhum limite.
CollisionGroup
Especifica um grupo de colisão para a operação. Peças em grupos de colisão que estão definidas para não colidir com este grupo são ignoradas. Se esta propriedade for omitida, a operação pressiona o grupo de colisão padrão.
RespectCanCollide
Essa propriedade, se true , faz com que a operação de busca de limites use o valor BasePart.CanCollide da peça interconectada em favor de seu valor BasePart.CanQuery quando determinar se essa peça está incluída no conjunto de resultados de busca espacial.
BruteForceAllSlow
Quando ativado, a consulta ignorará todas as propriedades de colisão de partes e executará um teste de força bruta em cada parte. Isso afetará negativamente o desempenho e não deve ser usado em experiências ao vivo.
Métodos
AddToFilter
Para eficiência e simplicidade, este método é a maneira preferida de adicionar instâncias ao filtro. Ele tem a vantagem adicional de que ele permite que FilterDescendantsInstances seja atualizado a partir de um contexto paralelo.