Hata Ayıklama Çizimi ile Oyununun Hatalarını Ayıklama

Oyununun hatalarını ayıklamaya yardımcı olması için test amacıyla bazı oyun verilerini oyuncudan gizleyip sadece kendin görecek şekilde görüntüleyebilirsin. Bunu yapmanın bir yolu günlüğe kaydetmektir ancak Hata Ayıklama Çizimi API’si ile bazı oyun verilerini daha iyi görülebilecek şekilde gösterebilirsin.

Hata Ayıklama Çizimi API’ını kullanarak basit şekiller çizebilir ve bu şekillerin konumunu, boyutunu, rengini ve ekranda görünme süresini ayarlayabilirsin. Örneğin, oyuncu olmayan bir karakterin görünürlük menzilini veya kaynak noktasından sesin duyulabileceği uzaklığı görselleştirmek isteyebilirsin. Kutu hata ayıklama şeklini kullanarak, herhangi bir etki aktörüyle eşleşen boyutları ve konumu içeren bir kutu çizebilirsin. Bunu, söz konusu etki aktörü oyununda görünmez olduğunda bile yapabilirsin. Bunu yapmak belirli efektlerle etki aktörlerinin yerleşimini anlamaya yardımcı olabilir.

Hata ayıklama amacıyla oyuncu olmayan bir karakterin yüzünden görünürlük menzilinin sınırına kadar çizilen ok şekli, muhafızların yerleşimini kusursuz bir şekilde tasarlamak için kullanılabilir.

Verse Hata Ayıklama Çizimini Etkinleştir

Öncelikle çizdiğin şekilleri görebildiğinden emin olman gerekir.

1. UEFN Anahat Düzenleyicisi’nde Ada Ayarları’nı seç.

2. Ayrıntılar paneli arama çubuğuna hata ayıkla yaz. Sonuçlar Kullanıcı Seçenekleri - Hata Ayıklama kategorisiyle filtrelenir.

3. Hata Ayıklama ve ardından Verse Hata Ayıklama Çizimi bölümlerine tıklayarak Hata Ayıklama özelliklerini ve Verse Hata Ayıklama Çizimini etkinleştir.

Verse Hata Ayıklama Çizimi yalnızca bir UEFN oyun oturumu sırasında etkin olur. Her kullanıcı için ayrıca etkindir. Yani yalnızca Hata Ayıklama ve Verse Hata Ayıklama Çizimini etkinleştirmiş olan kullanıcılar hata ayıklama şekillerini görür. Hata ayıklama şekilleri, Ada Ayarlarında bu seçenek işaretlenmiş olsa bile UEFN görünüm penceresinde veya yayınlanmış bir adada görünmez.

İlk Hata Ayıklama Şeklini Çiz

Hata Ayıklama Çizimi API’ı ile ilk şeklini çizmek için aşağıdaki adımları izle.

1. Bu içe aktarma ifadesini Verse dosyana ekle.

   Verse

   using { /UnrealEngine.com/Temporary/Diagnostics }

   Copy full snippet(1 line long)

2. Debug_draw_channel türünden devralan bir alt sınıf tanımlayarak bir kanal oluştur. Kanallar ilgili şekilleri bir arada gruplandırmak içindir. Kanallar isteğe bağlıdır ancak kullanılması yararlı bir uygulamadır. Hata Ayıklama Çizimi API’sinde birçok şekli aynı anda göstermek, gizlemek veya temizlemek için kullanabileceğin fonksiyonlar bulunur. Gösterme ve gizleme fonksiyonları ise yalnızca kanal düzeyinde çalışır.

   Verse

   my_debug_draw := class(debug_draw_channel) {}

   Copy full snippet(1 line long)

3. Debug_draw türünde yeni bir sabit bildir. Bu sabit, şekilleri çizme metotlarını çağırmak üzere kullanacağın objedir. Bu örnekte Kanal parametresinin (önceki adımda oluşturulan) kullanımı gösterilir ancak bu isteğe bağlıdır.

   Verse

   DebugDraw:debug_draw = debug_draw{Channel := my_debug_draw}

   Copy full snippet(1 line long)

