Işın İzleme

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

En temel seviyede, ışın izleme, belirli bir yönde ve tanımlı bir uzunlukta Vector3 noktasından görünmez bir ışın göndermektir. Işın atıldıktan sonra, ışının bir BasePart veya Terrain hücresine çarpıp çarpmadığını tespit edebilirsiniz.

Süzülen küreler tarafından lazerler ateşlenir ve ışın izleme, bir lazerin bir platforma çarpıp çarpmadığını belirler. Lazerler tarafından dokunulan platformlar geçici olarak yok edilir.

Vector3 kökeninden Vector3 yönünde ışın atmak için WorldRoot:Raycast() yöntemini (Workspace:Raycast()) kullanabilirsiniz.

Temel Işın İzleme
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)

Işın atarken, yön parametresi ışının istenen uzunluğunu içermelidir. Örneğin, yönün büyüklüğü 10 ise, sonuçta oluşan ışın 10 uzunluğunda olacaktır. Maksimum uzunluk 15.000 birimdir.

Uygun olduğunda, bilinen bir kök ve hedef kullanarak bilinmeyen bir yön vektörünü (rayDirection) hesaplayabilirsiniz. Bu, iki nokta arasında ışın atarken yararlıdır; örneğin, bir oyuncu karakterinden diğerine.

Kök ve yön vektörü, ışının hedefine işaret eder:

$\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$
Eşitliğin her iki tarafından $\text{rayOrigin}$ çıkarın:

$\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$
Işının yönü, hedeften kökün çıkarılmasıyla elde edilir:

$\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)

Filtre seçenekleri

WorldRoot:Raycast() belirli BaseParts'ları kapsayıcı olarak dahil etmek veya hariç tutmak için, Terrain içindeki Su materyalini yok saymak veya bir çarpışma grubu kullanmak için isteğe bağlı RaycastParams nesnesini kabul eder.

Anahtar	Açıklama
FilterDescendantsInstances	Raycasting adaylarını filtrelemek için kullanılan nesnelerin Array'si.
FilterType	Enum.RaycastFilterType enumerasyonu, FilterDescendantsInstances dizisinin raycast işlemi sırasında nasıl kullanılacağını belirler. Exclude — Her BasePart, dizideki nesnelerin alt nesneleri hariç tutulmak üzere değerlendirilir. Include — Yalnızca dizideki nesnelerin alt nesneleri olan BaseParts dikkate alınır.
IgnoreWater	Boolean türünde, raycasting sırasında Su materyalinin dikkate alınıp alınmayacağını belirler.
CollisionGroup	Raycasting işlemi için kullanılan çarpışma grubunun adıdır.

Işın İzleme Filtreleme
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)

Çarpışma tespiti

Eğer ışın izleme işlemi geçerli bir BasePart veya Terrain hücresine çarparsa, sonuçları içeren bir RaycastResult nesnesi döner. Bir çarpışmanın olup olmadığını test etmek için, sonucun nil olmadığını doğrulayın ve gerektiğinde aşağıdaki özellikleri kullanın.

Özellik	Açıklama
Instance	Işının kesiştiği BasePart veya Terrain hücresidir.
Position	Işın ile Instance arasındaki kesişim noktasının Vector3 konumudur.
Distance	Işın kökü ile kesişim noktası arasındaki mesafedir.
Material	Kesişim noktasındaki BasePart veya Terrain'in Enum.Material'dır.
Normal	Kesişen yüzeyin normal vektörünün Vector3'üdür.

Örnek akışı etkinleştirildiğinde, bir istemci uzak BaseParts'ları akışa almış olmayabilir, dolayısıyla bir raycast çarpmasını tespit edemeyebilir. Ayrıca, akış sistemi tarafından üretilen düşük detaylı "imposter" Terrain ve Models yalnızca görseldir ve uygun raycast hedefleri değildir.

Herhangi bir BasePart'ı çarpışma tespitinden hariç tutmak için BasePart.CanQuery özelliğini false olarak ayarlayabilirsiniz.

Işın İzleme Çarpışma Tespiti
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("Raycast sonucu yok!")
end

Türkçe