Enum'lar: Enum Türü Referansı

LCC4UnrealRuntime modülünün sunduğu enum türleri.


Modül	`LCC4UnrealRuntime`
Header	`Core/LCCEnum.h`

#include "Core/LCCEnum.h"

BlueprintType ile işaretlenen enum'lar doğrudan Blueprint içinde kullanılabilir, bir Switch düğümüne bağlanabilir ve değişken türü olarak kullanılabilir.

Görüntüleme

ERenderMode

Görüntüleme modu. ULCCComponentBase::RenderMode tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`Splatting`	3DGS	3D Gaussian Splatting olarak görüntüler; yüksek kalite, yüksek maliyet
`PointCloud`	Nokta Bulutu	Nokta bulutu olarak görüntüler; düşük kalite, düşük maliyet

Nokta bulutuna geçmek maliyeti önemli ölçüde düşürür; yukarıdan görünümler, mini haritalar ve ayrıntının gerekmediği uzak görünümler için uygundur. Nokta bulutu modunda 3DGS'ye özgü parametrelerin (küresel harmonikler, SplatScale, GlobalAlpha) etkisi yoktur.

İlgili arayüzler: SetRenderMode, ToggleRenderMode

ELoadMode

Yükleme filtresi modu. ULCCComponentBase::LoadMode tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`Both`	Both	Ana bölümü ve çevreyi görüntüler
`OnlyMain`	OnlyMain	Yalnızca ana kısmı görüntüler
`OnlyEnvironment`	OnlyEnvironment	Yalnızca çevreyi görüntüler
`None`	None	Hiçbir şey görüntülemez

Ana bölüm, taranan çekirdek alandır; çevre ise onu saran tamamlayıcı veridir. None, veri bellekte kalırken geçici olarak gizlemek anlamına gelir; bu nedenle geri getirme, yeniden yüklemeden çok daha hızlıdır.

İlgili arayüz: SetLoadMode

ELightMode

Işık modu. ULCCComponentBase::LightMode tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`Unlit`	Unlit	Sahne aydınlatmasından etkilenmez; orijinal renkleri tarandığı gibi gösterir
`Lit`	Lit	Sahne aydınlatmasına katılır ve dinamik ışıklarla etkileşime girebilir

Taranan verinin içine sahadaki aydınlatma zaten işlenmiştir; bu nedenle Lit moduna geçmek bir katman daha ekler ve kolayca aşırı pozlamaya yol açar. LCC2'de orijinal parlaklığı düşürmek için LightingScale gerekir. Yalnızca 3DGS modunda etkilidir.

İlgili arayüzler: SetLightMode, ToggleLightMode

EShadowMode

Gölge modu.

Değer	Panel Görünümü	Açıklama
`None`	None	Gölge almaz
`Static`	Static	Statik gölge alır
`Dynamic`	Dynamic	Dinamik gölge alır

EColorationMode

Nokta bulutu görüntüleme modunda renklendirme yöntemi. ULCCComponentBase::ColorationMode tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`Elevation`	Evelation	Yüksekliğe göre renklendirir; orijinal renklerin yerine geçer
`Data`	Data	Veride saklanan RGB değerlerini kullanır

Elevation, arazi yüksekliği görselleştirmesi için ElevationColorBottom ve ElevationColorTop ile birlikte çalışır; Data taranan sahnenin gerçek renklerini gösterir. Yalnızca görüntüleme modu nokta bulutu iken geçerlidir; bkz. Görsel Ayarlar - Nokta Bulutu.

ELCC2NormalGenerationMode

LCC2 normal üretim modu. ULCC2Component::NormalMode tarafından kullanılır.

3DGS verisinin kendisinde geometrik normaller yoktur, aydınlatma ise bunlara ihtiyaç duyar. İlk üç mod yaklaşık yapılardır ve yalnızca ProxyMesh gerçek normaller sağlar.

Değer	Panel Görünümü	Gerçek gölgelendirme	Açıklama
`Fixed`	Fixed	Hayır	Tüm 3DGS, kullanıcı tarafından belirlenen tek bir dünya normalini paylaşır; varsayılan olarak yukarı bakar. Her şeyin parlaklığı `dot(normal, light direction)` değerine eşittir
`ViewFacing`	View Facing	Hayır	Her şey kameraya bakar ve eşit şekilde aydınlatılır
`Hemispherical`	Hemispherical	Hayır	Kameradan bağımsız normaller; ekran konumundan sabit bir dünya yarım küresine eşlenir
`ProxyMesh`	Proxy Mesh	Evet	Gerçek derinlik ve normaller sahnedeki bir `ALCC2ProxyMesh` nesnesinden gelir; 3DGS yalnızca renk katkısı sağlar

