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

Aspose.3D FOSS for TypeScript

Muat, bangun, transformasikan, 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

Open-Source TypeScript Library untuk Pengolahan File 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 segera, tanpa addon native untuk dikompilasi, tanpa SDK eksternal untuk diinstal, dan tanpa renderer yang diperlukan.

Perpustakaan ini mengekspos API scene-graph yang sepenuhnya bertipe yang 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, roundtrip 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+ dan dikompilasi ke CommonJS. Perpustakaan ini dilengkapi dengan pengaturan kompilator TypeScript yang ketat (noImplicitAny, strictNullChecks) sehingga IDE Anda menyediakan autocomplete lengkap dan keamanan pada waktu kompilasi. Dependensi runtime tunggalnya, xmldom, diinstal secara otomatis. Untuk keluarga produk enterprise, lihat Aspose.3D — Enterprise Product Family.

Dukungan Format 3D dan API Grafik Adegan yang Ditulis

  • ** OBJ / MTL:** Load Wavefront file OB J dengan keterangan materi yang disertakan.
  • glTF 2.0 / GLB: PBR material loading dan output GBL biner melalui GltfSaveOptions.
  • STL: Baca dan tulis STL biner dan ASCII dengan verifikasi perjalanan penuh.
  • COLLADA, 3MF, FBX: Dukungan format tambahan dengan kelas opsi per-format.
  • Tipe TypeScript lengkap: Setiap kelas, metode dan opsi diketikkan dengan noImplicitAny dan strictNullChecks.

Dimana Aspose.3D FOSS dapat digunakan

  • ** Pipelines aset Node.js:** Impor file OBJ, validasi dan re-orientasi geometri, dan ekspor sebagai GLB di CI.
  • Pengerjaan alat permainan: Proses batch 3D tanpa mesin asli atau renderer.
  • Larus kerja pencetakan 3D: Membaca, memvalidasi dan mengekspor kembali file STL dan 3MF.
  • ** Backend tanpa server:** Jalankan titik akhir konversi 3D di Lambda atau Cloud Functions.
  • Migrasi konten: Konversi antara keluarga format dalam skala dari satu skrip.

Pilihan Per-format dan Kontrol Koordinat

  • ** Orientasi sistem koordinat:** Putar sumbu dan atur skala per format dengan kelas pilihan.
  • Normal normalization: Normalkan secara otomatis normal vertex pada saat loading atau save.
  • Keluaran biner vs JSON: Pilih GLB kompak atau glTF yang dapat dibaca melalui GltfSaveOptions.
  • ** Kontrol pemuatan material:** Aktifkan atau matikan pemutaran MTL/tekstur untuk analisis yang lebih cepat.
  • Ketekunan perjalanan: Node grafik adegan yang tidak diketahui dipertahankan secara harfiah pada penghemat ulang.

Pengalaman Pengembang

Aspose.3D FOSS for TypeScript menginstal dengan satu perintah npm install @aspose/3d. Tidak ada addon asli untuk dikompilasi. Perpustakaan adalah murni Type Script / JavaScript dengan salah satu ketergantungan yang diinstal secara otomatis (xmldom).

API yang diketik dengan kuat menyediakan autocomplete IDE penuh untuk setiap kelas dan opsi format scene-graph. Perpustakaan menargetkan Node.js 1822+ dan TypeScript 5.0+, berjalan secara identik pada Linux CI runner dan developer workstation, dan berlisensi MIT dengan pelacak masalah terbuka di GitHub .

Mengunggah OBJ Scene dan Ekspor sebagai glTF

Install dengan npm, lalu gunakan scene.open() dengan ObjLoadOptions untuk memuat mesh bersama file material MTL-nya. Kedua open() dan save() adalah sinkron tidak ada await atau Promise chaining diperlukan. Menghubungi scene.save() menggunakan ekstensi .gltf menulis standar glTF 2.0 JSON ?? format disimpulkan secara otomatis dari eksensi 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");

Mengkonversi STL ke GLB biner

Untuk menghasilkan GLB biner kompak bukan JSON glTF default, kirimkan GltfSaveOptions dengan binaryMode = true. Kedua open() dan save() adalah 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 berlisensi MIT gratis untuk memuat, memanipulasi, dan menyimpan adegan 3D tanpa menginstal addon asli atau SDK eksternal apa pun.

Format 3D mana yang didukung?

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

Apakah itu membutuhkan addon Node.js asli?

Tidak. Aspose.3D FOSS untuk TypeScript adalah JavaScript/TypeScript murni. Ini tidak memerlukan langkah kompilasi dan memiliki satu ketergantungan runtime (xmldom) yang dipasang secara otomatis oleh npm.

Bagaimana cara saya menginstalnya?

Run npm install @aspose/3d. Tidak diperlukan paket sistem tambahan atau addon asli.

Versi Node.js dan TypeScript mana yang didukung?

Node.js 18, 20, dan 22+. TypeScript 5.0+. Perpustakaan mengkompilasi ke CommonJS dan bekerja dengan pengaturan Type Script yang ketat.

Apakah itu dikirim dengan definisi tipe TypeScript?

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

Bisakah aku mengontrol orientasi sistem koordinat?

Ya. Per-format opsi kelas seperti ObjLoadOptions dan GltfSaveOptions memungkinkan Anda memutar sumbu, menyesuaikan skala, dan normalisasi normal tanpa kode parsing khusus.

Dimana aku bisa menemukan kode sumbernya?

Perpustakaan ini dilisensikan oleh MIT dan dihosting di GitHub. Laporan bug dan permintaan pull disambut dengan baik.

  

Sumber Daya Dukungan dan Pembelajaran

 Bahasa Indonesia