OverlapParams

Mostrar obsoleto

*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

Propriedades

Métodos

Construtores

new

Retorna um Objetovazio OverlapParams neutro.Ao contrário de outros construtores de tipo de dados, este construtor não tem parâmetros, então você deve definir suas propriedades adequadamente.

Propriedades

FilterDescendantsInstances

Um conjunto de objetos cujos descendentes são usados para filtrar candidatos.

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

()
Escrever Parallel

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.

Parâmetros

instances: Instance | Array

Uma instância ou um array que contém instâncias para adicionar.

Devolução

()