Her modun artı ve eksileri:

Mod	Avantajlar	Dezavantajlar
`Fixed`	Çapraz ışık bandı yoktur, kamera hareket ederken tamamen kararlıdır, en düşük maliyet	Hiç şekil gölgelendirmesi yoktur; ışık normalin arkasından geldiğinde her şey kararır
`ViewFacing`	Yapılandırma gerekmez, çapraz ışık bandı yoktur	Şekil gölgelendirmesi yoktur; kamera döndükçe genel parlaklık kayar
`Hemispherical`	Çapraz ışık bandı yoktur, kamera hareket ederken kararlıdır, güneş ışığı alanı katederken en yumuşak geçişi sağlar	Hâlâ gerçek gölgelendirme değildir; `NormalPole` ve `NormalHemiSpread` ayarı gerekir
`ProxyMesh`	Gerçek geometrik normaller ve derinlik	Eşleşen bir proxy mesh hazırlanmasını ve yerleştirilmesini gerektirir; lisans gerekir, lisans yoksa `Fixed` moduna geri döner

Öneri: Varsayılan olarak Fixed; yumuşak güneş ışığı hareketi için Hemispherical; gerçek şekil gölgelendirmesi için ProxyMesh; ViewFacing yalnızca sonuca hızlıca göz atmak için.

İlgili sayfalar: ULCC2Component, ALCC2ProxyMesh

Kırpma ve Kesit

EClipType

Kırpma yönü. ALCCClippingVolume::Mode tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`Inside`	İçeride	Hacmin içi kırpılır
`Outside`	Dışarıda	Hacmin dışı kırpılır

Inside delik açmak ve bir kabuğu açmak içindir; Outside yalnızca ilgilenilen alanı tutmak içindir.

EClipVolumeType

Kırpma hacmi şekli. ALCCClippingVolume::VolumeType tarafından kullanılır.

Değer	Açıklama
`Box`	Kutu hacmi
`Sphere`	Küre hacmi

ESectionType

Kesit yönü. ALCCSectionPlane::Mode tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`Upside`	Üst Taraf	Düzlemin üstünde kalan kısım kesilir
`Downside`	Alt Taraf	Düzlemin altında kalan kısım kesilir

Üst ve alt, dünya koordinatlarına göre değil, düzlemin kendi yönelimine göre belirlenir. Kesit düzlemini döndürerek herhangi bir yönde kesit alabilirsiniz.

ELoadRegion

Yükleme bölgesi. ALCCLoadVolume::Mode tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`Inside`	İçeride	Yalnızca hacmin içindeki veriyi yükler
`Outside`	Dışarıda	Yalnızca hacmin dışındaki veriyi yükler

EClipType ile farkı: bu seçenek, kesilecek kısmı değil yüklenecek kısmı belirler. Reddedilen alanlar hiç okunmaz; bu nedenle yük miktarını ve video belleği kullanımını azaltır. Test düğüm başına çalışır, bu yüzden sınır, kırpma hacmine göre daha pürüzlüdür.

ELoadVolumeType

Yükleme hacmi şekli. ALCCLoadVolume::VolumeType tarafından kullanılır.

Değer	Açıklama
`Box`	Kutu hacmi
`Sphere`	Küre hacmi

İlgili sayfalar: ALCCClippingVolume, ALCCSectionPlane, Yükleme Hacimleri

Veri ve Biçim

ELCCVersion

Veri sürümü.

Değer	Açıklama
`LCC`	LCC1 biçimi
`LCC2`	LCC2 biçimi

İlgili arayüz: ULCCComponentBase::GetLccVersion

EFileFormat

Dosya biçimi. ULCCUtilLibrary::DetermineFileFormat işlevinin dönüş türüdür.

Değer	Eşleşen uzantı
`None`	Tanınmadı veya yol mevcut değil
`LCC`	`.lcc`
`Splats`	`.splats`
`LAS`	`.las`
`PLY`	`.ply`

DetermineFileFormat algılama kapsamının sınırlı olduğunu unutmayın: .lcc2, .sog ve .spz için hepsi None döndürür. Bu biçimlerde uzantıyı doğrudan kontrol edin; ayrıntılar için bkz. DetermineFileFormat.

EDataSourceType

Bir LCC2 ağacının veri kaynağı biçimi. FLCC2MetaInfo::SplatType tarafından kullanılır.

Değer	Açıklama
`SOG`	`.sog` veri kaynağı
`SPZ`	`.spz` veri kaynağı
`PLY`	`.ply` veri kaynağı

Bu, UENUM işaretlemesi olmayan düz bir C++ enum'udur ve Blueprint'te görünmez.

