RaycastParams
*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 datos RaycastParams almacena parámetros para WorldRoot:Raycast() operaciones.La propiedad FilterDescendantsInstances almacena un array de objetos para usar como una lista de inclusión o exclusión basada en el enum RaycastParams.FilterType.Si lo desea, la propiedad RaycastParams.IgnoreWater se puede utilizar para ignorar el agua Terrain y la propiedad RaycastParams.CollisionGroup puede especificar un grupo de colisión para la operación de lanzamiento de rayos.
Este objeto es diferente del similarmente llamado RaycastResult que proporciona los resultados de un raycast.
A diferencia de la mayoría de los tipos de datos en Luau, puedes cambiar todos los miembros de RaycastParams sin crear un nuevo objeto, lo que te permite reutilizar el mismo objeto repetidamente.
Resumen
Constructores
- new()
Devuelve un vacío RaycastParams .
Propiedades
Un conjunto de objetos cuyos descendientes se utilizan para filtrar los candidatos a lanzamiento de rayos.
Determina cómo se usa el FilterDescendantsInstances array.
Determina si el material de agua se considera al lanzar rayos contra Terrain .
El grupo de colisión utilizado para la operación.
Determina si la operación de lanzamiento de rayos considera el valor de propiedad de una parte CanCollide sobre su valor 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 RaycastParams 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 los candidatos a lanzamiento de rayos.
FilterType
Determina cómo se usa el FilterDescendantsInstances array, dependiendo de lo que se proporcione Enum.RaycastFilterType.
CollisionGroup
Specifica un grupo de colisión para la operación de lanzamiento de rayos.Las piezas en grupos de colisión que están configuradas como no colisionan con este grupo se ignoran.Si esta propiedad se omite, el raycast asume el grupo de colisión predeterminado Default .
RespectCanCollide
Esta propiedad, si true , hace que la operación de lanzamiento de rayos use el valor de CanCollide de una parte interseccionada a favor de su valor de CanQuery cuando determine si esa parte se incluye en el RaycastResult .
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.