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.

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 adegan yang 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 binari (bahan PBR), STL (binari dan ASCII, pusingan penuh), COLLADA (DAE), 3MF, dan FBX. Kelas pilihan per-format seperti ObjLoadOptions dan GltfSaveOptions memberikan kawalan tepat ke atas orientasi sistem koordinat, skala, normalisasi normal, output binari vs JSON, dan pemuatan bahan.

Aspose.3D FOSS menyasarkan Node.js 18, 20, dan 22+ dengan TypeScript 5.0+ serta disusun ke CommonJS. Perpustakaan ini disertakan 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.

Sokongan Format 3D dan API Graf Adegan Berjenis

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

Di mana Aspose.3D FOSS boleh digunakan

  • Saluran aset Node.js: Import fail OBJ, sahkan dan alihkan semula orientasi geometri, dan eksport sebagai GLB dalam CI.
  • Alat permainan: Proses kumpulan mesh 3D tanpa enjin atau perender asli.
  • Alur kerja percetakan 3D: 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 secara besar-besaran dari satu skrip.

Pilihan Per-Format dan Kawalan Koordinat

  • Orientasi sistem koordinat: Balikkan paksi dan laraskan skala mengikut format dengan kelas pilihan.
  • Normalisasi normal: Secara automatik menormalkan normal verteks semasa muat atau simpan.
  • Output binari vs. JSON: Pilih GLB yang padat atau glTF yang boleh dibaca melalui GltfSaveOptions.
  • Kawalan pemuatan bahan: Aktifkan atau nyahaktifkan pemuatan MTL/tekstur untuk penguraian yang lebih cepat.
  • Kesetiaan pusingan balik: Nod grafik-pemandangan yang tidak dikenali dipelihara secara tepat semasa simpan semula.

Pengalaman Pembangun

Aspose.3D FOSS untuk pemasangan TypeScript dengan satu arahan npm install @aspose/3d. Tiada add‑on asli untuk disusun. Perpustakaan ini murni TypeScript/JavaScript dengan satu kebergantungan yang dipasang secara automatik (xmldom).

API berjenis kuat menyediakan auto lengkap IDE penuh untuk setiap kelas graf adegan dan pilihan format. Perpustakaan ini menyasarkan Node.js 18–22+ dan TypeScript 5.0+, beroperasi secara serupa pada pelari CI Linux dan stesen kerja pembangun, serta berlesen MIT dengan penjejak isu terbuka di GitHub.

Muatkan adegan OBJ dan Eksport sebagai glTF

Pasang dengan npm, kemudian gunakan kaedah scene.open() secara segerak dengan ObjLoadOptions untuk memuatkan mesh bersama fail bahan MTLnya. 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());

// Eksport sebagai 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.

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

Frequently Asked Questions

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 natif 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 Node.js asli?

Tidak. Aspose.3D FOSS untuk TypeScript adalah JavaScript/TypeScript tulen. Ia tidak memerlukan langkah kompilasi 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 natif diperlukan.

Versi Node.js dan TypeScript yang disokong?

Node.js 18, 20, dan 22+. TypeScript 5.0+. Perpustakaan ini dikompil 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 menukar paksi, menyesuaikan skala, dan menormalkan normal tanpa kod penguraian tersuai.

Di mana saya boleh menemui kod sumber?

Perpustakaan ini berlesen MIT dan dihoskan di GitHub. Laporan pepijat dan permintaan tarik (pull request) dialu‑alukan.

  

Sokongan dan Sumber Pembelajaran

 Bahasa Melayu