# Unreal Engine’de USD Stage kullanımı: sahne açma ve düzenleme rehberi

Kaynak: https://3dsinifi.com/haber/unreal-enginede-usd-stage-kullanimi-sahne-acma-ve-duzenleme · Kategori: Eğitimler · Yayın: 6 Kasım 2026

> Unreal Engine’in USD Stage iş akışı, USD sahnelerini hiyerarşileriyle açıp düzenlemeye olanak tanıyor. Bu rehber; eklenti kurulumunu, prim ve referans yönetimini, kaydetme ve içe aktarma adımlarını anlatıyor.

## Kısaca
- USD Importer eklentisi etkinleştirildikten sonra USD Stage penceresi Level Editor içinden açılıyor.
- USD Stage Actor, açılan USD dosyasını Unreal Engine Level’ındaki çalışma sahnesine bağlıyor.
- Prim ekleme, referans verme ve değişiklikleri USD dosyasına kaydetme işlemleri USD Stage Editor’dan yapılabiliyor.
- Unreal Engine belgeleri USD Stage özelliğini beta olarak işaretliyor ve yayınlanan projelerde dikkatli kullanılmasını öneriyor.

## Bu rehberde neler öğreneceksiniz?

Universal Scene Description (USD), farklı 3D uygulamalarındaki sahne verilerini düzenlemek ve aktarmak için kullanılan açık kaynaklı bir değişim formatıdır. Unreal Engine’de USD Stage iş akışı, dosyayı hemen yerel statik mesh ve materyallere dönüştürmeden sahne hiyerarşisini görüntülemeye ve düzenlemeye imkân verir. Bu rehberde USD Stage’i açmayı, bir primin özelliklerini değiştirmeyi, başka bir USD dosyasına referans eklemeyi, çalışmayı kaydetmeyi ve içeriği Unreal Engine projesine aktarmayı ele alıyoruz.

Bu yaklaşım özellikle birden fazla uygulama arasında çalışan mimarlık ve görselleştirme ekipleri için sahne yapısını incelemeyi kolaylaştırabilir. Ancak iş akışının beta olarak tanımlandığı, bazı veri türlerinin uygulamalar arasında aynı biçimde taşınmayabileceği ve ışık haritaları konusunda ayrıca kontrol gerektiği unutulmamalı.

## Gereksinimler ve hazırlık

Epic’in kılavuzu belirli bir Unreal Engine sürüm numarası veya kullanıcı hesabı şartı belirtmiyor. Kurulum için belgelenen temel ön koşul, projede **USD Importer** eklentisinin etkinleştirilmesi. Eklenti etkinleştirildikten sonra editörün yeniden başlatılması gerekiyor. Kaynak USD dosyası olarak `.usd`, `.usda`, `.usdc` ve `.usdz` biçimleri destekleniyor.

Başlamadan önce kullanılması planlanan USD dosyasının ve bağlı varlıklarının erişilebilir olduğundan emin olun. Çok kullanıcılı çalışma yapılacaksa ekip üyelerinin aynı USD dosyalarına aynı dosya yoluyla erişmesi gerekiyor; Epic, dosyaların proje klasöründe tutulup kaynak kontrolüyle yönetilmesini öneriyor.

Blender ile dosya alışverişi de düşünülüyorsa içe aktarma kapsamını baştan değerlendirin. Blender’ın USD içe aktarıcısı kamera, eğri, ışık, materyal, mesh, nokta bulutu ve hacim gibi verileri destekliyor; ancak USD kompozisyonundaki bazı katman ve referans kavramlarını henüz işlemiyor. Bu nedenle bir uygulamada görünen her sahne yapısının diğerinde eksiksiz karşılığının oluşacağı varsayılmamalı.

## Unreal Engine’de USD Stage’i açma ve düzenleme

1. **Eklentiyi etkinleştirin.** Unreal Editor’da Plugins menüsünden USD Importer eklentisini açın ve editörü yeniden başlatın. Sonrasında Level Editor’da `Window > Virtual Production > USD Stage` seçeneği görünür.

2. **USD dosyasını yükleyin.** USD Stage panelinde `File > Open` yolunu izleyip dosyanızı seçin. Dosyanın prim hiyerarşisi panelde listelenir. Açılan USD içeriği Level’a bağlandığında Unreal Engine bir USD Stage Actor oluşturur; bu Actor, USD verisinin sahne içindeki temsilini yönetir.

