Aspose.3D FOSS for TypeScript

API atsauce uz @aspose/3d versija 24.12.0. Instalējiet, izmantojot:

npm install @aspose/3d

Izpildlaiks: Node.js 18, 20, 22+ · Valoda: TypeScript 5.0+ / JavaScript (CommonJS) · Licence: MIT

Pamat Scēnas Grafiks

ImageRenderOptions

Saknes konteineris 3D ainas. Izsauciet scene.open() vai scene.openFromBuffer() lai ielādētu failu, un scene.save() lai rakstītu izvadi. Sniedz scene.rootNode kā ieejas punktu uz mezglu hierarhiju.

ImageRenderOptions

Nosaukts mezgls ainas kokā. Satur Transform, opcionalais entity (mesh, kamera, gaisma, vai cits SceneObject), un nulle vai vairāk bērnu mezgli, kas pieejami caur childNodes.

ImageRenderOptions

Bāzes klase visiem objektiem, kas var tikt pievienoti Node kā tās galvenā vienība. Apakšklases no Mesh, Camera, Light, un citi.

SceneObject

Abstrakts pamats nosauktajiem objektiem, kas pieder pie ainas. Nodrošina name īpašību un ainas piederības izsekošanu, ko koplieto mezgli, entītijas un līdzekļu līmeņa objekti.

A3DObject

Pamatklase visiem Aspose.3D objektiem. Nodrošina īpašību sistēmu (getProperty, setProperty) un name lauku, ko manto katra publiskā klase.

Ģeometrija un Tīkls

ImageRenderOptions

Attēlo daudzstūru režģi. Satur controlPoints masīvu ar Vector4 virsotnēm un daudzstūru definīcijām, kas izveidotas, izmantojot createPolygon(). Izsauc triangulate() lai pārvērstu visus daudzstūrus trīsstūros pirms eksportēšanas.

ImageRenderOptions

Bāzes klase visiem ģeometrijas tipiem. Satur controlPoints un virsotnes elementu kolekciju (normāles, UV, krāsas), kas pievienota ģeometrijai.

VertexElement

Bāzes klase per-virsotnes atribūtu kanāliem, kas pievienoti Geometry. Apakšklases satur tipizētus datu masīvus un mappingMode / referenceMode metadatus.

VertexElementNormal

A VertexElement apakšklase, kas saglabā virsmas normāles. Dati tiek glabāti iekšēji kā FVector4[] (mantots no VertexElementFVector). Nepieciešams vairumam renderētāju pareizai apgaismošanai.

VertexElementUV

A VertexElement apakšklase, kas saglabā 2D tekstūras koordinātas. Vienam režģim var būt vairāki UV komplekti dažādiem tekstūras slāņiem.

VertexElementVertexColor

A VertexElement apakšklase, kas glabā katras virsotnes RGBA krāsu vērtības.

VertexElementType

Uzskaitījums atribūtu kanālu veidiem, ko VertexElement var attēlot (piemēram,)., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Uzskaitījums, kas kontrolē, kā elementu dati tiek kartēti uz ģeometrijas: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, vai ALL_SAME.

ReferenceMode

Uzskaitījums, kas kontrolē, kā elementu indeksi atsaucas uz datiem: DIRECT (viens pret vienu) vai INDEX_TO_DIRECT (caur indeksa masīvu).

TextureMapping

Tekstūras kanālu semantikas uzskaitījums: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, un vairāk.

Transform un Spatial

ImageRenderOptions

Satur lokālo pozīciju (translation), rotāciju (rotation kā Quaternion), un mērogs (scaling) no a Node. Šeit veiktās izmaiņas ietekmē mezglu un visus tā bērnus.

GlobalTransform

Tikai lasāma skats uz mezgla pasaules telpas transformāciju, aprēķināta, uzkrājot visus priekšgājējus Transform vērtības. Piekļuve caur node.globalTransform.

BoundingBox

