Rozpoczęcie

Rozpoczęcie pracy z Aspose.3D FOSS dla Java

Witamy w aspose-3d-foss, darmowa, otwartoźródłowa Java biblioteka do ładowania, budowania i eksportowania scen 3D. Ten przewodnik poprowadzi Cię od nowego projektu do działającej sceny w ciągu kilku minut.

Wymagania wstępne

WymaganieSzczegóły
JavaJDK 21 lub nowszy
Narzędzie budowaniaMaven lub Gradle
OSWindows, macOS lub Linux

Instalacja

Dodaj zależność Maven do swojego pom.xml:

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

Zweryfikuj:

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

Zobacz Przewodnik instalacji dotyczący konfiguracji Gradle i kroków weryfikacji.

Co możesz zrobić

Po zainstalowaniu możesz od razu:

  • Załaduj pliki OBJ, STL, glTF 2.0 / GLB i FBX za pomocą scene.open()
  • Sprawdź hierarchie scen: przeglądaj Node drzewa, odczytuj Mesh geometrię, uzyskaj dostęp do normalnych wierzchołków i UV
  • Transformuj węzły: ustaw translację, rotację i skalę poprzez Transform klasę
  • Zastosuj materiały: przypisz Material lub PbrMaterial do węzłów
  • Eksportuj do dowolnego obsługiwanego formatu z scene.save()
  • Buduj geometrię: utwórz Mesh obiekty programowo z punktami kontrolnymi i wielokątami

Szybki start

Wczytaj plik 3D, wyświetl hierarchię sceny i ponownie zapisz w formacie GLB:

import com.aspose.threed.Scene;
import com.aspose.threed.Node;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

Kolejne kroki

 Polski