Raycasting | Documentatie - Roblox Creator Hub

Op het meest basale niveau is raycasting de handeling van het uitzenden van een onzichtbare straal vanuit een Vector3 punt in een specifieke richting met een gedefinieerde lengte. Zodra de straal is uitgezonden, kun je detecteren of de straal een BasePart of Terrain cel raakt.

Lasers worden afgevuurd door zwevende bollen, en raycasting bepaalt of een laser een platform raakt. Platforms die door de lasers worden aangeraakt, worden tijdelijk vernietigd.

Je kunt een straal uitzenden met de WorldRoot:Raycast() methode (Workspace:Raycast()) vanuit een Vector3 oorsprong in een Vector3 richting.

Basis Raycast

local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.new(0, 0, 0)
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

Bij het uitzenden van een straal moet de richtingsparameter de gewenste lengte van de straal omvatten. Als de grootte van de richting bijvoorbeeld 10 is, zal de resulterende straal ook een lengte van 10 hebben. De maximale lengte is 15.000 studs.

Wanneer van toepassing, kun je een onbekende richtingsvector (rayDirection) berekenen met een bekende oorsprong en bestemming. Dit is nuttig wanneer je een straal tussen twee punten wilt uitzenden die kunnen veranderen, zoals van de ene speler naar de andere.

De oorsprong plus een richtingsvector geeft de bestemming van de straal aan:

$\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$
Trek $\text{rayOrigin}$ van beide zijden van de vergelijking af:

$\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$
De richting van de straal is gelijk aan de bestemming min de oorsprong:

$\text{rayDirection} = \text{rayDestination} - \text{rayOrigin}$

local Workspace = game:GetService("Workspace")

local rayOrigin = Workspace.TestOrigin.Position
local rayDestination = Workspace.TestDestination.Position

local rayDirection = rayDestination - rayOrigin

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

Filteropties

WorldRoot:Raycast() accepteert een optioneel RaycastParams object dat de raycast vertelt om selectief bepaalde BaseParts op te nemen of uit te sluiten, het Water materiaal voor Terrain te negeren, of een botsingsgroep te gebruiken.

Sleutel	Beschrijving
FilterDescendantsInstances	Array van objecten waarvan de afstammelingen worden gebruikt bij het filteren van raycasting kandidaten.
FilterType	Enum.RaycastFilterType enum die bepaalt hoe de FilterDescendantsInstances array wordt gebruikt in de raycast operatie. Exclude — Elke BasePart wordt beschouwd behalve die welke afstammelingen zijn van objecten in de array. Include — Alleen BaseParts die afstammelingen zijn van objecten in de array worden beschouwd.
IgnoreWater	Boolean die bepaalt of het Water materiaal wordt beschouwd bij raycasting tegen Terrain.
CollisionGroup	String naam van de botsingsgroep die wordt gebruikt voor de raycasting operatie.

Raycast Filtering

local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastParams = RaycastParams.new()
raycastParams.FilterDescendantsInstances = {script.Parent}
raycastParams.FilterType = Enum.RaycastFilterType.Exclude
raycastParams.IgnoreWater = true

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection, raycastParams)

Botsingsdetectie

Als de raycasting operatie een geschikte BasePart of Terrain cel raakt, wordt een RaycastResult object geretourneerd met de resultaten. Om te testen op een botsing, bevestig dat het resultaat niet nil is en gebruik de volgende eigenschappen indien nodig.

Eigenschap	Beschrijving
Instance	De BasePart of Terrain cel die de straal heeft gekruist.
Position	Vector3 positie van de intersectie tussen de straal en de Instance.
Distance	Afstand tussen de straal oorsprong en het intersectiepunt.
Material	De Enum.Material van de BasePart of Terrain op het intersectiepunt.
Normal	Vector3 van de normale vector van het gekruiste vlak.

Wanneer gebruikt in een plaats met instance streaming ingeschakeld, kan een client mogelijk niet verre BaseParts hebben gestreamd, zodat een raycast mogelijk geen botsing detecteert. Bovendien zijn laag-detail "imposter" Terrain en Models die door het streaming systeem zijn gegenereerd puur visueel en zijn ze geen geschikte raycast-doelen.

Je kunt elke BasePart vrijstellen van botsingsdetectie door de BasePart.CanQuery eigenschap in te stellen op false.

Raycast Botsingsdetectie

local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

if raycastResult then
	print("Instance:", raycastResult.Instance)
	print("Position:", raycastResult.Position)
	print("Distance:", raycastResult.Distance)
	print("Material:", raycastResult.Material)
	print("Normal:", raycastResult.Normal)
else
	warn("Geen raycast resultaat!")
end