Physics.Raycast

Deklarasyon

public static bool Raycast(Vector3 origin, Vector3 direction, float maxDistance = Mathf.Infinity, int layerMask = DefaultRaycastLayers, QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.UseGlobal);


Parametreler
originIşının dünya koordinatlarındaki başlangıç noktası.
directionIşının yönü.
maxDistanceIşının çarpışmaları kontrol etmek için maksimum mesafesi.
layerMaskBir ışın fırlatılırken Collider'ları seçmeli olarak yoksaymak için kullanılan bir Layer mask.
queryTriggerInteractionBu sorgunun Trigger'ları vurup vurmayacağını belirtir.

Dönüş Değeri
bool Eğer ışın bir Collider ile kesişiyorsa true, aksi halde false döner.

Açıklama
Bir ışın, origin noktasından başlayarak, direction yönde, maxDistance uzunluğunda, Sahne içindeki tüm collider'larla çarpışır.

İsterseniz bir LayerMask sağlayarak, çarpışmaları üretmek istemediğiniz Collider'ları filtreleyebilirsiniz.

queryTriggerInteraction belirtilmesi, Trigger collider'larının bir çarpma oluşturup oluşturmayacağını veya global Physics.queriesHitTriggers ayarını kullanıp kullanmayacağını kontrol etmenizi sağlar.

Notlar: Raycast'ler, Raycast başlangıcı Collider içinde ise o Collider'ları algılamaz. Bu örneklerin hepsinde, Update yerine FixedUpdate kullanılmıştır. Update ve FixedUpdate arasındaki farkı anlamak ve bunların fizik sorguları ile nasıl ilişkili olduğunu görmek için Olay Fonksiyonlarının Yürütme Sırası sayfasına bakınız.

using UnityEngine;

// C# örneği.

public class ExampleClass : MonoBehaviour
{
    // Physics sorguları ile ilgili FixedUpdate() ve Update() hakkında bilgi için Olay
    // Fonksiyonlarının Yürütme Sırası sayfasına bakınız
    void FixedUpdate()
    {
        // Katmanın (8) indeksini bir bit maskesi almak için sağa kaydırın
        int layerMask = 1 << 8;

        // Bu, sadece 8. katmandaki collider'larla ışınlar atar.
        // Ancak bunun yerine, 8. katmandaki her şeyle çarpışmak istiyoruz. ~ operatörü bunu
        // yapar, bir bit maskesini tersine çevirir.
        layerMask = ~layerMask;

        RaycastHit hit;
        // Işın, oyuncu katmanını hariç tutarak herhangi bir nesneyle kesişirse
        if (Physics.Raycast(transform.position, transform.TransformDirection(Vector3.forward),
            out hit, Mathf.Infinity, layerMask))
        {
            Debug.DrawRay(transform.position,
            transform.TransformDirection(Vector3.forward) * hit.distance, Color.yellow);
            Debug.Log("Did Hit");
        }
        else
        {
            Debug.DrawRay(transform.position,
            transform.TransformDirection(Vector3.forward) * 1000, Color.white);
            Debug.Log("Did not Hit");
        }
    }
}


Bu örnek, nesnenin mevcut pozisyonundan ileriye doğru 10 birim uzanan basit bir Raycast oluşturur.

using UnityEngine;

public class ExampleClass : MonoBehaviour
{
    // Physics sorguları ile ilgili FixedUpdate() ve Update() hakkında bilgi için Olay
    // Fonksiyonlarının Yürütme Sırası sayfasına bakınız
    void FixedUpdate()
    {
        Vector3 fwd = transform.TransformDirection(Vector3.forward);

        if (Physics.Raycast(transform.position, fwd, 10))
            print("There is something in front of the object!");
    }
}


Deklarasyon
public static bool Raycast(Vector3 origin, Vector3 direction, out RaycastHit hitInfo, float maxDistance, int layerMask, QueryTriggerInteraction queryTriggerInteraction);

Parametreler
originIşının dünya koordinatlarındaki başlangıç noktası.
directionIşının yönü.
hitInfoEğer true dönerse, hitInfo en yakın collider'ın nerede vurulduğu hakkında daha fazla bilgi içerecektir. (Ek kaynaklar: RaycastHit).
maxDistanceIşının çarpışmaları kontrol etmek için maksimum mesafesi.
layerMaskBir ışın fırlatılırken Collider'ları seçmeli olarak yoksaymak için kullanılan bir Layer mask.
queryTriggerInteractionBu sorgunun Trigger'ları vurup vurmayacağını belirtir.