EFileType

Veri içeriği türü.

Değer	Panel Görünümü	Açıklama
`Portable`	Portable	Yalnızca RGB, küresel harmonik yok
`Quality`	Quality	Hem RGB hem küresel harmonikler

Portable verilerde küresel harmonikler bulunmaz ve bu durumda bUseShcoef düzenlenemez. CanSetShcoef() aslında yalnızca türün Quality olup olmadığını kontrol eder.

ELCCSourceType

Veri kaynağı. ULCCUtilLibrary::DetermineSourceType işlevinin dönüş türüdür.

Değer	Açıklama
`Local`	Yerel dosya
`Http`	Ağ adresi

ECollisionType

Çarpışma veri biçimi. ULCCUtilLibrary::DetermineCollisionType işlevinin dönüş türüdür.

Değer	Açıklama
`None`	Çarpışma verisi yok
`Bin`	Eski `.bin` biçimi
`Lci`	Yeni `.lci` biçimi
`Ply`	Nokta bulutu `.ply` çarpışması

None döndürüldüğünde bEnableCollision seçeneğini etkinleştirmenin hiçbir etkisi olmaz.

ELoadStatus

Yükleme durumu.

Değer	Açıklama
`Success`	Başarılı
`Failure`	Başarısız
`Progress`	Devam ediyor

Durumlar

ULCCComponentBase durum sorguları ve olayları tarafından kullanılan, Core/LCCEventTypes.h içinde tanımlı durum enum'ları.

