Πώς να ξεκινήσετε με το Aspose.3D FOSS για .NET

Το Aspose.3D FOSS για .NET είναι μια δωρεάν, MIT-υποδεκτή βιβλιοθήκη για την φόρτωση, χειραγώγηση και αποθήκευση 3D αρχείων - δεν απαιτούνται εγχώριες δυαδικές ανάγκες, καθαρό C# από το NuGet.

Βήμα προς βήμα οδηγός

Βήμα 1: Εγκατάσταση του πακέτου

Εγκατάσταση από το NuGet (απαραίτητο .NET 10.0 ή μεταγενέστερο):

dotnet add package Aspose.3D --version 26.1.0

Ελέγξτε την εγκατάσταση φορτωμένη σωστά:

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

Βήμα 2: Εισαγωγή απαιτούμενων χώρων ονόματος

Εισαγωγή των ονοματομετρητών για τη σκηνή και τις τάξεις μορφοποίησης:

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

Βήμα 3: Κατεβάστε ένα αρχείο 3D

Χρησιμοποιήστε Scene.Open() να φορτώσει οποιαδήποτε υποστηριζόμενη μορφή. η βιβλιοθήκη ανιχνεύει τη μορφοποίηση Αυτόματα από την επέκταση αρχείου:

using Aspose.ThreeD;

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

Χρησιμοποιήστε τη στατική μέθοδο εργοστασίου:

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

Βήμα 4: Περπατήστε το γραφείο σκηνής

Μια σκηνή φορτισμένη είναι ένα δέντρο Node αντικείμενα που ριζώνουν σε 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: Αποθηκεύστε σε διαφορετικό μορφότυπο

Χρησιμοποιήστε Scene.Save() να εξάγει σε οποιαδήποτε μορφή έκδοσης που υποστηρίζεται. η βιβλιοθήκη εντοπίζει την Η μορφή εξόδου από την επέκταση αρχείου:

using Aspose.ThreeD;

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

Κοινά προβλήματα και τακτοποιήσεις

FileNotFoundException Όταν καλείται Scene.Open() Ο δρόμος που πέρασες δεν υπάρχει ή χρησιμοποιεί τον λάθος διαχωριστή. Path.Combine() Για να διασφαλιστεί ότι η πορεία του αρχείου είναι σωστή.

UnsupportedOperationException Για ορισμένες μεθόδους Ορισμένες μεθόδους (εικόνα rendering, watermarking) δεν είναι διαθέσιμες στην έκδοση FOSS. Ελέγξτε την τεκμηρίωση περιορισμών πριν χρησιμοποιήσετε προηγμένες λειτουργίες.

Απίστευτο σφάλμα μορφής Βεβαιωθείτε ότι η επέκταση αρχείου ταιριάζει με την πραγματική μορφή.Η βιβλιοθήκη ανακαλύπτει τη μορφοποίηση από το Η επέκταση για Scene.Open() και Scene.FromFile().Πάρτε μια σαφή FileFormat παράμετρος για να υπερβαίνει την ανίχνευση.

Αδειά σκηνή μετά την φόρτιση Ορισμένες δυαδικές μορφές μπορεί να απαιτούν συγκεκριμένες επιλογές φόρτωσης. δοκιμάστε τη χρήση της ρητής υπερφόρτωση Με ObjLoadOptions ή GltfLoadOptions Αν η προεπιλεγμένη φόρτιση παράγει μια κενή σκηνή.

Συχνές ερωτήσεις

Το Aspose.3D FOSS απαιτεί Microsoft Office ή οποιαδήποτε εγχώρια DLL;?

Η βιβλιοθήκη είναι καθαρή C# χωρίς εγχώρια εξάρτηση ή εξωτερικές δυαδικές απαιτήσεις.

Ποια εκδόσεις .NET υποστηρίζονται;?

.NET 10.0 ή νεότερη. η βιβλιοθήκη λειτουργεί στα Windows, macOS, Linux και Docker δοχεία.

Είναι η βιβλιοθήκη ελεύθερη για εμπορική χρήση;?

Μπορείτε να το χρησιμοποιήσετε, να τροποποιήσουν και να αναδιανέμουν για οποιονδήποτε σκοπό, συμπεριλαμβανομένων των εμπορικών εφαρμογών.

Ποια 3D μορφή μπορώ να διαβάσω και να γράψω;?

Η βιβλιοθήκη υποστηρίζει OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA και 3MF για τα δύο. Διαβάστε και γράψτε. PLY είναι εισαγωγικό μόνο. FileFormat.GetFormatByExtension() Για να Ερωτήσεις υποστηρίζονται σε μορφές σε χρόνο λειτουργίας.

Μπορώ να δημιουργήσω μια σκηνή 3D από το scratch;?

Ναι. Δημιουργία A Scene χωρίς λόγους, προσθέστε τα παιδικά κόμβα στο scene.RootNode,και Συσκευή στο επιθυμητό σχήμα.