Kā sākt darbu ar Aspose.3D FOSS for .NET
Aspose.3D FOSS for .NET ir bezmaksas, MIT licencēta bibliotēka 3D failu ielādēšanai, manipulēšanai un saglabāšanai — nav vajadzīgi vietējie binārie faili, tīrs C# no NuGet.
Solim pa solim ceļvedis
1. solis: instalēt pakotni
Instalējiet no NuGet (.NET 10.0 vai jaunāks nepieciešams):
dotnet add package Aspose.3D --version 26.1.0Pārbaudiet, vai instalācija ielādējās pareizi:
using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");Solis 2: Importējiet nepieciešamās vārdtelpas
Importējiet vārdtelpas ainas un formāta klašu:
using Aspose.ThreeD;
using Aspose.ThreeD.Formats;Kā ielādēt 3D failu?
Izmantojiet statisko metodi Scene.from_file(), lai atvērtu jebkuru atbalstītu formātu. Bibliotēka automātiski noteiks formātu no faila paplašinājuma.
using Aspose.ThreeD;
var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");Vai arī izmantojiet statisko ražotāju:
var scene = Scene.FromFile("model.glb");Kā pārlūkot ainas grafu?
Ielādēta aina ir Node objektu koks, kura sakne ir 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);3. solis: Saglabājiet mērķa formātā
Izsauciet scene.save() ar izvades ceļu. Izvades formāts tiek noteikts no faila paplašinājuma.
using Aspose.ThreeD;
var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");Biežāk sastopamās problēmas un to risinājumi
FileNotFoundException izsaucot Scene.Open() Norādītais ceļš neeksistē vai izmanto nepareizu atdalītāju. Izmantojiet absolūto ceļu vai Path.Combine(), lai pārliecinātos, ka faila ceļš ir pareizs.
UnsupportedOperationException noteiktām metodēm Dažas metodes (ainas renderēšana, ūdenszīmju pievienošana) nav pieejamas FOSS izdevumā. Pārbaudiet ierobežojumu dokumentāciju pirms izmantot papildu funkcijas.
Nezināmas formāta kļūda Pārliecinieties, ka faila paplašinājums atbilst faktiskajam formātam. Bibliotēka nosaka formātu pēc paplašinājuma Scene.Open() un Scene.FromFile() gadījumos. Nododiet konkrētu FileFormat parametru, lai pārrakstītu noteikšanu.
Tukša aina pēc ielādes Dažiem binārajiem formātiem var būt nepieciešamas specifiskas ielādes iespējas. Mēģiniet izmantot konkrēto pārslogoto metodi ar ObjLoadOptions vai GltfLoadOptions, ja noklusējuma ielāde rada tukšu ainu.
Biežāk uzdotie jautājumi
Vai Aspose.3D FOSS pieprasa Microsoft Office vai kādas vietējās DLLs?
Nē. Bibliotēka ir tīra C# bez jebkādām vietējām atkarībām vai ārējām binārajām datnēm.
Kuras .NET versijas tiek atbalstītas?
.NET 10.0 vai jaunāks. Bibliotēka darbojas Windows, macOS, Linux un Docker konteineros.
Vai bibliotēka ir bezmaksas komerciālai lietošanai?
Jā. Tā ir izlaista zem MIT licences. Jūs varat to izmantot, modificēt un izplatīt jebkuram mērķim, ieskaitot komerciālas lietojumprogrammas.
Kādus 3D formātus es varu lasīt un rakstīt?
Bibliotēka atbalsta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA un 3MF gan lasīšanai, gan rakstīšanai. PLY ir tikai importam. Izmantojiet FileFormat.GetFormatByExtension(), lai izpildlaikā noskaidrotu atbalstītos formātus.
Vai es varu izveidot 3D ainu no nulles?
Jā. Izveidojiet Scene bez argumentiem, pievienojiet bērna mezglus scene.RootNode un saglabājiet vēlamajā formātā.
Skatīt arī
- BUJ — Aspose.3D FOSS priekš .NET
- Kā ielādēt 3D modeļus .NET
- Kā konvertēt 3D modeļus .NET
- Sākuma dokumentācija
- API atsauce