OverlapParams
*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
- new()
Devuelve un objeto vacío OverlapParams vacío.
Propiedades
Un conjunto de objetos cuyos descendientes se utilizan para filtrar candidatos.
Determina cómo se usa la lista OverlapParams.FilterDescendantsInstances.
La cantidad máxima de partes que debe devolver la consulta.
El grupo de colisión utilizado para la operación.
Determina si la operación de consulta de límites considera el valor de propiedad de una parte BasePart.CanCollide sobre su valor BasePart.CanQuery.
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.
Métodos
Añade las instancias proporcionadas a FilterDescendantsInstances .
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.
FilterType
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
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.