3. **Sahne yapısını inceleyin.** USD Stage penceresindeki Hierarchy alanından primleri seçin; Properties alanında seçili öğenin özelliklerini görüntüleyin. Örneğin `upAxis` özelliği sahnenin yukarı yönünü belirler. Bir primde `modelingVariant` varsa, bu alandan mevcut varyant değiştirilebilir. Varyant seçeneğinin görünmesi, ilgili varlığın bir veya daha fazla varyanta sahip olmasına bağlıdır.

4. **Yeni prim ve referans ekleyin.** Hiyerarşide uygun bir öğeye sağ tıklayıp `Add Prim` ile yeni prim oluşturun. Ardından bu prim üzerinde sağ tıklayarak `Add Reference` seçeneğini kullanın ve referans verilecek USD dosyasını belirleyin. Referansın hedef dosyadaki varsayılan prim mi, yoksa belirli bir prim yolu mu olacağını seçebilirsiniz. Yeni öğenin konumu için sahnedeki transform araçları kullanılabilir.

5. **Değişiklikleri kaydedin.** USD Stage panelinde `File > Save` komutunu kullanın. Bu komut, Stage üzerinde yaptığınız düzenlemeleri kaynak USD dosyasına aktarır. Önemli sahnelerde, ekip akışına uygun yedekleme ve dosya yönetimi uygulamalarını kullanmak yerinde olur.

6. **İçeriği projeye aktarın.** Sahneyi Unreal Engine varlıklarına dönüştürmeniz gerektiğinde USD Stage Editor içindeki `Action > Import` seçeneğini kullanabilirsiniz. Bu yöntem hem varlıkları hem Actor’ları içe aktarır ve Stage’deki öğeler içerik tarayıcısından oluşturulan Actor’larla değiştirilir. `Add/Import` ya da dosyayı Content Browser’a sürükleme seçenekleri yalnızca varlıkları aktarır. `File > Import Into Level` ise varlıklarla birlikte Actor’ları içe aktarır.

## Animasyon, katmanlar ve Blender ile alışveriş

USD dosyasında animasyon varsa, USD Stage Actor’ın özelliklerindeki Level Sequence üzerinden Sequencer’a ulaşılabilir. USD’deki xform animasyonları Transform izleri olarak gösterilir. USD Stage’e sonradan bağlanan bir Actor’a da Transform izi eklenebilir. Katmanlı sahnelerde animasyonun doğru katmanda bulunması önemlidir: Epic’in hızlı başlangıç kılavuzu, animasyon katmanının etkileyebileceği sahne katmanından daha üst sırada olması gerektiğini belirtiyor.

USD Stage Editor primlere referans ve payload eklemeyi, katmanları izole etmeyi ve primleri çoğaltmayı da destekler. Ancak çoğaltma işleminin sonucu seçilen yönteme göre değişir: örneğin “Flatten Composed Prim” birleştirilmiş prim bileşimini yeni prim olarak oluştururken, “Single Layer Specs” yalnızca geçerli düzenleme hedefindeki prim tanımlarını çoğaltır. Bu seçenekleri kullanmadan önce hangi katmanların değişikliğe dahil olacağını kontrol edin.

Blender’a aktarımda da bazı ayrıntılar önem taşıyor. USDZ arşivlerinde dokuların içe alınma biçimi seçilebilir: dokuları içe almamak materyallerin çözümlenememesine yol açabilir; paketleme veya ayrı klasöre kopyalama seçenekleri de bulunur. Ayrıca Blender’ın USD Preview Surface materyallerini Principled BSDF düğümlerine dönüştürmesi yaklaşık sonuç verebilir ve tüm gölgelendirici ayarlarını korumaz. Bu nedenle iki uygulama arasındaki sonucu üretimden önce örnek bir dosyada doğrulayın.

## Mimarlık ve görselleştirme iş akışında neye dikkat edilmeli?

Mimarlık ofisleri, iç mimarlar ve görselleştirme ekipleri USD Stage’i; farklı kaynaklardan gelen sahne hiyerarşisini incelemek, alternatif prim veya referansları yönetmek ve animasyonları Sequencer’da değerlendirmek için kullanabilir. Büyük bir sahneyi doğrudan yerel varlıklara dönüştürmeden inceleyebilmek, aktarım öncesi düzenleme aşamasında fayda sağlayabilir. Ancak bu, her uygulama özelliğinin birebir korunacağı anlamına gelmez.

