Aspose.3D FOSS for TypeScript
API-reference for: @aspose/3d version af 24.12.0.Installering via:
npm install @aspose/3dRuntime: Node.js 18, 20, 22+ · Sprog: TypeScript 5.0+ / JavaScript (CommonJS) · Licens: MIT
Grafik af kernen
Scenen
- Rødtæsken til en 3D-scene.
scene.open()eller en andenscene.openFromBuffer()at indlæse en fil, ogscene.save()at skrive output.scene.rootNodesom indgangspunktet til knudehierarkiet.
Knudepunkt
En navngivet knude i scenen træ. Transform, en valgfri entity (magt, kamera, lys eller andre former for belysning) SceneObject), og nul eller flere underknob, der er tilgængelige via childNodes.
Enhed
Basisklasse for alle objekter, der kan vedhæftes en Node som dets primære enhed. Underklassificeret ved: Mesh, Camera, Light, og andre.
SceneObject
Abstrakt basis for navngivne objekter, der tilhører en scene. name ejendoms- og scenemedlemskabssporing, der deles af knudepunkter, enheder og objekter på aktivniveau.
A3DOobjekt
Root-basisklassen for alle Aspose.3D-objekter. Tilvejebringer ejendomssystemet (getProperty, setProperty) og den name Det er en del af det offentlige.
Geometri og net
Målnettet
Repræsenterede et polygonnet. controlPoints række af Vector4 De er ikke i stand til at anvende de samme metoder. createPolygon().Ring til mig. triangulate() at konvertere alle polygoner til trekant inden eksport.
Geometri
Baseklasse for alle geometrityper. controlPoints og samling af topelementer (normale, UV-stråler, farver) knyttet til geometrien.
VertexElement
Basisklasse for pervertex-attributkanaler, der er knyttet til en Geometry.Underklasser indeholder typede datamater og mappingMode / referenceMode metadata.
VertexElementNormal
A. Det er ikke muligt. VertexElement Underklasse, der gemmer overfladenormaler. Data lagres internt som: FVector4[] (ervervet fra VertexElementFVector) kræves af de fleste renderere for korrekt belysning.
VertexElementUV
A. Det er ikke muligt. VertexElement En enkelt mask kan have flere UV-sæt for forskellige teksturslag.
VertexElementVertexColor
A. Det er ikke muligt. VertexElement underklasse, der gemmer farveværdier for RGBA per vertex.
VertexElementType
Oplysninger om de kanaltyper, som en VertexElement kan repræsentere (f.eks., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).
MappingMode
Enumerering, der styrer hvordan elementdata maps til geometri: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,eller ALL_SAME.
ReferenceMode
Enumerering, der styrer elementindekset i referencedata: DIRECT (en mod en) eller INDEX_TO_DIRECT (via et indeksarray).
TextureMapping
Oplysninger om teksturkanalsemantik: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, og mere.
Transform og rumlig
Transformation
Besidder den lokale position (translation), rotation (rotation som: Quaternion), og skala (scaling) af en Node.Ændringer her påvirker knuden og alle dens børn.
GlobalTransform
Kun læsevisning af en nodes verdensrumstransform, beregnet ved at akkumulere alle forfædre Transform Indtastning via node.globalTransform.
BoundingBox
En akselignet afgrænsende kasse defineret ved en minimum og: maximum ØvrigeVector3 Bruges til at beskrive den rumlige udstrækning af et net eller en scene.
Materialer
Materiale, LambertMaterial,PhongMaterial og PbrMaterial
Material er den abstrakte basisklasse for alle materiale typer. Der findes tre konkrete implementeringer:
- LambertMaterial Kun diffus med omgivende, diffuse og emissionskærmkanaler.
- PhongMaterial udstrækker sig
LambertMaterialmed specular farve og glans egenskaber for Phong skygge. - PbrMaterial Fysisk baseret renderingsmateriale med metal-, grovheds-, basisfarve- og normalkartransportkanaler. Kortlægning direkte til glTF 2.0 PBR-materialsmodellen.
Kamera og belysning
Kameraer
En synspunktsknude enhed med projektionstype, synsfelt, nær/lang klip afstand og sideforholdsegenskaber.
Lys
En lyskilde-nodes enhed. Typen styres af den LightType opgørelse.
LightType
Oplysninger om de understøttede lystyper: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionType
Opgørelse af kameraets projektionstilstande: PERSPECTIVE og: ORTHOGRAPHIC.
Matematiske værktøjer
Vector3
En trekomponent flyvende punktvektor med x, y, z Feltet og de almindelige aritmetiske metoder (dot, cross, normalize, minus, times) Eksporteret fra @aspose/3d/utilities.
Vector4
En firekomponent flyvende punktvektor med x, y, z, w Feltet anvendes som typeindtægter i Mesh.controlPoints.
Vector2
En to-komponent dobbeltpræcisionsvektor med x og: y Bruges til at bestemme UV-strukturkoordinater.
Fvektor3
En kompakt trekomponent enkelpræcision float-vektor, der anvendes i topelementdataarrays til normaler og tangenter.
Matrix4
En 4×4 transformationsmatrix. Understøtter sammenkædning, inversion, transposition og nedbrydning til translation, rotation og skala komponenter. Eksporteret fra @aspose/3d/utilities.
Kvaternjon
En enhedskvaternjon til repræsentation af rotationer uden gimballås. slerp() til glat interpolation og omregning fra/til Eulers vinkler, samt Matrix4.Eksport fra: @aspose/3d/utilities.
Animation
AnimationClip
En navngivet, tidsbegrænset samling af AnimationNode Den primære container til keyframe animationsdata, der er indlæst fra FBX- eller COLLADA-filer.
AnimationNode
Et navngivet animationsspor, der målretter en specifik ejendomsvej på et sceneobjekt. Indeholder ét eller flere AnimationChannel genstande.
AnimationChannel
En enkelt animeret ejendomskanal inden for en AnimationNode.- Hænder en … KeyframeSequence af tids-/værdipar.
KeyFrame
En enkelt tid/værdiprøve i en KeyframeSequence.Medfører tidsstemplet (i sekunder), værdien og tangenten information til interpolering.
KeyframeSequence
En rækkefølge over: KeyFrame Prøverne for en ejendomskanal sammen med den Interpolation og: Extrapolation indstillinger, der regulerer afspilning.
Interpolering
Oplysninger om keyframe interpoleringsmodusser. Kendte medlemmer omfatter: LINEAR og: CONSTANT.Yderligere medlemmer som f.eks. BEZIER kan være tilgængelige.
Ekstrapolation
Definerer adfærd uden for nøgleframe-området (før den første og efter den sidste nøgleslængde). Kontrolleres af ExtrapolationType.
StepMode
En opgørelse, der styrer, hvordan trinvis (konstant) interpolering anvendes ved grænser.
WeightedMode
Antal for håndtering af Bezier tangentvægt: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT,eller BOTH.
ExtrapolationType
Overskuddsforekomster: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, og OSCILLATE.
Format I/O
FileFormat
Basiskritikør for et 3D-filformat. Hvert understøttet format giver en konkret singleton via getInstance().
Importør
Basisklasse til format-specifikke importimplementeringer. Ikke direkte instancieret; indkaldt internt af scene.open().
Eksporterende producent
Basisklasse for format-specifikke eksportimplementeringer. Ikke direkte instancieret; indkaldt internt af scene.save().
LoadOptions
Basisklasse for format-specifikke indlæsesmuligheder. Overfør en underklasseinstans til scene.open() eller en anden scene.openFromBuffer().
SaveOptions
Basisklasse for format-specifikke opslagsalternativobjekter. Pass en underklasseinstance til scene.save().
- Jeg er ikke i gang.
Interne servicestjenester, der giver et abstrakt filsystem og bufferind-/udgående oplysninger til importører og eksportører.
OBJ-format
OBJ understøtter både import og eksport. Når man gemmer som OB J, kan materialet biblioteket (.mtl) skrives automatisk sammen med den .obj - Filer.
ObjImporter
Interne importører, der læser Wavefront-OBJ-filer, løser .mtl Det er et vigtigt element i den europæiske integration. Scene.Automatisk indkaldt, når: ObjLoadOptions er overført til: scene.open().
ObjExporter
En intern eksportør, der skriver Wavefront OBJ-filer. .mtl Det er et vigtigt element i den europæiske forskningsproces, at man kan gøre det muligt for alle. scene.save() mål og .obj vej.
ObjLoadOptions
Optioner til indlæse af OBJ-filer.: enableMaterials (boolean, standard) true), flipCoordinateSystem (boolean), normalizeNormal (boolean, standard) true), scale (nummer) Se Format indlæse og gemme muligheder for alle detaljer.
ObjSaveOptions
Optimering til OBJ-eksport. scene.save() til at styre OBJ-udgangsadfærd. Se Format indlæse og gemme muligheder for alle detaljer.
ObjFormat
Format descriptor singleton for OBJ. Begge dele canImport og: canExport er: true.
glTF-format
GltfImporter
Læser glTF 2.0 JSON (.gltf) og binær GLB (.glbDet er en del af et system, der kan bruges til at få indbyggede og eksterne bufferreferencer, PBR-materialer, skins og animationsklipp.
GltfExporter
Skrive glTF 2.0 udgang. GltfSaveOptions.binaryMode er: true, producerer en selvstændig GLB; ellers skriver den et JSON-program. .gltf med en ven, .bin - Buffer.
GltfLoadOptions
Ladeindstillinger for glTF/GLB-filer. Kontrollerer bufferopløsning og tekstur indlæses adfærd.
GltfSaveOptions
Optimering til eksport af glTF/GLB: Bemærkelsesværdige egenskaber: binaryMode (boolean, true → GLB, standard false), flipTexCoordV (boolean, skifter UV-linjeaksen som standard) true) Se også: Format indlæse og gemme muligheder for alle detaljer.
GltfFormat
Format descriptor singleton. Få via GltfFormat.getInstance() og overgå til: scene.save() som det andet argument.
STL-format
StlImporter
Læser både ASCII og binære STL-filer i en Scene med et enkelt indhold af: Mesh enhed.
StlExporter
Skriv binær STL. Udgangen indeholder den triangulerede mesh fra scenen; ikke-triangel polygoner trianguleres automatisk.
StlLoadOptions
Lådeindstillinger for STL: Kontrolleres, om importøren vender normalen under importen.
StlSaveOptions
Optimering til STL-eksport.: binaryMode (boolean, standard) false) Kontrollerer, om output er ASCII eller binær STL. Se Format indlæse og gemme muligheder for alle detaljer.
StlFormat
Format descriptor singleton. Få via StlFormat.getInstance().
3MF Format
ThreeMfImporter
Læser 3MF-arkiver og fylder en Scene med nettobjekter, farver og materialeegenskaber.
ThreeMfExporter
Skrive et gyldigt 3MF-arkiv fra den aktuelle scene.
ThreeMfLoadOptions
Indlæsningsalternativer for 3MF-filer.
ThreeMfSaveOptions
Optioner til 3MF-eksport.
ThreeMfFormat
Format descriptor singleton. Få via ThreeMfFormat.getInstance().
FBX-format
FbxImporter
Læser ASCII FBX-filer, herunder geometri, materialer og animationsklipp. Kun AS CII fbx; binær fbX er endnu ikke implementeret Skeleton og blendform import også ikke er implementerede i den nuværende version.
FbxExporter
Skrive ASCII FBX-udgang kun fra den aktuelle scene. Binær FBx-eksport er ikke tilgængelig i den nuværende version.
FbxLoadOptions
Ladeindstillinger til FBX. I den nuværende version er der ingen konfiguration af format-specifikke indlæsningsmuligheder (skin og blend-form import ikke implementeret).
FbxSaveOptions
Optimering til FBX-eksport.: embedTextures (boolean, standard) false) Se også: Format indlæse og gemme muligheder for alle detaljer.
FbxFormat
Format descriptor singleton. Få via FbxFormat.getInstance().
COLLADA Format
COLLADA indførsel og eksport kræver, at de nationale myndigheder skal udarbejde en oversigt over alle de relevante oplysninger.
xmldomPeer-afhængighed, som installeres automatisk med@aspose/3d.
ColladaImporter
Det lyder COLLADA (.dae) XML-filer, der bruger xmldom.Hanterer geometri, materialer, kameraer, lys og animation.
ColladaExporter
Skrive COLLADA XML-udgang fra den aktuelle scene. Velegnet til udveksling med DCC værktøjer (Blender, Maya osv.).
ColladaFormat
Format descriptor singleton. Få via ColladaFormat.getInstance().
Egenskabernes system
Ejendomme
Et indskrevet navn/værdipar, der kan vedhæftes til enhver A3DObject.Understøtter skalær- og vektorværdietyper.
PropertyCollection
En bestilt beholder af: Property Tilgængelig på alle sider. A3DObject via den properties Tilbehør.
CustomObject
En friformet ejendomspose, der strækker sig over A3DObject.Bruges til at gemme vilkårlige metadata, der ikke er tilpasset en standardklasse.
Aktivinformation
AssetInfo
Medfører metadata på scenen niveau, der er indlæst fra kildedataen: forfatter, applikationsnavn, oprettelsesdato, enhedsskala og koordinatakse-oplysninger.
ImageRenderOptions
Alternativer til styring af, hvordan teksturer og billeder opløses og kodes, når de gemmes i formater, der indlejrer billeddata (f.eks. GLB med binaryMode: true).
Se også:
- Vidensgrundlag: Vejledninger
- Detaljeret oversigt over API’er
- Scene klasse
- Knoldeklasse
- Målklasse
- Transformationsklasse
- Klasse BoundingBox
- Kamera klasse
- Lægeklasse
- Vektor3 klasse
- Klasse Quaternion
- Matrix4-klasse
- Klasse BoundingBox
- Materiale, LambertMaterial,PhongMaterial og PbrMaterial
- Format indlæse og gemme muligheder
- Vector2, Vectortal
- Ejendomme, PropertyCollection,AssetInfo reference
- A3DOobjekt, SceneObject, Reference til enhed
- VertexElement, VertexElementNormal og VertexElementUV-reference
- Reference til optegnelser
- npm: @aspose/3d
- GitHub: Aspose.3D FOSS til TypeScript