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

Aspose.3D FOSS untuk TypeScript

Muat, bina, ubah, dan eksport adegan 3D dari Node.js — berjenis penuh, sumber terbuka, dan sedia untuk produksi dengan satu pemasangan npm.

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

Belajar GitHub

Perpustakaan TypeScript Sumber Terbuka untuk Pemprosesan Fail 3D

Aspose.3D FOSS untuk TypeScript ialah perpustakaan berlesen MIT untuk bekerja dengan format fail 3D dalam aplikasi Node.js. Pasang ia dengan satu arahan npm install @aspose/3d dan mulakan membaca, membina, serta menulis adegan 3D dalam TypeScript serta-merta, tanpa addon asli untuk disusun, tanpa SDK luaran untuk dipasang, dan tanpa renderer diperlukan.

Perpustakaan ini memaparkan API graf-skena berjenis penuh yang dibina di sekitar Scene, Node, Entity, Mesh, Camera, Light, dan Transform, model konseptual yang sama digunakan oleh alat 3D profesional. Sokongan format termasuk OBJ (Wavefront, dengan pemuatan bahan .mtl), glTF 2.0 dan GLB binary (bahan PBR), STL (binary dan ASCII, full roundtrip), COLLADA (DAE), 3MF, dan FBX. Kelas pilihan per-format seperti ObjLoadOptions dan GltfSaveOptions memberikan kawalan tepat ke atas orientasi sistem koordinat, skala, normalisasi normal, binary vs. JSON output, dan pemuatan bahan.

Aspose.3D FOSS menyasarkan Node.js 18, 20, dan 22+ dengan TypeScript 5.0+ dan menyusun ke CommonJS. Pustaka ini dihantar dengan tetapan pemalam TypeScript yang ketat (noImplicitAny, strictNullChecks) supaya IDE anda menyediakan autolengkap penuh dan keselamatan masa kompilasi. Kebergantungan masa jalan tunggalnya, xmldom, dipasang secara automatik. Untuk keluarga produk perusahaan, lihat Aspose.3D — Enterprise Product Family.

Sokongan Format 3D dan API Graf Adegan Berjenis

  • OBJ / MTL: Muatkan fail Wavefront OBJ dengan definisi bahan yang disertakan.
  • glTF 2.0 / GLB: Pemuatan bahan PBR dan output binari GLB melalui GltfSaveOptions.
  • STL: Baca dan tulis kedua-dua STL binari dan ASCII dengan pengesahan pusingan penuh.
  • COLLADA, 3MF, FBX: Sokongan format tambahan dengan kelas pilihan per-format.
  • Jenis TypeScript Penuh: Setiap kelas, kaedah, dan pilihan dipastikan jenisnya kuat dengan noImplicitAny dan strictNullChecks.

Di mana Aspose.3D FOSS Boleh Digunakan

  • Node.js asset pipelines: Import fail OBJ, sahkan dan ubah orientasi semula geometri, dan eksport sebagai GLB dalam CI.
  • Game tooling: Proses secara pukal mesh 3D tanpa enjin atau perender asli.
  • 3D printing workflows: Baca, sahkan, dan eksport semula fail STL dan 3MF.
  • Backend tanpa pelayan: Jalankan titik akhir penukaran 3D dalam Lambda atau Cloud Functions.
  • Migrasi kandungan: Tukar antara keluarga format pada skala besar dari satu skrip.

Pilihan Per-Format dan Kawalan Koordinat

  • Orientasi sistem koordinat: Balikkan paksi dan sesuaikan skala mengikut format dengan kelas pilihan.
  • Normal normalization: Secara automatik menormalkan normal verteks semasa memuat atau menyimpan.
  • Binari vs. JSON output: Pilih GLB yang padat atau glTF yang boleh dibaca melalui GltfSaveOptions.
  • Material loading control: Aktifkan atau nyahaktifkan pemuatan MTL/texture untuk penguraian yang lebih cepat.
  • Kesetiaan pusingan semula: Nod grafik-pemandangan yang tidak diketahui dipelihara secara verbatim semasa simpan semula.

Pengalaman Pembangun

Aspose.3D FOSS untuk TypeScript dipasang dengan satu arahan npm install @aspose/3d. Tiada addon asli untuk disusun. Pustaka ini adalah TypeScript/JavaScript tulen dengan satu kebergantungan yang dipasang secara automatik (xmldom).

API berjenis kuat menyediakan auto lengkap IDE penuh untuk setiap kelas graf-skena dan pilihan format. Perpustakaan ini menyasarkan Node.js 18–22+ dan TypeScript 5.0+, berjalan secara identik pada pelari CI Linux dan stesen kerja pembangun, dan MIT-licensed dengan open issue tracker di GitHub.

Muatkan Adegan OBJ dan Eksport sebagai glTF

Pasang dengan npm, kemudian gunakan scene.open() dengan ObjLoadOptions untuk memuatkan mesh bersama dengan fail bahan MTLnya. Kedua-dua open() dan save() adalah serentak — tidak diperlukan await atau penambatan Promise. Memanggil scene.save() dengan sambungan .gltf menulis JSON glTF 2.0 standard — format akan ditentukan secara automatik daripada sambungan fail.

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");

Tukar STL kepada Binary GLB

Untuk menghasilkan GLB binari yang padat dan bukannya glTF JSON lalai, berikan GltfSaveOptions dengan binaryMode = true. Kedua-dua open() dan save() bersifat serentak — tiada await diperlukan.

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);

Soalan Lazim

Apakah Aspose.3D FOSS untuk TypeScript?

Ia adalah perpustakaan TypeScript/Node.js percuma, berlesen MIT, untuk memuatkan, memanipulasi, dan menyimpan adegan 3D tanpa memasang sebarang add‑on asli atau SDK luaran.

Format 3D mana yang disokong?

OBJ (dengan .mtl), glTF 2.0 dan GLB, STL (binari dan ASCII), COLLADA (DAE), 3MF, dan FBX. Setiap format mempunyai kelas pilihan berjenis khusus.

Adakah ia memerlukan add-on native Node.js?

Tidak. Aspose.3D FOSS untuk TypeScript adalah JavaScript/TypeScript tulen. Ia tidak memerlukan langkah penyusunan dan mempunyai satu kebergantungan masa jalan (xmldom) yang dipasang secara automatik oleh npm.

Bagaimana saya memasangnya?

Jalankan npm install @aspose/3d. Tiada pakej sistem tambahan atau add-on asli yang diperlukan.

Versi Node.js dan TypeScript mana yang disokong?

Node.js 18, 20, dan 22+. TypeScript 5.0+. Pustaka ini disusun ke CommonJS dan berfungsi dengan tetapan TypeScript yang ketat.

Adakah ia disertakan dengan definisi jenis TypeScript?

Ya. Semua kelas, kaedah, enum, dan jenis pilihan telah ditaip sepenuhnya dengan noImplicitAny dan strictNullChecks diaktifkan.

Bolehkah saya mengawal orientasi sistem koordinat?

Ya. Kelas pilihan per-format seperti ObjLoadOptions dan GltfSaveOptions membolehkan anda memutar paksi, menyesuaikan skala, dan menormalkan normal tanpa kod penguraian tersuai.

Di mana saya boleh menemui kod sumber?

Pustaka ini berlesen MIT dan dihoskan di GitHub. Laporan pepijat serta permintaan tarik (pull requests) dialu‑alkan.

  

Sokongan dan Sumber Pembelajaran

 Bahasa Melayu