Özellikle ışıklandırma ve materyal görünümünü kontrol edin. Epic, USD Stage açıldığında Unreal Engine’in varlıklar için otomatik lightmap oluşturmadığını; statik ışıklandırma oluşturulması halinde sahnenin tamamen siyah görünebileceğini belirtiyor. Blender’a geçişte materyal dönüşümü yaklaşık olabilir; katman ve referans desteğinin sınırları da sahne yapısını etkileyebilir. Nihai sunumdan önce hedef uygulamada ışık, materyal, doku, animasyon ve hiyerarşi doğrulaması yapın. USD Stage’in beta statüsünü de üretim kararlarına dahil edin.

## Sık yapılan hatalar ve sonraki adımlar

- **Eklenti etkin değilken USD Stage aramak:** USD Importer’ı etkinleştirip editörü yeniden başlatın.
- **Referansı sahneye kopyalama sanmak:** Referans, başka bir prim veya USD dosyasına bağlantı kurar; hedef dosya ve prim seçimini dikkatle yapın.
- **USDZ dokularını gözden kaçırmak:** İçe aktarma seçeneğini kontrol edin; dokuları almadığınız durumda materyal dokuları çözümlenemeyebilir.
- **Statik ışıklandırma sonucunu kontrol etmemek:** USD Stage’den gelen varlıklar için otomatik lightmap oluşturulmadığını hesaba katın.
- **Çok kullanıcılı oturumda farklı dosya yolları kullanmak:** Ekip üyelerinin USD dosyasına aynı yoldan erişmesini sağlayın. Epic ayrıca çok kullanıcılı oturum sırasında prim silme işleminin geri alınamadığını belirtiyor.

İlk denemeyi küçük ve temsili bir USD sahnesiyle yapın. Hiyerarşiyi, referansları, dokuları ve hedef uygulamadaki görünümü karşılaştırdıktan sonra daha kapsamlı projelere geçin. Blender ve Unreal Engine belgelerindeki desteklenen veri türlerini gözden geçirmek, dosya aktarımında beklenmedik kayıpları azaltmaya yardımcı olur.

## Kaynak ve lisans

Bu rehber, Epic Games’in USD Stage hızlı başlangıç, USD genel bakış ve primlerle çalışma belgeleri ile Blender Manual’ın USD içe aktarma ve dışa aktarma belgesine dayanılarak hazırlanmıştır. Blender Manual belgesi CC BY-SA 4.0 lisanslıdır; içeriği Türkçe olarak uyarlanmıştır.

## Pro ipucu
USDZ içe aktarırken dokuların nasıl ele alınacağını önceden seçin; ardından sahnenin materyal ve ışıklandırmasını hedef uygulamada ayrıca doğrulayın.

## 3dsınıfı yorumu
USD Stage, mimarlık ofisleri ve görselleştirme ekipleri için farklı yazılımlardan gelen sahneleri hiyerarşisiyle inceleme ve düzenleme bakımından anlamlı bir ara katman sunuyor. Özellikle referans, varyant ve animasyon içeren sahnelerde veriyi hemen yerel varlıklara çevirmeden çalışabilmek pratik değer taşıyabilir.

Türkiye’deki ekipler için asıl dikkat noktası donanım veya açıklanmamış bir fiyat değil; mevcut proje yapısı, dosya yönetimi ve uygulamalar arasındaki uyumluluk. Beta uyarısı, materyal dönüşüm sınırları ve otomatik lightmap oluşturulmaması küçük bir pilot çalışma yapmayı gerekli kılıyor. Büyük projeye geçmeden önce lisans ve ekip içi kaynak kontrolü düzeniyle birlikte hedef sahnede sonuçları doğrulamak daha sağlıklı olacaktır.

## Kaynaklar
- [dev.epicgames.com](https://dev.epicgames.com/documentation/unreal-engine/usd-stage-editor-quick-start-in-unreal-engine) (özet)
- [dev.epicgames.com](https://dev.epicgames.com/documentation/unreal-engine/universal-scene-description-in-unreal-engine) (özet)
- [dev.epicgames.com](https://dev.epicgames.com/documentation/unreal-engine/working-with-usd-stage-prims-in-unreal-engine) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_
