OverlapParams

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

El tipo de dato OverlapParams almacena parámetros para su uso con WorldRoot funciones de consulta de límite, en particular WorldRoot:GetPartBoundsInBox(), WorldRoot:GetPartBoundsInRadius() y WorldRoot:GetPartsInPart().La propiedad OverlapParams.FilterDescendantsInstances almacena un array de objetos para usar como una lista de inclusión o exclusión basada en el enum OverlapParams.FilterType y la propiedad OverlapParams.CollisionGroup puede especificar un grupo de colisión para la operación de consulta de borde.

A diferencia de la mayoría de los tipos de datos en Luau, puedes cambiar todos los miembros de OverlapParams sin crear un nuevo objeto, lo que te permite reutilizar el mismo objeto repetidamente.

Resumen

Constructores

Propiedades

Métodos

Constructores

new

Devuelve un objeto vacío OverlapParams vacío.A diferencia de otros constructores de tipo de datos, este constructor no tiene parámetros, por lo que debe establecer sus propiedades apropiadamente.

Propiedades

FilterDescendantsInstances

Un conjunto de objetos cuyos descendientes se utilizan para filtrar candidatos.

Determina cómo se usa el OverlapParams.FilterDescendantsInstances array, dependiendo de lo que se proporcione Enum.RaycastFilterType. El predeterminado es Enum.RaycastFilterType.Exclude.

MaxParts

La cantidad máxima de partes que debe devolver la consulta. El valor predeterminado de cero ( 0 ) representa ningún límite.

CollisionGroup

Specifica un grupo de colisión para la operación.Las piezas en grupos de colisión que están configuradas como no colisionan con este grupo se ignoran.Si esta propiedad se omite, la operación asume el grupo de colisión predeterminado Default .

RespectCanCollide

Esta propiedad, si true , hace que la operación de consulta de límites use el valor de BasePart.CanCollide de una parte interseccionada a favor de su valor de BasePart.CanQuery cuando determine si esa parte se incluye en el conjunto de resultados de consulta espacial.

BruteForceAllSlow

Cuando está habilitado, la consulta ignorará todas las propiedades de colisión de partes y realizará una verificación de fuerza bruta en cada parte.Esto tendrá un impacto negativo en el rendimiento y no debe usarse en experiencias en vivo.

Métodos

AddToFilter

()
Escribir paralelo

Para la eficiencia y la simplicidad, este método es la forma preferida de agregar instancias al filtro.Tiene la ventaja adicional de que permite FilterDescendantsInstances actualizar desde un contexto paralelo.

Parámetros

instances: Instance | Array

Una instancia o un array que contenga instancias para añadir.

Devuelve

()