Axiālu līdzinātu ietvara kaste, kas definēta ar minimum un maximum Vector3 stūri. Lietots, lai aprakstītu telpisko apjomu tīklam vai aina.

ImageRenderOptions

Material, LambertMaterial, PhongMaterial, PbrMaterial

Material ir abstrakta bāzes klase visiem materiālu tipiem. Ir pieejamas trīs konkrētas implementācijas:

  • LambertMaterial — tikai difūzs ar apgaismojuma, difūza un emisijas krāsu kanāliem. Piemērots ne-spoguļveida virsmām.
  • PhongMaterial — paplašina LambertMaterial ar spoguļkrāsu un spīdīguma īpašībām Phong ēnošanai.
  • PbrMaterial — fiziski balstīts renderēšanas materiāls ar metāla, raupjuma, pamata krāsas un normālu kartes kanāliem. Tieši atbilst glTF 2.0 PBR materiāla modelim.

Kamera un apgaismojums

ImageRenderOptions

Skata punkta mezgla vienība ar projekcijas tipu, redzes leņķi, tuvā/attālās klipa attālumus un aspect ratio īpašībām.

ImageRenderOptions

Gaismas avota mezgla vienība. Tips tiek kontrolēts ar LightType enumerāciju.

LightType

Atbalstīto gaismas veidu enumerācija: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Kameras projekcijas režīmu enumerācija: PERSPECTIVE un ORTHOGRAPHIC.

Matemātikas utilītprogrammas

ImageRenderOptions

Trīs komponentu peldošā komata vektors ar x, y, z laukiem un parastajām aritmētikas metodēm (dot, cross, normalize, minus, times). Eksportēts no @aspose/3d/utilities.

ImageRenderOptions

Četri komponentu peldošā komata vektors ar x, y, z, w laukiem. Lietots kā ierakstu tips iekš Mesh.controlPoints.

ImageRenderOptions

Divu komponentu dubultas precizitātes vektors ar x un y laukiem. Lietots UV tekstūras koordinātām.

FVector3

Kompakts trīskomponentu vienkāršas precizitātes peldošā komata vektors, ko izmanto virsotnes elementu datu masīvos normālēm un tangentiem.

ImageRenderOptions

4×4 transformācijas matrica. Atbalsta savienošanu, inversiju, transponēšanu un dekompozīciju uz translācijas, rotācijas un mēroga komponentēm. Eksportēts no @aspose/3d/utilities.

ImageRenderOptions

Vienības kvaternions rotāciju attēlošanai bez gimbal lock. Nodrošina slerp() gludai interpolācijai un konvertēšanai uz/no Euler angles un Matrix4. Eksportēts no @aspose/3d/utilities.

ImageRenderOptions

AnimationClip

Nosaukta, laika ierobežota kolekcija no AnimationNode Primārais konteiner atslēgkadra animācijas datiem, kas ielādēti no FBX vai COLLADA failiem.

AnimationNode

Nosaukts animācijas celiņš, kas mērķē uz konkrētu īpašības ceļu uz ainas objekta. Satur vienu vai vairākus AnimationChannel objektus.

AnimationChannel

Viens animēts īpašības kanāls iekš AnimationNode. Satur KeyframeSequence laika/vērtības pāru.

KeyFrame

Viens laika/vērtības paraugs iekš KeyframeSequence. Satur laika zīmogu (sekundēs), vērtību un tangenta informāciju interpolācijai.

KeyframeSequence

Kārtots saraksts ar KeyFrame paraugiem vienam īpašības kanālam, kopā ar Interpolation un Extrapolation iestatījumiem, kas regulē atskaņošanu.

ImageRenderOptions

Atslēgkadra interpolācijas režīmu uzskaitījums. Zināmie locekļi ietver LINEAR un CONSTANT. Papildu locekļi, piemēram BEZIER var būt pieejams.

ImageRenderOptions

Definē uzvedību ārpus atslēgkadru diapazona (pirms pirmā atslēgas un pēc pēdējās atslēgas). Kontrolēts ar ExtrapolationType.