4. DrawSphere metodunu çağır. Bu örnekte iki parametre kullanılır.

• Center:= vector3{Z:= 150.0}: vector3 türündeki bu zorunlu parametre, küre merkezinin konumunu belirler. Bu örnekte bir değişmez değer oluşturmak için vector3 türünde bir oluşturucu kullanacaksın. Bu işlem, kürenin merkezini 0.0, 0.0, 150.0 konumuna ayarlar.

• ?DrawDurationPolicy:= debug_draw_duration_policy.Persistent: Bu parametre isteğe bağlıdır ancak varsayılan değeri, birkaç saniye sonra kürenin kaybolmasına neden olur. Bu yüzden bu seçeneği kalıcı ilke olarak ayarlamalısın. Bu ayar, kürenin gizlenene veya başka kodla temizlenene kadar adada görünür kalacağı anlamına gelir.

  Verse

  DebugDraw.DrawSphere(Center := vector3{Z:=150.0}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

  Copy full snippet(1 line long)

Verse kodunu derleyip bir oturum başlattıktan sonra Center parametresi ile ayarlanan konumda bir küre görmen gerekir.

Şekiller

Hata Ayıklama Çizimi API’ıyla, çalışan bir UEFN oturumunda basit şemalar halinde görünen birden fazla şekil oluşturabilirsin. Her şekil farklı senaryolarda kullanışlıdır. Aşağıdaki bölümlerde her bir şeklin nasıl çizileceği ve her yönteme özgü parametreler açıklanmıştır. Her yöntem için ortak olan parametreler daha sonraki bir bölümde açıklanacaktır. Bu bölümdeki her kod örneği, kodu İlk Hata Ayıklama Şeklini Çiz bölümünden Verse dosyana eklediğini varsayar.

Kutu

Bir küp çizmek için DrawBox() metodunu kullan.

DebugDraw.DrawBox(vector3{Z:=150.0}, rotation{}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Kapsül

Bir kapsül çizmek için DrawCapsule() metodunu kullan. Kapsül, her iki ucunda bir kürenin yarısı bulunan bir silindirden oluşur.

DebugDraw.DrawCapsule(vector3{Z:=200.0}, rotation{}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Küre

Bir küre çizmek için DrawSphere() metodunu kullan.

DebugDraw.DrawSphere(vector3{Z:=150.0}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Koni

Bir koni çizmek için DrawCone() metodunu kullan.

DebugDraw.DrawCone(vector3{Z:=150.0}, vector3{Z:=-1.0}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Silindir

Bir silindir çizmek için DrawCylinder() metodunu kullan.

DebugDraw.DrawCylinder(vector3{Z:=100.0}, vector3{Z:=200.0}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Çizgi

Bir çizgi çizmek için DrawLine() metodunu kullan.

DebugDraw.DrawLine(vector3{Z:=100.0}, vector3{Z:=200.0}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Ok

Bir ok çizmek için DrawArrow() metodunu kullan.

DebugDraw.DrawArrow(vector3{Z:=100.0}, vector3{Z:=200.0}, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Nokta

Bir nokta çizmek için DrawPoint() metodunu kullan.

DebugDraw.DrawPoint(vector3{Z:=200.0}, ?Thickness:= 10.0, ?DrawDurationPolicy := debug_draw_duration_policy.Persistent)

Yaygın Parametreler

Bu parametreler tüm şekil çizme yöntemleri için ortaktır. Aynı zamanda bunların hepsi isteğe bağlıdır ve bir yöntem çağrılırken bağımsız değişken olarak dahil edilmesi gerekmez. Bu parametreleri dahil etmeyi seçersen parametre adının başına ? ekleyerek kullandığından emin ol. Adlandırılmış ve isteğe bağlı bağımsız değişkenler hakkında daha fazla bilgi almak için Fonksiyonların İçinde Fonksiyon Çağırma bölümüne bak.

Renk

Şekillerin rengini ayarlamak için Color parametresini kullan. Değerler color türünde olmalıdır. Geçerli renklerin listesini NamedColors modülü bölümünde bulabilirsin. Verse dosyanın en üst kısmında Colors modülü için içe aktarma ifadesinin bulunduğundan emin ol. Aşağıda bir noktayı farklı bir renge ayarlama örneği verilmiştir.

DebugDraw.DrawPoint(Position := vector3{Z:= 200.0}, ?Thickness := 20.0, ?Color := NamedColors.MediumSeaGreen)

DrawDurationPolicy

DrawDurationPolicy bir hata ayıklama şeklinin ekranda ne kadar süreyle kalacağını belirler. Üç olası değeri vardır.

• SingleFrame: Şekil, ekranda tek bir kare boyunca kalır. Bu ilke, bir şekli sıklıkla yeniden çizmek istediğinde kullanışlı olabilir.

• FiniteDuration: Bu ilke, bir şekli belirli saniyeler boyunca göstermek için Duration parametresiyle birlikte kullanılır.

• Persistent: Persistent ilkesinde şekil, gizlenene veya başka bir kodla temizlenene kadar ekranda kalır.

Duration

Duration parametresi, bir şekli belirli saniyeler boyunca göstermek için FiniteDuration ilkesiyle birlikte kullanılır. Aşağıda, 30 saniye boyunca gösterilecek bir küre çizen kodun örneği verilmiştir.

DebugDraw.DrawSphere(vector3{}, ?DrawDurationPolicy := debug_draw_duration_policy.FiniteDuration, ?Duration := 30.0)

Thickness

Thickness parametresi, her bir hata ayıklama şeklini oluşturan çizgilerin kalınlığını ayarlar. DrawPoint() örneğinde tek noktanın kalınlığını ayarlar.

Channel

Kanalları kullanarak ilgili şekilleri bir arada gruplandırabilir, sonra bir kanaldaki tüm şekilleri aynı anda gizleyebilir, gösterebilir veya temizleyebilirsin.

Kanal oluşturmak için bir debug_draw örneğini tanımlarken Channel parametresini kullan.

DebugDraw:debug_draw = debug_draw{Channel := debug_draw_defaults}

Artık DebugDraw örneğini kullanırken çizdiğin her şekil tek bir metotla gizlenebilir, gösterilebilir veya temizlenebilir. Örneğin; DebugDraw örneğiyle bir nokta, küre ve ok çizersen bu şekilleri bir süre boyunca gizleyebilir, sonra tekrar gösterebilir ve sonunda artık ihtiyacın kalmadığında temizleyebilirsin.

# Point
DebugDraw.DrawPoint(vector3{Z := 200.0}, ?Thickness:= 50.0, ?DrawDurationPolicy:= debug_draw_duration_policy.Persistent)

# Sphere
DebugDraw.DrawSphere(vector3{Z := 200.0}, ?DrawDurationPolicy:= debug_draw_duration_policy.Persistent)

# Arrow
DebugDraw.DrawArrow(vector3{Z := 200.0}, vector3{Z := 400.0}, ?DrawDurationPolicy:= debug_draw_duration_policy.Persistent)

Sleep(5.0)

Varsayılan Parametre Değerleri

Örnekler

Bir Ses Çalar Cihazının Menzilini Görselleştirme

Ses Çalar Cihazı, kendi zayıflamasını görselleştiren bir ayara sahiptir. Ancak bu görselleştirmeyi yalnızca düzenleme modunda görebilirsin. Bir oyun oturumunda zayıflama görsellerini yeniden oluşturma hakkında bilgi edinmek için aşağıdaki adımları izle.

1. Bir Ses Çalar Cihazını bölümüne sürükle. Ayrıntılar panelinde Zayıflama Görsellerini Etkinleştir seçeneğinin işaretli olduğundan emin ol. Bu seçeneğin işaretli olması, görselleri hata ayıklama şekilleriyle doğru biçimde yeniden oluşturduğunu doğrulamaya yardımcı olur.

2. Verse dosyanda DebugDrawAudio adlı yeni bir debug_draw oluştur. Bu örneğe debug_draw_audio adıyla bir kanal ver.

   Verse

   DebugDrawAudio:debug_draw = debug_draw{Channel := debug_draw_audio}

   Copy full snippet(1 line long)

3. Float türünde iki @editable sabit ekle. Sabitlere DebugAttenuationMinDistance ve DebugAttenuationFalloffDistance adlarını ver. Bu sabitler, Ses Çalar Cihazının zayıflamasını görselleştirmek için çizilen kürelerin yarıçapları olacaktır.

   Verse

   @editable
        DebugAttenuationMinDistance:float = 100.0
   		
        @editable
        DebugAttenuationFalloffDistance:float = 100.0

   Copy full snippet(5 lines long)

4. Ses Çalar cihazını temsil edecek başka bir @editable sabiti ekle. Adını AudioPlayerDevice olarak belirle.

   Verse

   @editable
        AudioPlayerDevice:audio_player_device = audio_player_device{}

   Copy full snippet(2 lines long)

5. DrawAudioDeviceRange() adlı bir fonksiyon tanımla ve bu fonksiyona float türünde iki parametre ver: AttenuationMinDistance ve AttenuationFalloffDistance.

   Verse

   DrawAudioDeviceRange(AttenuationMinDistance:float, AttenuationFalloffDistance:float):void =

   Copy full snippet(1 line long)

6. Yeni fonksiyonda Ses Çalar Cihazının Dönüşüm objesini al.

   Verse

   AudioPlayerDeviceTransform:= AudioPlayerDevice.GetTransform()

   Copy full snippet(1 line long)

7. Hata Ayıklama Çizimi API’sindeki DrawSphere fonksiyonunu kullanarak Zayıflama Minimum Mesafesini ve Zayıflama Azalma Mesafesini temsil edecek iki küre çiz. Zayıflama yalnızca Zayıflama Minimum Mesafesinin yarıçapının dışında kalan alanda başladığından ikinci DrawSphere çağrısındaki Radius değeri, AttenuationMinDistance ile AttenuationFalloffDistance değerlerinin toplamına ayarlanmalıdır.

   Verse

   DebugDrawAudio.DrawSphere(
            AudioPlayerDeviceTransform.Translation,
            ?Radius:= AttenuationMinDistance,
            ?DrawDurationPolicy:= debug_draw_duration_policy.Persistent)
        DebugDrawAudio.DrawSphere(
            AudioPlayerDeviceTransform.Translation,
            ?Radius:= AttenuationMinDistance + AttenuationFalloffDistance,
            ?DrawDurationPolicy:= debug_draw_duration_policy.Persistent)

   Copy full snippet(8 lines long)

8. Verse dosyanın OnBegin() fonksiyonunda DrawAudioDeviceRange() fonksiyonunu çağır.

   Verse

   OnBegin<override>()<suspends>:void=
        DrawAudioDeviceRange(DebugAttenuationMinDistance, DebugAttenuationFalloffDistance)

   Copy full snippet(2 lines long)

9. Verse kodunu oluştur. Verse cihazının Ayrıntılar panelinde DebugAttenuationMinDistance ve DebugAttenuationFalloffDistance değerlerini ayarladığından emin ol. Bu değerler Ses Çalar cihazının Zayıflama Minimum Mesafesi ile Zayıflama FalloffDistance değerlerinin 100 ile çarpımına eşit olmalıdır.

   Ses Çalar Cihazı, Zayıflama Minimum Mesafesi ile Zayıflama Azalma Mesafesi için metre birimi kullanır. Hata Ayıklama Çizimi API’ında santimetre kullanıldığından değerleri dönüştürmen gerekir.

10. Tam Kod

    Verse

    using { /Fortnite.com/Devices }
         using { /Fortnite.com/Characters }
         using { /Fortnite.com/Playspaces }
         using { /UnrealEngine.com/Temporary/Diagnostics }
         using { /UnrealEngine.com/Temporary/SpatialMath }
    		
         debug_audio_device := class(creative_device):
    		
             @editable
             AudioPlayerDevice:audio_player_device = audio_player_device{}
    
    Expand code Copy full snippet(33 lines long)