Dönüş Değeri
bool Eğer ışın bir Collider ile kesişiyorsa true, aksi halde false döner.

Açıklama
Sahnedeki tüm collider'lara karşı bir ışın fırlatır ve vurulan şeyle ilgili detaylı bilgi döndürür.

Bu örnek, mevcut nesne ile rapor edilen Collider arasındaki mesafeyi bildirir:

using UnityEngine;

public class RaycastExample : MonoBehaviour
{
    // Physics sorguları ile ilgili FixedUpdate() ve Update() hakkında bilgi için Olay
    // Fonksiyonlarının Yürütme Sırası sayfasına bakınız
    void FixedUpdate()
    {
        RaycastHit hit;

        if (Physics.Raycast(transform.position, -Vector3.up, out hit))
            print("Found an object - mesafe: " + hit.distance);
    }
}


Bu örnek, Ray'ı ne kadar uzağa fırlatılacağını sınırlamak için maxDistance parametresini tekrar tanıtır:

using UnityEngine;

public class RaycastExample : MonoBehaviour
{
    // Physics sorguları ile ilgili FixedUpdate() ve Update() hakkında bilgi için Olay
    // Fonksiyonlarının Yürütme Sırası sayfasına bakınız
    void FixedUpdate()
    {
        RaycastHit hit;

        if (Physics.Raycast(transform.position, -Vector3.up, out hit, 100.0f))
            print("Found an object - mesafe: " + hit.distance);
    }
}


Deklarasyon
public static bool Raycast(Ray ray, float maxDistance = Mathf.Infinity, int layerMask = DefaultRaycastLayers, QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.UseGlobal);

Parametreler
rayIşının başlama noktası ve yönü.
maxDistanceIşının çarpışmaları kontrol etmek için maksimum mesafesi.
layerMaskBir ışın fırlatılırken Collider'ları seçmeli olarak yoksaymak için kullanılan bir Layer mask.
queryTriggerInteractionBu sorgunun Trigger'ları vurup vurmayacağını belirtir.

Dönüş Değeri
bool Eğer ışın bir Collider ile kesişiyorsa true, aksi halde false döner.

Açıklama
Yukarıdakiyle aynı, ancak origin ve direction kullanmak yerine ray.origin ve ray.direction kullanılır.

using UnityEngine;

public class ExampleClass : MonoBehaviour
{
    // Physics sorguları ile ilgili FixedUpdate() ve Update() hakkında bilgi için Olay
    // Fonksiyonlarının Yürütme Sırası sayfasına bakınız
    void FixedUpdate()
    {
        Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
        if (Physics.Raycast(ray, 100))
            print("Hit something!");
    }
}


Deklarasyon
public static bool Raycast(Ray ray, out RaycastHit hitInfo, float maxDistance = Mathf.Infinity, int layerMask = DefaultRaycastLayers, QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.UseGlobal);

Parametreler
rayIşının başlama noktası ve yönü.
hitInfoEğer true dönerse, hitInfo en yakın collider'ın nerede vurulduğu hakkında daha fazla bilgi içerecektir. (Ek kaynaklar: RaycastHit).
maxDistanceIşının çarpışmaları kontrol etmek için maksimum mesafesi.
layerMaskBir ışın fırlatılırken Collider'ları seçmeli olarak yoksaymak için kullanılan bir Layer mask.
queryTriggerInteractionBu sorgunun Trigger'ları vurup vurmayacağını belirtir.

Dönüş Değeri
bool Eğer ışın bir Collider ile kesişiyorsa true, aksi halde false döner.

Açıklama
Yukarıdakiyle aynı, ancak origin ve direction kullanmak yerine ray.origin ve ray.direction kullanılır.
Bu örnek, bir çarpışma algılandığında Işın boyunca bir çizgi çizer:

using UnityEngine;

