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

Aspose.3D FOSS untuk TypeScript

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

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

Dokumentasi GitHub

Perpustakaan TypeScript Open-Source untuk Pemrosesan Berkas 3D

Aspose.3D FOSS for 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 segera, tanpa addon native untuk dikompilasi, tanpa SDK eksternal untuk diinstal, dan tanpa renderer yang diperlukan.

Perpustakaan ini menyediakan API grafik‑skena yang sepenuhnya bertipe yang dibangun di sekitar Scene, Node, Entity, Mesh, Camera, Light, dan Transform, model konseptual yang sama yang 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 yang 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+ dan mengompilasi ke CommonJS. Perpustakaan ini dilengkapi dengan pengaturan ketat kompilator TypeScript (noImplicitAny, strictNullChecks) sehingga IDE Anda menyediakan autocomplete lengkap dan keamanan pada waktu kompilasi. Ketergantungan runtime tunggalnya, xmldom, dipasang secara otomatis. Untuk keluarga produk enterprise, lihat Aspose.3D — Enterprise Product Family.

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 biner maupun ASCII dengan verifikasi putar balik penuh.
  • COLLADA, 3MF, FBX: Dukungan format tambahan dengan kelas opsi per‑format.
  • Full TypeScript types: Setiap kelas, metode, dan opsi memiliki tipe yang kuat dengan noImplicitAny dan strictNullChecks.

Di mana Aspose.3D FOSS dapat digunakan

  • Node.js asset pipelines: Impor file OBJ, validasi dan re‑orientasi geometri, dan ekspor sebagai GLB dalam CI.
  • Alat game: Proses batch mesh 3D tanpa mesin atau perender asli.
  • 3D printing workflows: Baca, validasi, dan ekspor ulang file STL dan 3MF.
  • Serverless backends: 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.
  • Normal normalization: Secara otomatis menormalkan normal vertex saat memuat atau menyimpan.
  • Binary vs. JSON output: 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.
  • Fidelitas putar-balik: Node graf-skena yang tidak dikenal dipertahankan secara verbatim pada penyimpanan ulang.

Pengalaman Pengembang

Aspose.3D FOSS untuk TypeScript diinstal 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 strongly typed menyediakan autocomplete IDE lengkap untuk setiap kelas scene-graph dan opsi format. Perpustakaan menargetkan Node.js 18–22+ dan TypeScript 5.0+, berjalan identik pada runner CI Linux dan workstation pengembang, dan berlisensi MIT dengan pelacak isu terbuka di GitHub.

Muat adegan OBJ dan Ekspor sebagai glTF

Instal dengan npm, lalu gunakan scene.open() dengan ObjLoadOptions untuk memuat mesh bersama file material MTL‑nya. Baik open() maupun save() bersifat sinkron — tidak diperlukan await atau rantai Promise. 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());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Ubah STL menjadi Binary GLB

Untuk menghasilkan GLB biner yang kompak alih‑alih glTF JSON default, berikan GltfSaveOptions dengan binaryMode = true. Baik open() maupun save() bersifat sinkron — tidak diperlukan await.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
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 yang gratis, berlisensi MIT, untuk memuat, memanipulasi, dan menyimpan adegan 3D 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 untuk TypeScript adalah JavaScript/TypeScript murni. Tidak memerlukan langkah kompilasi dan memiliki satu dependensi runtime (xmldom) yang dipasang 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 itu disertakan dengan definisi tipe TypeScript?

Ya. Semua kelas, metode, enum, dan tipe opsi sepenuhnya bertipe 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