Enum değerleri yalnızca eklenir, hiçbir zaman değiştirilmez (Blueprint'ler bunları değer olarak saklar). Sonraki sürümlerde yeni değerler eklenebilir; bu nedenle geri çağırmalar tanımadıkları bir değeri tolere etmelidir.

ELCCLoadState

Yükleme durumu; Load() çağrısından ilk kareye kadar olan süreyi kapsar. Loaded durumundan sonra veri kamera çevresinde akmaya devam eder ve durum bu nedenle geri dönmez.

Değer	Açıklama
`Unloaded`	Hiçbir model yüklenmedi
`Loading`	Yükleme başladı, sınırlar ve meta bilgiler okunabilir, görünüm için gereken veri akıyor; ilerleme için `GetLoadProgress` kullanın
`Loaded`	Geçerli görünümün yüklenmesi tamamlandı. Bu, her parçanın doğru okunduğu anlamına gelmez: bazı veriler okunamazsa `OnLoadFailed` bunu bildirir ve model eksik olabilir. Model serbest bırakılana kadar `Loaded` durumunda kalır
`Failed`	Son yükleme başarısız oldu, model yok

ELCCCollisionState

Çarpışma durumu; çarpışmanın etkinleştirilmesinden ilk çarpışma mesh'inin yerleşmesine kadar olan süreyi kapsar. Çarpışma kamera çevresinde yüklenir ve kamera hareket ettikçe akar; dolayısıyla Loaded, kameraya yakın çarpışmanın hazır olduğu anlamına gelir, tüm modelin çarpışmaya sahip olduğu anlamına gelmez.

Değer	Açıklama
`NoCollision`	Çarpışma kapalı veya model yok
`Generating`	Yalnızca tek dosyalı modeller (PLY/SPZ/SOG): çarpışma mesh'i Gaussian'lardan üretilir; bu işlem birkaç saniyeden birkaç dakikaya kadar sürer. Önbellek varsa atlanır
`Loading`	Kameraya yakın çarpışma mesh'i yükleniyor ve işleniyor (cooking); yükleme mesafesi içinde henüz çarpışma verisi yokken `Loading` durumunda kalır
`Loaded`	Kameraya yakın çarpışma ilk kez hazır ve yakındaki nesneler artık içinden geçmiyor; kamera hareket ettikçe çarpışma akmaya devam ederken `Loaded` durumunda kalır
`Failed`	Çarpışma açık ancak sağlanamıyor: çarpışma verisi yok, üretim için lisans yok veya üretim başarısız oldu. Output Log'a bakın; yeniden denemek için kapatıp açın

ELCCLoadAnimationState

Yükleme animasyonu durumu (bEnableAnimation). Animasyon yükleme süresine göre zamanlanır ve verinin gelmesini beklemez: Finished, animasyonun oynatmayı bitirdiği anlamına gelir; modelin ekranda tamamlandığı anlamına gelmez.

Değer	Açıklama
`NoAnimation`	Animasyon kapalı veya model yok
`Playing`	Yükleme animasyonu oynatılıyor; `Load` / `Refresh` / `SetEnableAnimation` animasyonu yeniden başlatır
`Finished`	Animasyon bitti ve ortam göründü. İleri yönde modelin tamamen görüntülendiği, ters yönde ise kaybolduğu anlamına gelir. Animasyon ayarındaki bir değişiklik yeniden oynatmaya neden olduğunda `Playing` durumuna döner

ELCCLoadError

Yükleme hatası nedeni; FLCCLoadFailure::Error tarafından kullanılır.

Değer	Açıklama
`None`	Hata yok
`FileNotFound`	`Load` işlevine verilen dosya bulunamadı (`.lcc` modeli için bitişikteki data.bin / index.bin dosyaları da buna dahildir). Hiçbir şey yüklenmedi ve önceden yüklenmiş model korunur. Yolu kontrol edin
`InvalidData`	Dosya bulundu ancak bozuk, veri dosyaları eksik veya eklentinin okuyabileceği bir model değil. Ya hiçbir şey yüklenmedi (`GetLoadState` değeri `Failed`) ya da model yüklendi ancak bazı veriler okunamadı ve model eksik (`GetLoadState` değeri `Loading` veya `Loaded`). `Message` alanına ve Output Log'a bakın

Performans ve Zamanlama

ETraversalType

Düğüm geçiş yöntemi. Proje ayarlarındaki Default Traversal Type tarafından kullanılır (Project Settings → Plugins → LCC4Unreal).

Değer	Panel Görünümü	Açıklama
`Circle`	Circle	Maksimum görüntüleme mesafesini yarıçap alarak kamerayı merkez alan dairesel tarama
`Sector`	Frustum	Kamera frustum'una dayalı dolaşma

Frustum yalnızca görüş alanındaki düğümleri işler ve genellikle daha düşük maliyetlidir. Ancak görüş alanı dışındaki düğümler önceden yüklenmez; bu nedenle görünümü hızlı çevirirken doldurma gecikmesi görülebilir.

Enum adının Sector olduğunu, panelde ise Frustum yazdığını unutmayın.

ESortMethod

Yarı saydamlık sıralama yöntemi. Proje ayarlarındaki Default Sort Method tarafından kullanılır.

Değer	Açıklama
`GPU`	GPU üzerinde sıralar
`CPU`	CPU üzerinde sıralar

Normal tercih GPU'dur.

ESortMode

Sıralama düzeni.

Değer	Açıklama
`Ascending`	Artan
`Descending`	Azalan

EComputeType

Compute işlem hattı türü.

Değer	Açıklama
`Compute`	Grafik işlem hattında Compute kullanır
`AsyncCompute`	Asenkron Compute işlem hattını kullanır

Mevcut uygulama Compute kullanır; AsyncCompute görüntüleme sorunları içerir ve henüz etkinleştirilmemiştir.

Yerelleştirme

ELocale

Yerel ayar. ULCCUtilLibrary::GetLocale işlevinin dönüş türüdür.

Değer	Açıklama
`EN_US`	İngilizce
`ZH_CN`	Basitleştirilmiş Çince

ELanguagePreference

Eklenti arayüzünün dil tercihi. Proje ayarlarındaki Language tarafından kullanılır.

Değer	Panel Görünümü	Açıklama
`FollowEditor`	Follow Editor	Geçerli editör dil ayarını izler
`AlwaysEnglish`	Her zaman İngilizce	Editör dilinden bağımsız olarak İngilizceyi zorlar

Blueprint'te Enum Kullanımı

Blueprint'te bir Switch düğümü, enum değerine göre dallanabilir:

[Get Render Mode]
        Target = (LCC Component)
        │ Return Value ──┐
        ▼                │
[Switch on ERenderMode] ◀┘
        │ Splatting  ──▶ (3DGS branch logic)
        │ Point Cloud ─▶ (point cloud branch logic)

Doğrudan karşılaştırma da aynı şekilde çalışır:

[Get Effective Normal Generation Mode]
        │ Return Value ──┐
        ▼                │
[Equal (Enum)] ◀─────────┘
        A = (Return Value)
        B = Proxy Mesh
        │
        ▼
[Branch]

Ayrıca Bakın

ULCCComponentBase: ERenderMode, ELoadMode ve ELightMode kullanımı
ULCC2Component: ELCC2NormalGenerationMode kullanımı
ULCCUtilLibrary: format enum'larını döndüren yardımcı işlevler
Struct'lar: bu enum'ları kullanan struct'lar

Bu bölüm XGRIDS'in resmî kullanım kılavuzundan Türkçeye çevrildi; ekran görüntüleri ve arayüz adları özgün haliyle İngilizcedir. İngilizce aslı (yeni sekmede açılır) · Güncelleme: 02.11.2026