Varlıklar

  • Makale
  • Okumak için 2 dakika

Bir varlık , boşluk alanındaki taşınabilir bir nesneyi temsil eder ve uzaktan işlenmiş içeriğin temel yapı taşıdır.

Varlık özellikleri

Varlıkların bir konum, döndürme ve ölçeğe göre tanımlanan bir dönüşümü vardır. Kendilerine ait varlıkların herhangi bir observable işlevselliği yoktur. Bunun yerine, davranış, varlıklara eklenen bileşenler aracılığıyla eklenir. Örneğin, bir CutPlaneComponent iliştirmek varlığın konumunda kesilmiş bir düzlem oluşturacaktır.

Varlığın kendisinin en önemli yönü hiyerarşinin ve sonuçta elde edilen sıradüzenli dönüşümüdür. Örneğin, birden çok varlık paylaşılan bir üst varlığa alt öğe olarak eklendiğinde, bu varlıkların tümü uyum içinde taşınabilir, döndürülebilir ve üst varlığın dönüşümü değiştirilerek ölçekleniyor. Ayrıca, varlığın enabled durumu hiyerarşide tam bir alt grafik için görünürlük ve ışın yanıtlarını devre dışı bırakmak için kullanılabilir.

Bir varlık kendi üst öğesine sahip olduğu anlamına gelir, yani üst öğe ile yok edildiğinde Entity.Destroy() , alt öğeleri ve tüm bağlı Bileşenler. Bu nedenle, bir modelin sahne alanından kaldırılması Destroy , bir modelin kök düğümüne çağırarak RenderingSession.Connection.LoadModelAsync() veya bunun SAS varyantı tarafından döndürülen bir şekilde gerçekleştirilir RenderingSession.Connection.LoadModelFromSasAsync() .

Varlıklar, sunucu içerik yüklediğinde veya Kullanıcı sahneye nesne eklemek istediğinde oluşturulur. Örneğin, bir Kullanıcı bir kafesin iç kısmını görselleştirmek için kesilmiş bir düzlem eklemek isterse, Kullanıcı düzlemin mevcut olması gereken bir varlık oluşturabilir ve ardından bu nesneye kesilen düzlemi bileşenini ekler.

Varlık oluşturma

Sahneye yeni bir varlık eklemek için örneğin, modeli yüklemek veya ona bileşenleri eklemek üzere bir kök nesne olarak geçirmek için, aşağıdaki kodu kullanın:

Entity CreateNewEntity(RenderingSession session)
{
    Entity entity = session.Connection.CreateEntity();
    entity.Position = new LocalPosition(1, 2, 3);
    return entity;
}

ApiHandle<Entity> CreateNewEntity(ApiHandle<RenderingSession> session)
{
    ApiHandle<Entity> entity(nullptr);
    if (auto entityRes = session->Connection()->CreateEntity())
    {
        entity = entityRes.value();
        entity->SetPosition(Double3{ 1, 2, 3 });
        return entity;
    }
    return entity;
}

Sorgu işlevleri

Varlıklarda iki tür sorgu işlevi vardır: zaman uyumlu ve zaman uyumsuz çağrılar. Zaman uyumlu sorgular yalnızca istemcide bulunan ve çok fazla hesaplama içermeyen veriler için kullanılabilir. Örnekler, bileşenler, göreli nesne dönüştürmeleri veya üst/alt ilişkileri sorgular. Zaman uyumsuz sorgular yalnızca sunucuda bulunan veya istemcide çok pahalı olan ek hesaplamayı içeren veriler için kullanılır. Örnekler, uzamsal sınır sorguları veya meta veri sorgulardır.

Bileşenler sorgulanıyor

Belirli bir türün bileşenini bulmak için şunu kullanın FindComponentOfType :

CutPlaneComponent cutplane = (CutPlaneComponent)entity.FindComponentOfType(ObjectType.CutPlaneComponent);

// or alternatively:
CutPlaneComponent cutplane = entity.FindComponentOfType<CutPlaneComponent>();

ApiHandle<CutPlaneComponent> cutplane = entity->FindComponentOfType(ObjectType::CutPlaneComponent)->as<CutPlaneComponent>();

// or alternatively:
ApiHandle<CutPlaneComponent> cutplane = entity->FindComponentOfType<CutPlaneComponent>();

Dönüşümler sorgulanıyor

Dönüştürme sorguları nesnedeki zaman uyumlu çağrılardır. API aracılığıyla sorgulanan dönüşümlerinin, nesnenin üst öğesiyle ilişkili olan yerel alan dönüştürmelerini aklınızda olması önemlidir. Özel durumlar, yerel alan ve dünya alanının aynı olduğu kök nesnelerdir.

Not

Rastgele nesnelerin dünya alanı dönüşümünü sorgulamak için adanmış bir API yok.

// local space transform of the entity
Double3 translation = entity.Position;
Quaternion rotation = entity.Rotation;

// local space transform of the entity
Double3 translation = entity->GetPosition();
Quaternion rotation = entity->GetRotation();

Uzamsal sınırları sorgulama

Sınır sorguları, bir varlığı kök olarak kullanan tam bir nesne hiyerarşisinde çalışan zaman uyumsuz çağrılardır. Nesne sınırlarıhakkında adanmış bölüme bakın.

Meta veriler sorgulanıyor

Meta veriler, nesneler üzerinde depolanan ve sunucu tarafından yoksayılan ek verilere sahiptir. Nesne meta verileri aslında değer sayısal, Boolean veya dize türünde olabilecek bir dizi (ad, değer) çiftleridir. Meta veriler modelle birlikte verilebilirler.

Meta veri sorguları belirli bir varlıkta zaman uyumsuz çağrılardır. Sorgu, bir alt grafiğin birleştirilmiş bilgisini değil, yalnızca tek bir varlığın meta verilerini döndürür.

Task<ObjectMetadata> metaDataQuery = entity.QueryMetadataAsync();
ObjectMetadata metaData = await metaDataQuery;
ObjectMetadataEntry entry = metaData.GetMetadataByName("MyInt64Value");
System.Int64 intValue = entry.AsInt64;
// ...

entity->QueryMetadataAsync([](Status status, ApiHandle<ObjectMetadata> metaData) 
{
    if (status == Status::OK)
    {
        ApiHandle<ObjectMetadataEntry> entry = *metaData->GetMetadataByName("MyInt64Value");
        int64_t intValue = *entry->GetAsInt64();

        // ...
    }
});

Nesne herhangi bir meta veri tutmasa bile sorgu başarılı olur.

API belgeleri

Sonraki adımlar