public class ExampleClass : MonoBehaviour
{
    // Physics sorguları ile ilgili FixedUpdate() ve Update() hakkında bilgi için Olay
    // Fonksiyonlarının Yürütme Sırası sayfasına bakınız
    void FixedUpdate()
    {
        Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
        RaycastHit hit;

        if (Physics.Raycast(ray, out hit, 100))
            Debug.DrawLine(ray.origin, hit.point);
    }
}


Bu blog Unity Docs'un Türkçeye çevrilmiş halidir.

Yorumlar

Yorum Gönder

Bu blogdaki popüler yayınlar

Important Classes - Vectors

Resim
Vektörler, bir yön ve büyüklüğü tanımlamanıza olanak tanıyan temel bir matematiksel kavramdır. Oyunlar ve uygulamalarda, vektörler genellikle bir karakterin konumu, bir nesnenin hareket hızı veya iki nesne arasındaki mesafe gibi temel özellikleri tanımlamak için kullanılır. Vektör aritmetiği, grafik, fizik ve animasyon gibi bilgisayar programlamasının birçok yönü için temeldir ve Unity'den en iyi şekilde yararlanmak için derinlemesine anlamak faydalıdır. Vektörler, çok boyutlu olarak ifade edilebilir ve Unity, 2D, 3D ve 4D vektörlerle çalışmak için Vector2, Vector3 ve Vector4 sınıflarını sağlar. Bu üç tür Vektör sınıfı, büyüklük gibi, birçok aynı fonksiyonu paylaşır, bu nedenle aksi belirtilmedikçe bu sayfadaki bilgilerin çoğu tüm vektör türleri için geçerlidir. Bu sayfa, Vektör sınıflarının genel bir bakışını ve onlarla komut dosyası yazarken yaygın kullanım alanlarını sunar. Vektör sınıflarının her üyesi için kapsamlı bir referans için Vector2 , Vector3 ve Vector4 'ün komut ...
Daha fazla oku »

RequireComponent

class in UnityEngine / Implemented in: UnityEngine.CoreModule Açıklama RequireComponent niteliği, gerekli bileşenleri otomatik olarak bağımlılık olarak ekler. RequireComponent kullanan bir komut dosyasını bir GameObject'e eklediğinizde, gerekli bileşen otomatik olarak GameObject'e eklenir. Bu, kurulum hatalarını önlemek için faydalıdır. Örneğin, bir komut dosyası her zaman aynı GameObject'e bir Rigidbody eklenmesini gerektirebilir. RequireComponent kullandığınızda, bu otomatik olarak yapılır, bu nedenle kurulum hatası yapma olasılığınız düşer. Not: RequireComponent, yalnızca GameObject.AddComponent çağrıldığında eksik bağımlılıkları kontrol eder. Bu, hem Editörde hem de çalışma zamanında gerçekleşir. Unity, yeni bağımlılıkları eksik olan GameObject'lere otomatik olarak eklemez. using UnityEngine; // PlayerScript, GameObject'in bir Rigidbody bileşenine sahip olmasını gerektirir [RequireComponent(typeof(Rigidbody))] public class PlayerScript : MonoBehaviour { ...
Daha fazla oku »

Important Classes - GameObject

Resim
Unity'nin GameObject sınıfı, Sahne'de var olabilen her şeyi temsil eder. Bu sayfa, Unity'nin GameObject sınıfıyla kod yazımı ile ilgilidir. Sahne ve Hiyerarşi kullanımı hakkında daha fazla bilgi için Unity Editörü'ndeki GameObject bölümünü kullanıcı kılavuzunda inceleyebilirsiniz. GameObject sınıfının her üyesinin ayrıntılı referansı için GameObject komut dosyası referansına bakınız. GameObject'ler, Unity'de sahnelerin yapı taşlarıdır ve GameObject'un nasıl göründüğünü ve ne yaptığını belirleyen işlevsel bileşenleri için bir konteyner olarak hareket ederler. Kod yazımında, GameObject sınıfı size kodunuzda onlarla çalışmanıza olanak sağlayan bir dizi metod sunar. Bu metodlar arasında GameObject'ler arasında bulma, bağlantılar kurma ve mesajlar gönderme, GameObject'lere eklenen bileşenleri ekleme veya kaldırma ve sahnede durumlarıyla ilgili değerleri ayarlama gibi işlemler yer alır. Sahne Durumu Özellikleri Sahnedeki bir GameObject'in duru...
Daha fazla oku »