StepMode

Uzskaitījums, kas kontrolē, kā pakāpeniska (konstanta) interpolācija tiek piemērota robežās.

WeightedMode

Uzskaitījums Bezier tangenta svara apstrādei: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, vai BOTH.

ExtrapolationType

Izskaitījums ārpus diapazona uzvedībām: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, un OSCILLATE.

Formāta I/O

FileFormat

Bāzes apraksts 3D faila formātam. Katrs atbalstītais formāts nodrošina konkrētu vienību caur getInstance().

ImageRenderOptions

Bāzes klase formāta specifiskām importēšanas implementācijām. Netiek tieši instanceizēta; izsauc iekšēji caur scene.open().

ImageRenderOptions

Bāzes klase formāta specifiskām eksportēšanas implementācijām. Netiek tieši instanceizēta; izsauc iekšēji caur scene.save().

LoadOptions

Bāzes klase formāta specifiskiem ielādes opciju objektiem. Nodod apakšklases instance uz scene.open() vai scene.openFromBuffer().

SaveOptions

Bāzes klase formāta specifiskiem saglabāšanas opciju objektiem. Nodod apakšklases instance uz scene.save().

IOService

Iekšējā pakalpojuma saskarne, kas abstraktē failu sistēmas un bufera I/O importētājiem un eksportētājiem.

OBJ formāts

OBJ atbalsta gan importu, gan eksportu. Saglabājot kā OBJ, materiālu bibliotēka (.mtl) tiek automātiski rakstīta blakus .obj failam.

ObjImporter

Iekšējais importētājs, kas lasa Wavefront OBJ failus, atrisina .mtl materiālu bibliotēkas, un aizpilda Scene. Automātiski izsauc, kad ObjLoadOptions tiek nodots scene.open().

ObjExporter

Iekšējais eksportētājs, kas raksta Wavefront OBJ failus. Piederošais .mtl materiālu bibliotēka tiek rakstīta automātiski. Izsaukta, kad scene.save() mērķē uz .obj ceļš.

ObjLoadOptions

Ielādēt opcijas OBJ failiem. Galvenās īpašības: enableMaterials (boolean, noklusējuma true), flipCoordinateSystem (boolean), normalizeNormal (boolean, noklusējuma true), scale (number). Skatiet Formāta ielādes un saglabāšanas iespējas pilnīgai informācijai.

ObjSaveOptions

Saglabāt OBJ eksporta opcijas. Pārsūtīt uz scene.save() lai kontrolētu OBJ izvades uzvedību. Skatīt Formāta ielādes un saglabāšanas iespējas pilnīgām detaļām.

ObjFormat

Formāta deskriptora vienīgais objekts OBJ. Gan canImport un canExport ir true.

glTF formāts

GltfImporter

Lasa glTF 2.0 JSON (.gltf) un bināro GLB (.glb) faili. Apstrādā iegultas un ārējās bufera atsauces, PBR materiālus, ādas un animācijas klipus.

GltfExporter

Raksta glTF 2.0 izvadi. Kad GltfSaveOptions.binaryMode ir true, izveido pašpietiekamu GLB; citādi raksta JSON .gltf ar pavadīto .bin buferis.

GltfLoadOptions

Ielādes iespējas glTF/GLB failiem. Kontrolē bufera izšķirtspēju un tekstūru ielādes uzvedību.

GltfSaveOptions

Saglabāšanas iespējas glTF/GLB eksportam. Ievērojamas īpašības: binaryMode (boolean, true → GLB, noklusējums false), flipTexCoordV (boolean, apgriež UV vertikālo asi, noklusējums true). Skatīt Formāta ielādes un saglabāšanas iespējas pilnu informāciju.

GltfFormat

Formāta apraksta vienīgais objekts. Iegūst caur GltfFormat.getInstance() un nodod uz scene.save() kā otro argumentu.

STL formāts

StlImporter

