Site icon Karadot Games

DOTween Doküman Türkçeleştirmesi

Muhammed Ali Kum
DOTween Dökuman Türkçeleştirmesi

DOTween Dökuman Türkçeleştirmesi

Merhabalar dostlar, bu yazıda halihazırda ingilizce halde bulunan DOTween Doküman Türkçeleştirmesi işlemini gerçekleştirip, yerli oyun geliştiricilerimiz için kullanmını daha kolay hale ve anlaşılır hale getireceğiz. Bilmeyenler için DoTween eklentisi  hakkında konuşmak gerekirse, Unity içerisinde bulunan, özel bileşenlerden tutun, float,int gibi temel tipteki değişkenlerdeki değerleri, istediğimiz değerlere istediğimiz sürede eşitliyor diye özetlemek sanırım yeterli olacaktır. Video olarak anlatımı sevenleriniz için de yaptığımız örnek videoların bırakıyorum. Ayrıca isterseniz şuradan orjinal dilde doküman incelemeniz de mümkün.

Öncelikle, tamamında Türkçe çeviri yapmayacağım için, bazı özel anahtar kelimeleri anlamanızı istiyorum. Başta bunları belirtip daha sonrasında yola devam etmek daha mantıklı olacak. Tween kelimesi, ingilizce derslerinden bildiğimiz “between” kelimesinden de aşina olacağınız şekilde “ara, arada” anlamlarına geliyor. Temel olarak değerlerimize belirli bir “aralık” vererek bunları değiştirmemize yardımcı olan bir yapı olarak karşımıza çıkıyor bu eklenti içerisinde. 

Tween kelimesi aslında eklenti içerisinde kullanabileceğimiz yapılara verebileceğimiz genel bir isim. Eklenti içerisinde yaratabileceğimi Tween tipleri ise Tweener, Sequence olarak ikiye ayırabiliriz. Bir de Nested Tween dediğimiz bir yapı var ki, bu da aslında bir Sequence içerisinde bulunan bir tweeni adlandırmak için kullandığımız bir şey.

DOTween Ön-Ekler

Ayrıca, kodlama kısmında da bazı şeylerden bahsetmek istiyorum. Prefixes olarak geçen kelimeler, DOTween ön-ekler olarak da adlandırabiliriz, kodlama konusunda bize rahatlık sağlayacak şeyler. 3 Adet bulunuyor, bunlar DO, Set, On kelimeleridir.

DOTween Başlatma

Normal şartlarda, DOTween Başlatma işlemini eklentinin kendisi otomatik olarak gerçekleştiriyor. Ancak temel ayarlardan memnun olmayabilirsiniz. Bu aşamada DOTween.Init() fonksiyonunu kullarak istediğiniz ayarları değiştirebilirsiniz. Bu Fonksiyonun alacağı 3 değişken bulunuyor.

//Örnek başlatma komutu.
DOTween.Init(true, true, LogBehaviour.Verbose);

DOTween Tweener

Şimdi öncelikle Tweener yapısından bahsedelim. Tweener, tek başına sadece 1 değişken kontrol ettiğimiz değişken tipi. Dokümanın devamında görebileceğiniz gibi, istediğimiz değişikliği aslında bir değişken gibi tutup, sonrasında tekrar tekrar bu değişkeni kullanarak değişiklikleri yapabileceğiz. 

// 2,2,2 pozisyona 2 saniyede gitmemizi sağlayan
//bir tweener nesnesi yaratıyoruz ve bunu değişkene atıyoruz.
Tween myTween = transform.DOMove(new Vector3(2,2,2), 2);

Tweener Fonksiyonları

Tweener Fonksiyonlarını 3 başlığa ayırabiliriz. Bunlar Genel, Kısayol Fonksiyonlar ve Ekstra Genel fonksiyonlardır. 

