Aspose.3D FOSS for TypeScript

Rujukan API untuk @aspose/3d versi 24.12.0. Pasang melalui:

npm install @aspose/3d

Runtime: Node.js 18, 20, 22+ · Bahasa: TypeScript 5.0+ / JavaScript (CommonJS) · Lesen: MIT

Graf Adegan Teras

ImageRenderOptions

Bekas akar untuk adegan 3D. Panggil scene.open() atau scene.openFromBuffer() untuk memuatkan fail, dan scene.save() untuk menulis output. Mendedahkan scene.rootNode sebagai titik masuk ke hierarki nod.

ImageRenderOptions

Sebuah nod bernama dalam pokok adegan. Menyimpan satu Transform, pilihan entity (mesh, kamera, cahaya, atau lain-lain SceneObject), dan sifar atau lebih nod anak yang boleh diakses melalui childNodes.

ImageRenderOptions

Kelas asas untuk semua objek yang boleh dilampirkan kepada Node sebagai entiti utama. Disubkelaskan oleh Mesh, Camera, Light, dan lain-lain.

SceneObject

Asas abstrak untuk objek bernama yang tergolong dalam adegan. Menyediakan the name penjejakan sifat dan keahlian adegan yang dikongsi oleh nod, entiti, dan objek peringkat aset.

A3DObject

Kelas asas akar untuk semua objek Aspose.3D. Menyediakan sistem sifat (getProperty, setProperty) dan name medan yang diwarisi oleh setiap kelas awam.

Geometri dan Mesh

ImageRenderOptions

Mewakili mesh poligon. Mengandungi satu controlPoints array bagi Vector4 vertices dan definisi poligon yang dibuat melalui createPolygon(). Panggil triangulate() untuk menukar semua poligon kepada triangles sebelum dieksport.

ImageRenderOptions

Kelas asas untuk semua jenis geometri. Menyimpan controlPoints dan koleksi elemen vertex (normals, UVs, colors) yang dilampirkan pada geometri.

VertexElement

Kelas asas untuk saluran atribut per-vertex yang dilampirkan kepada Geometry. Subkelas membawa array data berjenis dan mappingMode / referenceMode metadata.

VertexElementNormal

Sebuah VertexElement subclass yang menyimpan normal permukaan. Data disimpan secara dalaman sebagai FVector4[] (warisan dari VertexElementFVector). Diperlukan oleh kebanyakan renderer untuk pencahayaan yang betul.

VertexElementUV

Sebuah VertexElement subclass yang menyimpan koordinat tekstur 2D. Satu mesh tunggal mungkin mempunyai pelbagai set UV untuk lapisan tekstur yang berbeza.

VertexElementVertexColor

A VertexElement subkelas yang menyimpan nilai warna RGBA per-vertex.

VertexElementType

