Balíček: @aspose/3d (v24.12.0) Jazyk: TypeScript / Node.js 18+ Licence: MIT
@aspose/3d je knihovna licencovaná pod MIT pro čtení, vytváření a export 3D scén v Node.js. Dodává se s kompletními typovými definicemi TypeScript, jednou runtime závislostí (xmldom), a podporuje sedm hlavních 3D formátů souborů. Veškerý I/O je synchronní. Nativní doplňky nejsou vyžadovány.
Properties
Properties tsconfig.json nastavení pro správné rozlišení podcesty:
Referenční příručka API pro podporu zástupných znaků v Aspose.Slides FOSS pro C++. Tvary zástupných polí definují obsahové oblasti v rozvržení a šablonách snímků.
Properties
Kořenový kontejner pro 3D scénu. Veškerý obsah; uzly, geometrie, materiály a animace; je uložen ve stromu s kořenem v scene.rootNode.Použijte open() / openFromBuffer() k načtení souboru a save() / saveToBuffer() k exportu.
| Properties | Properties | Properties |
|---|
rootNode | Node | Kořen grafu scény |
assetInfo | AssetInfo | Metadata souboru (tvůrce, jednotky, souřadnicový systém) |
animationClips | AnimationClip[] | Všechny animační klipy ve scéně |
open(path, opts?) | (string, LoadOptions?) → void | Načíst soubor z disku |
openFromBuffer(buf, opts?) | (Buffer, LoadOptions?) → void | Načíst z paměťového bufferu |
save(path, opts?) | (string, SaveOptions?) → void | Uložit na disk (formát odvozený od přípony) |
saveToBuffer(ext, opts?) | (string, SaveOptions?) → Buffer | Uložit do paměťového bufferu |
createAnimationClip(name) | (string) → AnimationClip | Vytvořit a zaregistrovat nový animační klip |
Properties
Pojmenovaný uzel stromu v grafu scény. Uzly nesou volitelný Entity (mesh, camera, light) a Transform který umisťuje uzel relativně k jeho rodiči.
| Properties | Properties | Properties |
|---|
name | string | Název uzlu |
childNodes | Node[] | Přímé podřízené uzly |
entity | `Entity | null` |
transform | Transform | Lokální posunutí, rotace, měřítko |
materials | Material[] | Materiály přiřazené tomuto uzlu |
createChildNode(name) | (string) → Node | Přidat podřízený uzel |
getChildNode(name) | `(string) → Node | null` |
Properties
Polygonová síť; primární typ geometrie. Rozšiřuje Geometry.
| Properties | Properties | Properties |
|---|
controlPoints | Vector4[] | Pozice vrcholů (w=1 pro pozice) |
polygonCount | number | Počet polygonů |
createPolygon(indices) | (number[]) → void | Přidat polygon (trojúhelník nebo čtyřúhelník) |
getElement(type) | `(VertexElementType) → VertexElement | null` |
createElement(type) | (VertexElementType) → VertexElement | Vytvořit prvek vrcholu |
Properties
Lokální transformace aplikovaná na uzel.
| Properties | Properties | Properties |
|---|
translation | Vector3 | Místní pozice |
eulerAngles | Vector3 | Eulerova rotace ve stupních (pořadí XYZ) |
rotation | Quaternion | Rotace jako kvaternion |
scaling | Vector3 | Místní měřítko |
Třídy materiálů
| Properties | Properties | Klíčové vlastnosti |
|---|
LambertMaterial | Difúzní + ambientní stínování | diffuseColor, ambientColor, transparency |
PhongMaterial | Přidává spekulární + emisivní k Lambertovi | specularColor, shininess, emissiveColor |
PbrMaterial | Fyzikálně založené pro glTF 2.0 | albedo, metallicFactor, roughnessFactor, emissiveColor |
Matematické třídy
| Properties | Properties |
|---|
Vector3 | 3-component double-precision vector (x, y, z) |
Vector4 | 4-component vector for homogeneous math (x, y, z, w) |
FVector3 | Varianta s jednoduchou přesností používaná v datech vrcholů |
Matrix4 | 4×4 transformation matrix; multiply, invert, decompose |
Quaternion | Rotace kvaternion; fromEulerAngle, toEulerAngles, slerp |
BoundingBox | Osa‑zarovnaný ohraničující box; minimum, maximum, center, size, merge |
Třídy animací
| Properties | Properties |
|---|
AnimationClip | Pojmenovaný klip; obsahuje AnimationNode seznam; přístupný přes scene.animationClips |
AnimationNode | Váže klip k pojmenovanému uzlu scény; obsahuje AnimationChannel seznam |
AnimationChannel | Cílí na jedinou vlastnost (např. posun X); obsahuje KeyframeSequence |
KeyframeSequence | Uspořádaný seznam KeyFrame objekty s interpolation a extrapolation |
KeyFrame | Jedna časová/hodnotová dvojice |
Properties
| Properties | Properties | Properties |
|---|
VertexElementType | NORMAL, UV, VERTEX_COLOR, BINORMAL, TANGENT | Semantika vrcholového elementu |
MappingMode | CONTROL_POINT, POLYGON_VERTEX, POLYGON, ALL_SAME | Jak data mapují na geometrii |
ReferenceMode | DIRECT, INDEX, INDEX_TO_DIRECT | Strategie indexování dat vrcholových elementů |
Interpolation | CONSTANT, LINEAR, BEZIER | Interpolace klíčových snímků |
Extrapolation | CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE | Chování mimo rozsah klíčových snímků |
Formátové moduly
Třídy možností specifické pro formát jsou exportovány z podcestových modulů. Importujte je samostatně:
Modul OBJ (@aspose/3d/formats/obj)
| Properties | Klíčové možnosti |
|---|
ObjLoadOptions | enableMaterials, flipCoordinateSystem, scale, normalizeNormal |
Modul glTF/GLB (@aspose/3d/formats/gltf)
| Properties | Klíčové možnosti |
|---|
GltfSaveOptions | binaryMode (true → .glb), flipTexCoordV |
GltfFormat | GltfFormat.getInstance(): instance formátu pro scene.save() |
Modul STL (@aspose/3d/formats/stl)
| Properties | Klíčové možnosti |
|---|
StlLoadOptions | N/A |
StlSaveOptions | binaryMode (false → ASCII, true → binary) |
Modul FBX (@aspose/3d/formats/fbx)
| Properties | Klíčové možnosti |
|---|
FbxLoadOptions | N/A |
FbxSaveOptions | embedTextures |
Podporované formáty
| Properties | Properties | Properties | Properties |
|---|
| Properties | .obj | Properties | Properties |
| glTF 2.0 | .gltf | Properties | Properties |
| Properties | .glb | Properties | Properties |
| STL | .stl | Properties | Properties |
| FBX | .fbx | Ne* | Ne* |
| COLLADA | .dae | Properties | Properties |
| 3MF | .3mf | Properties | Properties |
Rychlý referenční příklad
Viz také