Nolasīs gan ASCII, gan bināros STL failus uz Scene kas satur vienu Mesh vienību.

StlExporter

Raksta bināru STL. Izvade satur trīsstūrveida tīklu no skenes; ne‑trīsstūra daudzstūri tiek automātiski trīsstūrveidoti.

StlLoadOptions

Ielādes iespējas STL formātam. Nosaka, vai importētājs apgriež normāles importēšanas laikā.

StlSaveOptions

Saglabāšanas iespējas STL eksportam. Galvenā īpašība: binaryMode (boolean, noklusējums false). Kontrolē, vai izvade ir ASCII vai binārs STL. Skatīt Formāta ielādes un saglabāšanas iespējas pilnu informāciju.

StlFormat

Formāta apraksta vienīgais objekts. Iegūst caur StlFormat.getInstance().

3MF Format

ThreeMfImporter

Lasa Open Packaging Convention 3MF arhīvus un aizpilda a Scene ar mesh objektiem, krāsām un materiālu īpašībām.

ThreeMfExporter

Raksta derīgu 3MF arhīvu no pašreizējās skenes. Piemērots 3D drukāšanas darbplūsmām.

ThreeMfLoadOptions

Ielādes opcijas 3MF failiem.

ThreeMfSaveOptions

Saglabāšanas opcijas 3MF eksportam.

ThreeMfFormat

Formāta aprakstītāja singleton. Iegūst caur ThreeMfFormat.getInstance().

FBX formāts

FbxImporter

Lasa FBX bināros un ASCII failus, ieskaitot ģeometriju, materiālus, skeletus, blend formas un animācijas klipus.

FbxExporter

Raksta FBX failus no pašreizējās ainas. Atbalstīta gan binārā, gan ASCII FBX izvade, atkarībā no opcijām.

FbxLoadOptions

Ielādes opcijas FBX. Nosaka, vai tiek importēta animācija, ādas (skin) un blend formas.

FbxSaveOptions

Saglabāšanas iespējas FBX eksportam. Galvenā īpašība: embedTextures (boolean, noklusējuma false). Skatīt Formāta ielādes un saglabāšanas iespējas pilnīgām detaļām.

FbxFormat

Formāta apraksta vienīgais objekts. Iegūst caur FbxFormat.getInstance().

COLLADA formāts

COLLADA importēšana un eksportēšana prasa the xmldom peer atkarību, kas tiek instalēta automātiski kopā ar @aspose/3d.

ColladaImporter

Lasa COLLADA (.dae) XML failus, izmantojot xmldom. Apstrādā ģeometriju, materiālus, kameras, gaismas un animāciju.

ColladaExporter

Raksta COLLADA XML izvadi no pašreizējās ainas. Piemērots apmaiņai ar DCC rīkiem (Blender, Maya utt.).

ColladaFormat

Formāta aprakstītāja singleton. Iegūst caur ColladaFormat.getInstance().

Īpašību sistēma

ImageRenderOptions

Tipizēta nosaukuma/vērtības pāra, ko var pievienot jebkuram A3DObject. Atbalsta skalāru un vektoru vērtību tipus.

PropertyCollection

Kārtots konteineris, kas satur Property objektus. Pieejams jebkurā A3DObject caur properties piekļuves metodi.

CustomObject

Brīvformāta īpašību soma, kas paplašina A3DObject. Lietots, lai saglabātu patvaļīgu metadatu, kas neatbilst nevienai standarta klasei.

Aktīvu informācija

AssetInfo

Nes ainas līmeņa metadatus, kas ielādēti no avota faila: autors, lietojumprogrammas nosaukums, izveides datums, vienību mērogs un koordinātu ass informācija.

ImageRenderOptions

Iespējas, kas kontrolē, kā tekstūras un attēli tiek atrisināti un kodēti, saglabājot formātos, kas iekļauj attēlu datus (piemēram, GLB ar binaryMode: true).

Skatīt arī

 Latviešu