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 armazena parâmetros para uso com WorldRoot funções de consulta de limite, em especial WorldRoot:GetPartBoundsInBox(), WorldRoot:GetPartBoundsInRadius() e WorldRoot:GetPartsInPart().A propriedade OverlapParams.FilterDescendantsInstances armazena um conjunto de objetos para usar como uma lista de inclusão ou exclusão com base no OverlapParams.FilterType enum e a propriedade OverlapParams.CollisionGroup pode especificar um grupo de colisão para a operação de consulta de limite.
Ao contrário da maioria dos tipos de dados em 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 conjunto 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 retornadas pela consulta.
O grupo de colisão usado para a operação.
Determina se a operação de consulta de limite considera o valor da propriedade da parte BasePart.CanCollide sobre seu valor BasePart.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.
FilterType
Determina como o array OverlapParams.FilterDescendantsInstances é usado, dependendo do fornecido Enum.RaycastFilterType. 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 são definidas como não colidem com este grupo são ignoradas.Se esta propriedade for omitida, a operação assumirá o grupo de colisão padrão Padrão .
RespectCanCollide
Essa propriedade, se true , faz com que a operação de consulta de limite use o valor BasePart.CanCollide de uma parte intersecada em favor de seu valor BasePart.CanQuery quando determinar se essa parte está incluída no conjunto de resultados de consulta espaciais.
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.