1. Produk
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS for TypeScript

Muat, bangun, transformasi, dan ekspor adegan 3D dari Node.js — sepenuhnya bertipe, sumber terbuka, dan siap produksi dengan satu instalasi npm.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Dokumentasi GitHub

Perpustakaan TypeScript Sumber Terbuka untuk Pemrosesan Berkas 3D

Aspose.3D FOSS untuk TypeScript adalah perpustakaan berlisensi MIT untuk bekerja dengan format file 3D dalam aplikasi Node.js. Instal dengan satu perintah npm install @aspose/3d dan mulai membaca, membangun, serta menulis adegan 3D dalam TypeScript secara langsung, tanpa addon native yang harus dikompilasi, tanpa SDK eksternal yang harus dipasang, dan tanpa renderer yang diperlukan.

Perpustakaan ini menyediakan API grafik-skena yang sepenuhnya bertipe, dibangun di sekitar Scene, Node, Entity, Mesh, Camera, Light, dan Transform, model konseptual yang sama digunakan oleh alat 3D profesional. Dukungan format mencakup OBJ (Wavefront, dengan pemuatan material .mtl), glTF 2.0 dan GLB biner (material PBR), STL (biner dan ASCII, siklus penuh), COLLADA (DAE), 3MF, dan FBX. Kelas opsi per-format seperti ObjLoadOptions dan GltfSaveOptions memberi Anda kontrol tepat atas orientasi sistem koordinat, skala, normalisasi normal, output biner vs. JSON, dan pemuatan material.

Aspose.3D FOSS menargetkan Node.js 18, 20, dan 22+ dengan TypeScript 5.0+ serta dikompilasi ke CommonJS. Perpustakaan ini dilengkapi dengan pengaturan ketat kompilator TypeScript (noImplicitAny, strictNullChecks) sehingga IDE Anda memberikan autocomplete lengkap dan keamanan pada waktu kompilasi. Dependensi runtime tunggalnya, xmldom, dipasang secara otomatis.

Dukungan Format 3D dan API Scene-Graph Bertipe

  • OBJ / MTL: Muat file Wavefront OBJ dengan definisi material yang menyertainya.
  • glTF 2.0 / GLB: Pemuatan material PBR dan output GLB biner melalui GltfSaveOptions.
  • STL: Baca dan tulis STL baik dalam format biner maupun ASCII dengan verifikasi siklus penuh.
  • COLLADA, 3MF, FBX: Dukungan format tambahan dengan kelas opsi per-format.
  • Tipe TypeScript lengkap: Setiap kelas, metode, dan opsi memiliki tipe yang kuat dengan noImplicitAny dan strictNullChecks.

Di mana Aspose.3D FOSS dapat digunakan

  • Pipeline aset Node.js: Impor file OBJ, validasi dan reorientasi geometri, serta ekspor sebagai GLB dalam CI.
  • Alat game: Proses batch mesh 3D tanpa mesin atau renderer native.
  • Alur kerja pencetakan 3D: Baca, validasi, dan ekspor ulang file STL dan 3MF.
  • Backend tanpa server: Jalankan endpoint konversi 3D di Lambda atau Cloud Functions.
  • Migrasi konten: Konversi antar keluarga format secara skala besar dari satu skrip.

Opsi Per-Format dan Kontrol Koordinat

  • Orientasi sistem koordinat: Balik sumbu dan sesuaikan skala per format dengan kelas opsi.
  • Normalisasi normal: Secara otomatis menormalkan normal vertex saat memuat atau menyimpan.
  • Output biner vs. JSON: Pilih GLB yang kompak atau glTF yang dapat dibaca melalui GltfSaveOptions.
  • Kontrol pemuatan material: Aktifkan atau nonaktifkan pemuatan MTL/tekstur untuk parsing yang lebih cepat.
  • Kesetiaan round-trip: Node grafis adegan yang tidak dikenal dipertahankan persis saat disimpan kembali.

Pengalaman Pengembang

Aspose.3D FOSS untuk instalasi TypeScript dengan satu perintah npm install @aspose/3d. Tidak ada addon native yang harus dikompilasi. Perpustakaan ini murni TypeScript/JavaScript dengan satu dependensi yang diinstal otomatis (xmldom).

API yang kuat tipe memberikan autocomplete IDE lengkap untuk setiap kelas scene-graph dan opsi format. Perpustakaan ini menargetkan Node.js 18–22+ dan TypeScript 5.0+, berjalan identik pada runner CI Linux dan workstation pengembang, serta berlisensi MIT dengan pelacak isu terbuka di GitHub.

Muat adegan OBJ dan Ekspor sebagai glTF

Instal dengan npm, lalu gunakan metode sinkron scene.open() dengan ObjLoadOptions untuk memuat mesh bersama file material MTL-nya. Memanggil scene.save() dengan ekstensi .gltf menulis JSON glTF 2.0 standar; formatnya diperkirakan secara otomatis dari ekstensi file.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";

const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());

// Ekspor sebagai glTF 2.0 JSON
scene.save("model.gltf");

Konversi STL ke Binary GLB

Untuk menghasilkan GLB biner yang kompak alih-alih glTF JSON default, berikan GltfSaveOptions dengan binaryMode = true.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// Simpan sebagai GLB biner yang kompak
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Pertanyaan yang Sering Diajukan

Apa itu Aspose.3D FOSS untuk TypeScript?

Ini adalah perpustakaan TypeScript/Node.js gratis berlisensi MIT untuk memuat, memanipulasi, dan menyimpan 3D scenes tanpa menginstal addon native atau SDK eksternal.

Format 3D apa yang didukung?

OBJ (dengan .mtl), glTF 2.0 dan GLB, STL (biner dan ASCII), COLLADA (DAE), 3MF, dan FBX. Setiap format memiliki kelas opsi bertipe khusus.

Apakah itu memerlukan addon native Node.js?

Tidak. Aspose.3D FOSS for TypeScript adalah JavaScript/TypeScript murni. Ia tidak memerlukan langkah kompilasi dan memiliki satu dependensi runtime (xmldom) yang diinstal secara otomatis oleh npm.

Bagaimana cara menginstalnya?

Jalankan npm install @aspose/3d. Tidak diperlukan paket sistem tambahan atau addon native.

Versi Node.js dan TypeScript mana yang didukung?

Node.js 18, 20, dan 22+. TypeScript 5.0+. Perpustakaan ini dikompilasi ke CommonJS dan berfungsi dengan pengaturan TypeScript yang ketat.

Apakah ia dilengkapi dengan TypeScript type definitions?

Ya. Semua kelas, metode, enum, dan tipe opsi sepenuhnya diberi tipe dengan noImplicitAny dan strictNullChecks diaktifkan.

Bisakah saya mengontrol orientasi sistem koordinat?

Ya. Kelas opsi per-format seperti ObjLoadOptions dan GltfSaveOptions memungkinkan Anda membalik sumbu, menyesuaikan skala, dan menormalkan normal tanpa kode parsing khusus.

Di mana saya dapat menemukan kode sumber?

Perpustakaan ini berlisensi MIT dan dihosting di GitHub. Laporan bug dan pull request dipersilakan.

  

Sumber Daya Dukungan dan Pembelajaran

 Bahasa Indonesia