Enumerasi jenis saluran atribut yang VertexElement boleh mewakili (contohnya,., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Enumerasi yang mengawal bagaimana data elemen dipetakan ke geometri: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, atau ALL_SAME.

ReferenceMode

Enumerasi yang mengawal bagaimana indeks elemen merujuk kepada data: DIRECT (satu-ke-satu) atau INDEX_TO_DIRECT (melalui tatasusunan indeks).

TextureMapping

Enumerasi semantik saluran tekstur: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, dan lain-lain.

Transform dan Spatial

ImageRenderOptions

Menyimpan kedudukan tempatan (translation), putaran (rotation sebagai Quaternion), dan skala (scaling) bagi satu Node. Perubahan di sini mempengaruhi nod dan semua anaknya.

GlobalTransform

Paparan baca-sahaja bagi transformasi ruang-dunia nod, dikira dengan mengumpulkan semua nenek moyang Transform nilai. Akses melalui node.globalTransform.

BoundingBox

Kotak sempadan berpaksi yang ditakrifkan oleh a minimum dan maximum Vector3 sudut. Digunakan untuk menerangkan jangkauan ruang sesuatu mesh atau adegan.

ImageRenderOptions

Bahan, LambertMaterial, PhongMaterial, PbrMaterial

Material ialah kelas asas abstrak untuk semua jenis bahan. Tiga pelaksanaan konkrit tersedia:

  • LambertMaterial — diffuse-only dengan saluran warna ambient, diffuse, dan emissive. Sesuai untuk permukaan bukan spekular.
  • PhongMaterial — meluaskan LambertMaterial dengan warna spekular dan sifat kilauan untuk pencahayaan Phong.
  • PbrMaterial — bahan rendering berasaskan-fizik dengan saluran logam, kekasaran, warna-asas, dan peta-normal. Dipetakan secara langsung ke model bahan glTF 2.0 PBR.

Kamera dan Pencahayaan

ImageRenderOptions

Entiti nod pandangan dengan jenis unjuran, medan pandangan, jarak klip dekat/jauh, dan sifat nisbah aspek.

ImageRenderOptions

Entiti nod sumber cahaya. Jenis dikawal oleh LightType enumerasi.

LightType

Enumerasi jenis cahaya yang disokong: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Enumerasi mod proyeksi kamera: PERSPECTIVE dan ORTHOGRAPHIC.

Utiliti Matematik

ImageRenderOptions

Vektor titik-apung tiga-komponen dengan x, y, z medan dan kaedah aritmetik umum (dot, cross, normalize, minus, times). Dieksport dari @aspose/3d/utilities.

ImageRenderOptions

Vektor titik-apung empat-komponen dengan x, y, z, w medan. Digunakan sebagai jenis entri dalam Mesh.controlPoints.

ImageRenderOptions

Vektor dwi-komponen berpresisi-dobel dengan x dan y medan. Digunakan untuk koordinat tekstur UV.

FVector3

Vektor titik apung tepat tunggal tiga komponen yang padat digunakan dalam tatasusunan data unsur verteks untuk normal dan tangen.

ImageRenderOptions

Matriks transformasi 4×4. Menyokong penyambungan, songsangan, transposisi, dan penguraian kepada komponen terjemahan, putaran, dan skala. Dieksport dari @aspose/3d/utilities.

ImageRenderOptions

Kuaternion unit untuk mewakili putaran tanpa kunci gimbal. Menyediakan slerp() untuk interpolasi lancar dan penukaran ke/dari sudut Euler serta Matrix4. Dieksport dari @aspose/3d/utilities.

ImageRenderOptions

AnimationClip

Koleksi bernama, berjangka masa bagi AnimationNode trek. Kontena utama untuk data animasi keyframe yang dimuatkan daripada fail FBX atau COLLADA.

AnimationNode

Trek animasi bernama yang menyasarkan laluan sifat khusus pada objek adegan. Mengandungi satu atau lebih AnimationChannel objek.

AnimationChannel

Saluran sifat teranimasi tunggal dalam satu AnimationNode. Menyimpan satu KeyframeSequence pasangan masa/nilai.

KeyFrame

Sampel masa/nilai tunggal dalam satu KeyframeSequence. Membawa cap masa (dalam saat), nilai, dan maklumat tangen untuk interpolasi.

KeyframeSequence

Senarai teratur bagi KeyFrame sampel untuk satu saluran sifat, bersama dengan Interpolation dan Extrapolation tetapan yang mengawal main balik.

ImageRenderOptions

Enumerasi mod interpolasi keyframe. Ahli yang diketahui termasuk LINEAR dan CONSTANT. Ahli tambahan seperti BEZIER mungkin tersedia.

ImageRenderOptions

Mendefinisikan kelakuan di luar julat keyframe (sebelum kunci pertama dan selepas kunci terakhir). Dikawal oleh ExtrapolationType.

StepMode

Enumerasi yang mengawal bagaimana interpolasi berperingkat (konstan) diterapkan pada sempadan.

WeightedMode

Enumerasi untuk pengendalian berat tangen Bezier: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, atau BOTH.

ExtrapolationType

Enumerasi tingkah laku di luar julat: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, dan OSCILLATE.

Format I/O

FileFormat

Penerangan asas untuk format fail 3D. Setiap format yang disokong menyediakan satu singleton konkrit melalui getInstance().

ImageRenderOptions

Kelas asas untuk pelaksanaan import khusus format. Tidak diinstanskan secara langsung; dipanggil secara dalaman oleh scene.open().

ImageRenderOptions

Kelas asas untuk pelaksanaan eksport khusus format. Tidak diinstanskan secara langsung; dipanggil secara dalaman oleh scene.save().

LoadOptions

Kelas asas untuk objek pilihan muat khusus format. Hantar contoh subkelas kepada scene.open() atau scene.openFromBuffer().

SaveOptions

Kelas asas untuk objek pilihan simpan khusus format. Hantar contoh subkelas kepada scene.save().

IOService

Antara muka perkhidmatan dalaman yang mengabstrakkan I/O sistem fail dan penimbal untuk pengimport dan pengeksport.

OBJ Format

OBJ menyokong import dan eksport. Apabila menyimpan sebagai OBJ, perpustakaan bahan (.mtl) ditulis secara automatik bersama-sama dengan .obj fail.

ObjImporter

Pengimport dalaman yang membaca fail Wavefront OBJ, menyelesaikan .mtl perpustakaan bahan, dan mengisi satu Scene. Dipanggil secara automatik apabila ObjLoadOptions dihantar kepada scene.open().

ObjExporter

Pengeksport dalaman yang menulis fail Wavefront OBJ. Satu rakan .mtl perpustakaan material ditulis secara automatik. Dipanggil apabila scene.save() menyasar satu .obj laluan.

ObjLoadOptions

Muat pilihan untuk fail OBJ. Sifat utama: enableMaterials (boolean, lalai true), flipCoordinateSystem (boolean), normalizeNormal (boolean, lalai true), scale (nombor). Lihat Pilihan Muat dan Simpan Format untuk butiran penuh.

ObjSaveOptions

Simpan pilihan untuk eksport OBJ. Serahkan kepada scene.save() untuk mengawal kelakuan output OBJ. Lihat Pilihan Muat dan Simpan Format untuk butiran penuh.

ObjFormat

Penerangan format singleton untuk OBJ. Kedua-duanya canImport dan canExport adalah true.

Format glTF

GltfImporter

Membaca JSON glTF 2.0 (.gltf) dan GLB binari (.glb) fail. Mengendalikan rujukan penimbal terbenam dan luaran, bahan PBR, kulit, dan klip animasi.

GltfExporter

Menulis output glTF 2.0. Apabila GltfSaveOptions.binaryMode adalah true, menghasilkan GLB yang berdiri sendiri; jika tidak menulis JSON .gltf dengan pendamping .bin buffer.

GltfLoadOptions

Opsyen muat turun untuk fail glTF/GLB. Mengawal resolusi penimbal dan kelakuan pemuatan tekstur.

GltfSaveOptions

Simpan pilihan untuk eksport glTF/GLB. Sifat penting: binaryMode (boolean, true → GLB, lalai false), flipTexCoordV (boolean, memutar paksi menegak UV, lalai true). Lihat Pilihan Muat dan Simpan Format untuk butiran penuh.

GltfFormat

Singleton penerangan format. Dapatkan melalui GltfFormat.getInstance() dan serahkan kepada scene.save() sebagai argumen kedua.

Format STL

StlImporter

Membaca kedua-dua fail STL ASCII dan binari ke dalam satu Scene yang mengandungi satu Mesh entiti.

StlExporter

Menulis STL binari. Output mengandungi mesh yang ditriangulasi daripada scene; poligon bukan segitiga akan ditriangulasi secara automatik.

StlLoadOptions

Pilihan muat naik untuk STL. Mengawal sama ada pengimport membalikkan normal semasa import.

StlSaveOptions

Pilihan simpan untuk eksport STL. Ciri utama: binaryMode (boolean, lalai false). Mengawal sama ada output adalah STL ASCII atau binari. Lihat Pilihan Muat dan Simpan Format untuk butiran penuh.

StlFormat

Penerangan format singleton. Dapatkan melalui StlFormat.getInstance().

3MF Format

ThreeMfImporter

Membaca arkib Open Packaging Convention 3MF dan mengisi satu Scene dengan objek mesh, warna, dan sifat bahan.

ThreeMfExporter

Menulis arkib 3MF yang sah daripada scene semasa. Sesuai untuk aliran kerja pencetakan 3D.

ThreeMfLoadOptions

Pilihan pemuatan untuk fail 3MF.

ThreeMfSaveOptions

Pilihan simpan untuk eksport 3MF.

ThreeMfFormat

Penerangan format singleton. Dapatkan melalui ThreeMfFormat.getInstance().

Format FBX

FbxImporter

Membaca fail FBX binari dan ASCII termasuk geometri, bahan, rangka, bentuk gabungan, dan klip animasi.

FbxExporter

Menulis fail FBX dari adegan semasa. Kedua‑dua output FBX binari dan ASCII disokong bergantung pada pilihan.

FbxLoadOptions

Pilihan pemuatan untuk FBX. Mengawal sama ada animasi, kulit, dan bentuk gabungan diimport.

FbxSaveOptions

Opsyen simpan untuk eksport FBX. Sifat utama: embedTextures (boolean, default false). Lihat Pilihan Muat dan Simpan Format untuk butiran penuh.

FbxFormat

Format descriptor singleton. Dapatkan melalui FbxFormat.getInstance().

Format COLLADA

Import dan eksport COLLADA memerlukan xmldom peer dependency, yang dipasang secara automatik dengan @aspose/3d.

ColladaImporter

Membaca COLLADA (.dae) fail XML menggunakan xmldom. Mengendalikan geometri, bahan, kamera, lampu, dan animasi.

ColladaExporter

Menulis output XML COLLADA dari adegan semasa. Sesuai untuk pertukaran dengan alat DCC (Blender, Maya, dll.).

ColladaFormat

Penerangan format singleton. Dapatkan melalui ColladaFormat.getInstance().

Sistem Sifat

ImageRenderOptions

Satu pasangan nama/nilai berjenis yang boleh dilampirkan kepada mana-mana A3DObject. Menyokong jenis nilai skalar dan vektor.

PropertyCollection

Bekas teratur bagi Property objek. Boleh diakses pada mana-mana A3DObject melalui properties akses.

CustomObject

Sebuah beg sifat bentuk bebas yang meluaskan A3DObject. Digunakan untuk menyimpan metadata sewenang-wenanya yang tidak dipetakan kepada kelas piawai.

Maklumat Aset

AssetInfo

Membawa metadata peringkat adegan yang dimuatkan dari fail sumber: pengarang, nama aplikasi, tarikh penciptaan, skala unit, dan maklumat paksi koordinat.

ImageRenderOptions

Pilihan yang mengawal bagaimana tekstur dan imej diselesaikan serta dikodkan semasa menyimpan ke format yang menyematkan data imej (contohnya, GLB dengan binaryMode: true).

Lihat Juga

 Bahasa Melayu