Aspose.3D FOSS ile Nasıl Başlarsınız .NET için

Aspose.3D FOSS for .NET, 3D dosyaları yüklemek, manipüle etmek ve kurtarmak için ücretsiz bir MIT lisanslı kütüphane - native binary gerektirmez, NuGet’ten saf C#.

Adım-Adım Rehberi

Adım 1: Paketi Kurun

NuGet’ten yükleme (.NET 10.0 veya sonraki gereklidir):

dotnet add package Aspose.3D --version 26.1.0

Doğru yüklü yüklemeyi kontrol edin:

using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");

Adım 2: İhtiyaç duyulan isim alanları ithal etmek

Sahne ve format sınıfları için isim alanlarını ithal edin:

using Aspose.ThreeD;
using Aspose.ThreeD.Formats;

Adım 3: 3D dosyayı yükleme

Kullanım Scene.Open() Desteklenen herhangi bir biçim yüklemek için. kütüphane biçimi tespit eder Dosya uzantısından otomatik olarak:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");

Ya da statik fabrika yöntemi kullanın:

var scene = Scene.FromFile("model.glb");

Adım 4: Sahne grafiklerini geçin

Bir sahne bir ağaçtır, bir Node ırkçı olan nesneler scene.RootNode:

using Aspose.ThreeD;

void Walk(Node node, int depth = 0)
{
    var indent = new string(' ', depth * 2);
    Console.WriteLine($"{indent}Node: {node.Name}");
    foreach (var child in node.ChildNodes)
        Walk(child, depth + 1);
}

var scene = Scene.FromFile("model.obj");
Walk(scene.RootNode);

5. Adım: Farklı bir formatta kaydetmek

Kullanım Scene.Save() Herhangi bir destekleyici çıkış biçimine ihraç etmek için. kütüphane, Dosya uzantısından çıkış biçimi:

using Aspose.ThreeD;

var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");

Yaygın Sorunlar ve Çözümler

FileNotFoundException çağrıldığında Scene.Open() Geçtiğiniz yol yok ya da yanlış ayrıştırıcı kullanır. Path.Combine() Dosya yolunun doğru olduğundan emin olmak.

UnsupportedOperationException Belirli yöntemler için Bazı yöntemler (scen rendering, su işaretleme) FOSS sürümünde mevcut değildir. Gelişmiş özellikleri kullanmadan önce sınırlama belgelerini kontrol edin.

Bilinmeyen format hatası Dosya uzantısı gerçek formatla eşleşir. kütüphane biçimi tespit eder Uzantısı için Scene.Open() ve Scene.FromFile().* Açıklama yapın FileFormat Parametreler tespit için geçerlidir.

Yükleme sonrası boş sahne Bazı ikili biçimler belirli yük seçenekleri gerekebilir. açık aşırı yükleme kullanmaya çalışın ile ObjLoadOptions veya GltfLoadOptions Eğer varsayılan yük boş bir sahne üretir.

Sık Sorulan Sorular

Aspose.3D FOSS Microsoft Office veya herhangi bir yerli DLL’ye ihtiyaç duyuyor mu?

Kütüphane saf C# ve hiçbir yerli bağımlılık veya dış binary gerekli değildir.

Hangi .NET versiyonları destekliyor?

.NET 10.0 veya daha sonraki. kütüphane Windows, macOS, Linux ve Docker konteynerlerinde çalışır.

Kütüphane ticari kullanım için ücretsiz mi?

Evet. MIT Lisansı altında yayınlanmaktadır. ticari uygulamalar da dahil olmak üzere herhangi bir amaç için kullanabilir, değiştirebilir ve yeniden dağıtabilirsiniz.

Hangi 3D formatı okuyabilir ve yazabilirim?

Kütüphane her ikisi için de OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA ve 3MF destekler. Okumak ve yazmak. PLY sadece ithal ediliyor. kullanın FileFormat.GetFormatByExtension() için Soruşturma süresi boyunca destekli formatlar.

3D sahneyi çarpışmadan yapabilir miyim?

Evet. yapılandırma a Scene Hiçbir sebeple, çocuk düğümlerini ekleyin. scene.RootNode,ve İstediğiniz formatta kaydedilir.