Genel Fonksiyon: static DOTween.To(getter, setter , verilecekDeger, float sure). Bu fonksiyan, içerisine verdiğini herhangi bir değişkenin değerini verdiğini süre içerisinde istediğiniz değere getirir. Ayrıca sonunda From() eklerseniz, verdiğiniz değeri başlangıç değeri olarak alıp, şu anda sahip olduğu değere gelmesini sağlar. Bir nevi işlemi tersten yapar.

// vektorDegiskeni isimli değişken değerini        
 DOTween.To (() => vectorDegiskeni, x => vectorDegiskeni = x, new Vector3 (3, 4, 8), 3);
//From ekleyerek işlemi geri doğru yaptırıyoruz.
 DOTween.To (() => vectorDegiskeni, x => vectorDegiskeni = x, new Vector3 (3, 4, 8), 3).From ();

Kısayol Fonksiyonları: Bu fonksiyonlar, Unity özel bileşenlerine DOTWeen eklentisi aracılığıyla eklenen ekstra fonksiyonlardır. Bu sayede direkt bileşen ya da değişken üzerinden değişiklik yapabilirsiniz.

// Transform Bileşeni Örnek kullanım
transform.DOMove (new Vector3 (15, 0, 3), 3);
//Sprite Renderer Örnek kullanımı
spriteRenderer.DOColor (Color.green, 3);

Örnek kullanımlardan göreceğiniz üzere, aşağıda listeleyeceğimiz bileşen tiplerindeki değişkenlerinizde, sonuna “.” koyup yazarak çağırabilirsiniz.

Ses Karıştırıcı (AudioMixer):

Ses Kaynağı (AudioSource):

Kamera(Camera):

Işık(Light):

LineRenderer: 

myLineRenderer.DOColor(new Color2(Color.white,Color.white), new Color2(Color.green, Color.black),1);

Materyal (Material):

Rigidbody: Bu kısayollar rigidbody bileşenin MovePosition ve MoveRotation metotlarını arkaplanda kullanarak fizik objeleriyle bağlantılı nesneleri doğru şekilde hareket ettirirler.

Rigidbody2d: Bu kısayollar fizik objelerini düzgün şekilde hareket ettirmek için arkaplanda rigidbody2d bileşeninin MovePosition/MoveRotation methodlarını kullanır.

SpriteRenderer:

TrailRenderer: 

Transform:

Tween : Evet, tween objelerini de tween ettirebiliyoruz. Açıkçası dokümanı okuyup çevirirken ben beklemiyordum haha. Sadece tek bir fonksiyon kullanabiliyoruz.

DOTween Sequence ve Fonksiyonları

Sequence tipi de aslında Tweener objesine benzer şekilde, ancak içerisinde bir sürü tweener bulunuyor. Yani istediğimiz değişiklikleri grup halinde tutup, ister arka arkaya ister eş zamanlı olarak değiştirebiliyoruz.

// Boş halde bir Sequence nesnesi yaratıyoruz
Sequence mySequence = DOTween.Sequence();
//X ekseninde 45 konumuna 1 saniyede gitmesi için bir tween ekliyoruz.
mySequence.Append(transform.DOMoveX(45, 1));
//Y ekseninde 180 dereceyi 1 saniyede dönmesi için bir tween ekliyoruz.
mySequence.Append(transform.DORotate(new Vector3(0,180,0), 1));
// Şu anki haliyle eklediğimiz tween nesneleri sırayla çalışacaktır. İstersek aynı anda çalışmalarını da sağlayabiliriz.

Sequence Fonksiyonları

Evet, böylece DOTween Doküman Türkçeleştirmesi işinin çoğunluğunu halletmiş olduk. Bazı kısımlar hâlâ eksik farkındayım ama çok uzun bir yazı oldu bu. Onları da ayrı bir yazı içerisinde oluşturabilirim ya da bu yazıyı zamanla güncelleyip buraya ekleyebilirim. Açıkçası hiçbir fikrim yok göreceğiz.

Exit mobile version