Aspose.3D FOSS for TypeScript

API-viite kohteelle @aspose/3d versio 24.12.0. Asenna seuraavasti:

npm install @aspose/3d

Suoritusaika: Node.js 18, 20, 22+ · Kieli: TypeScript 5.0+ / JavaScript (CommonJS) · Lisenssi: MIT

Ydinkohtausgrafiikka

ImageRenderOptions

Juuri­kontti 3D‑kohtaukselle. Kutsu scene.open() tai scene.openFromBuffer() ladata tiedoston, ja scene.save() kirjoittaa tulosteen. Paljastaa scene.rootNode soluhierarkian sisäänkäyntinä.

ImageRenderOptions

Nimetty solmu kohtauspuussa. Sisältää Transform, valinnainen entity (verkko, kamera, valo tai muu SceneObject), ja nolla tai useampia lapsisolmuja, jotka ovat saavutettavissa childNodes.

ImageRenderOptions

Perusluokka kaikille objekteille, jotka voidaan liittää Node ensisijaisena entiteettinä. Aliluokkina Mesh, Camera, Light, ja muita.

SceneObject

Abstrakti perusluokka nimetyille objekteille, jotka kuuluvat kohtaukseen. Tarjoaa the name ominaisuus- ja kohtausjäsenyyden seuranta, jota jakavat solmut, entiteetit ja resurssitasoiset objektit.

A3DObject

Juuriperusluokka kaikille Aspose.3D-objekteille. Tarjoaa ominaisuusjärjestelmän (getProperty, setProperty) ja name kenttä, jonka jokainen julkinen luokka perii.

Geometria ja verkko

ImageRenderOptions

Edustaa polygoniverkkoa. Sisältää controlPoints taulukon Vector4 kärkiä ja polygonimäärittelyjä, jotka on luotu createPolygon(). Kutsu triangulate() muuntaaksesi kaikki polygonit kolmioiksi ennen vientiä.

ImageRenderOptions

Perusluokka kaikille geometrialle. Sisältää controlPoints ja kokoelman kärki-elementeistä (normaalit, UV:t, värit), jotka on liitetty geometriaan.

VertexElement

Perusluokka per‑kärki attribuuttikanaville, jotka on liitetty Geometry. Aliluokat kantavat tyypitettyjä data‑taulukoita ja mappingMode / referenceMode metatietoja.

VertexElementNormal

A VertexElement aliluokka, joka tallentaa pintanormaalit. Data tallennetaan sisäisesti muodossa FVector4[] (peritty VertexElementFVector). Useimmille renderöijille vaaditaan oikean valaistuksen vuoksi.

VertexElementUV

A VertexElement aliluokka, joka tallentaa 2D-tekstuurikoordinaatit. Yhdellä meshillä voi olla useita UV-joukkoja eri tekstuurikerroksille.

VertexElementVertexColor

A VertexElement aliluokka, joka tallentaa per-vertex RGBA -väriarvot.

VertexElementType

Luettelo attribuuttikanavien tyypeistä, jotka a VertexElement voi edustaa (esim., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Enumeraatio, joka ohjaa, miten elementin data kartoitetaan geometriaan: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, tai ALL_SAME.

ReferenceMode

Enumeraatio, joka ohjaa, miten elementtien indeksit viittaavat dataan: DIRECT (yksi-yhteen) tai INDEX_TO_DIRECT (indeksi-taulukon kautta).

TextureMapping

Enumeraatio tekstuurikanavan semantiikasta: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, ja muuta.

Transform ja Spatial

ImageRenderOptions

Sisältää paikallisen sijainnin (translation), kierto (rotation kuin Quaternion), ja skaala (scaling) kohteelle Node. Muutokset vaikuttavat solmuun ja kaikkiin sen lapsiin.

GlobalTransform

Vain luku -näkymä solmun maailmanavaruuden muunnoksesta, joka lasketaan keräämällä kaikki esivanhemmat Transform arvot. Pääsy tapahtuu node.globalTransform.

BoundingBox

Akselikohtainen raja-alue, jonka määrittelee a minimum ja maximum Vector3 kulma. Käytetään kuvaamaan verkon tai kohtauksen tilallista laajuutta.

ImageRenderOptions

Material, LambertMaterial, PhongMaterial, PbrMaterial

Material on kaikkien materiaalityyppien abstrakti perusluokka. Saatavilla on kolme konkreettista toteutusta:

  • LambertMaterial — diffuse-only with ambient, diffuse, and emissive color channels. Sopiva ei-spekulaarisille pinnoille.
  • PhongMaterial — laajentaa LambertMaterial with specular color and shininess properties for Phong shading.
  • PbrMaterial — physically-based rendering material with metallic, roughness, base-color, and normal-map channels. Maps directly to the glTF 2.0 PBR material model.

Kamera ja Valaistus

ImageRenderOptions

Näkökenttäsolmuentiteetti, jossa on projektio-tyyppi, näkökenttä, lähi- ja kaukosäätimen etäisyydet sekä kuvasuhdeominaisuudet.

ImageRenderOptions

A light-source node entity. Type is controlled by the LightType enumeration.

LightType

Enumeration of supported light kinds: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Enumeration of camera projection modes: PERSPECTIVE and ORTHOGRAPHIC.

Matematiikkatyökalut

ImageRenderOptions

A three-component floating-point vector with x, y, z fields and common arithmetic methods (dot, cross, normalize, minus, times). Exported from @aspose/3d/utilities.

ImageRenderOptions

A four-component floating-point vector with x, y, z, w fields. Used as the type of entries in Mesh.controlPoints.

ImageRenderOptions

A two-component double-precision vector with x and y fields. Used for UV texture coordinates.

FVector3

Kompakti kolmen komponentin yksittäistarkkuusliukulukuvektori, jota käytetään vertex-elementtien data-taulukoissa normaalien ja tangenttien tallentamiseen.

ImageRenderOptions

4×4-muunnosmatriisi. Tukee yhdistämistä, kääntämistä, transponointia ja hajottamista translaatio-, rotaatio- ja skaalauskomponentteihin. Viety ulos lähteestä @aspose/3d/utilities.

ImageRenderOptions

Yksikkökvaternion, joka edustaa kiertoja ilman gimbal-lukkoa. Tarjoaa slerp() tasaiselle interpoloinnille ja muunnokselle Euler-kulmien välillä ja Matrix4. Viety ulos lähteestä @aspose/3d/utilities.

ImageRenderOptions

AnimationClip

Nimetty, aikarajoitettu kokoelma AnimationNode raitoja. Ensisijainen säiliö avainruutu-animaatiotiedoille, jotka on ladattu FBX- tai COLLADA-tiedostoista.

AnimationNode

Nimetty animointiraita, joka kohdistaa tietyn ominaisuuspolun kohtausobjektiin. Sisältää yhden tai useamman AnimationChannel objekteja.

AnimationChannel

Yksittäinen animoitu ominaisuuskanava, joka kuuluu AnimationNode. Sisältää KeyframeSequence aika/arvo-pareista.

KeyFrame

Yksittäinen aika/arvo-näyte, joka on KeyframeSequence. Sisältää aikaleiman (sekunteina), arvon sekä tangenttitiedot interpolointia varten.

KeyframeSequence

Järjestetty luettelo KeyFrame näytteitä yhdelle ominaisuuskanavalle, sekä Interpolation ja Extrapolation asetukset, jotka ohjaavat toistoa.

ImageRenderOptions

Luettelo avainruutujen interpolointitiloista. Tunnetut jäsenet sisältävät LINEAR ja CONSTANT. Lisäjäsenet, kuten BEZIER voi olla saatavilla.

ImageRenderOptions

Määrittelee käyttäytymisen avainruutujen alueen ulkopuolella (ennen ensimmäistä avainta ja viimeisen avaimen jälkeen). Ohjaa ExtrapolationType.

StepMode

Luettelotyyppi, joka ohjaa, miten askelmäinen (vakio) interpolointi toteutetaan rajoilla.

WeightedMode

Luettelo Bezier‑tangenttien painon käsittelystä: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, tai BOTH.

ExtrapolationType

Luettelo alueen ulkopuolisista käyttäytymisistä: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, ja OSCILLATE.

Muodon I/O

FileFormat

Peruskuvaus 3D‑tiedostomuodolle. Jokainen tuettu formaatti tarjoaa konkreettisen singletonin kautta getInstance().

ImageRenderOptions

Perusluokka formaattikohtaisille tuonti‑toteutuksille. Ei luoda suoraan; kutsutaan sisäisesti scene.open().

ImageRenderOptions

Perusluokka formaattikohtaisille vienti‑toteutuksille. Ei luoda suoraan; kutsutaan sisäisesti scene.save().

LoadOptions

Perusluokka formaattikohtaisille latausasetuskohteille. Välitä aliluokan instanssi scene.open() tai scene.openFromBuffer().

SaveOptions

Perusluokka formaattikohtaisille tallennusasetuskohteille. Välitä aliluokan instanssi scene.save().

IOService

Sisäinen palvelukäyttöliittymä, joka abstrahoi tiedostojärjestelmän ja puskurin I/O:n tuojille ja viejille.

OBJ-muoto

OBJ tukee sekä tuontia että vientiä. Kun tallennetaan OBJ-muodossa, materiaalikirjasto (.mtl) kirjoitetaan automaattisesti tiedoston .obj vieressä.

ObjImporter

Sisäinen tuonti, joka lukee Wavefront OBJ -tiedostoja ja ratkaisee .mtl materiaalikirjastot, ja täyttää Scene. ObjLoadOptions Kutsutaan automaattisesti, kun scene.open().

ObjExporter

Sisäinen vienti, joka kirjoittaa Wavefront OBJ -tiedostoja. Kumppani .mtl materiaalikirjasto kirjoitetaan automaattisesti. Kutsutaan, kun scene.save() kohdistaa .obj polku.

ObjLoadOptions

Lataa asetukset OBJ‑tiedostoille. Keskeiset ominaisuudet: enableMaterials (boolean, oletus true), flipCoordinateSystem (boolean), normalizeNormal (boolean, oletus true), scale (number). Katso Formaatin lataus- ja tallennusasetukset tarkempia tietoja varten.

ObjSaveOptions

Tallenna OBJ-viennin asetukset. Välitä scene.save() ohjaamaan OBJ-tulosteen käyttäytymistä. Katso Formaatin lataus- ja tallennusasetukset tarkempia tietoja varten.

ObjFormat

Muodonkuvauksen singleton OBJ:lle. Sekä canImport ja canExport ovat true.

glTF-muoto

GltfImporter

Lukee glTF 2.0 JSON (.gltf).glbja binäärinen GLB (.

GltfExporter

Kirjoittaa glTF 2.0 -tulosteen. Kun GltfSaveOptions.binaryMode on true, tuottaa itsenäisen GLB:n; muuten kirjoittaa JSONin .gltf kumppanin kanssa .bin puskuri.

GltfLoadOptions

Latausasetukset glTF/GLB‑tiedostoille. Ohjaa puskurin resoluutiota ja tekstuurien latauskäyttäytymistä.

GltfSaveOptions

Tallenna asetukset glTF/GLB-viennille. Huomattavat ominaisuudet: binaryMode (boolean, true → GLB, oletus false), flipTexCoordV (boolean, kääntää UV:n pystysuoran akselin, oletus true). Katso Formaatin lataus- ja tallennusasetukset tarkempia tietoja.

GltfFormat

Muodon kuvausobjekti (singleton). Hanki kautta GltfFormat.getInstance() ja anna kohteelle scene.save() toisena argumenttina.

STL-muoto

StlImporter

Lukee sekä ASCII- että binaaritiedostot STL-muodossa Scene joka sisältää yhden Mesh entiteetin.

StlExporter

Kirjoittaa binaarisen STL:n. Tuloste sisältää kohtauksesta trianguloidun verkon; ei‑kolmiomaiset polygonit trianguloidaan automaattisesti.

StlLoadOptions

Latausasetukset STL:lle. Ohjaa, kääntääkö tuonti normaalit tuonnin aikana.

StlSaveOptions

Tallennusasetukset STL-viennille. Keskeinen ominaisuus: binaryMode (boolean, oletus false). Ohjaa, onko tuloste ASCII- vai binaari-STL. Katso Formaatin lataus- ja tallennusasetukset tarkempia tietoja.

StlFormat

Muodon kuvausobjekti (singleton). Hanki kautta StlFormat.getInstance().

3MF Format

ThreeMfImporter

Lukee Open Packaging Convention 3MF -arkistoja ja täyttää Scene verkko-objekteilla, väreillä ja materiaalin ominaisuuksilla.

ThreeMfExporter

Kirjoittaa kelvollisen 3MF-arkiston nykyisestä kohtauksesta. Sopii 3D‑tulostusprosessiin.

ThreeMfLoadOptions

Latausasetukset 3MF‑tiedostoille.

ThreeMfSaveOptions

Tallennusasetukset 3MF‑viennille.

ThreeMfFormat

Muodon kuvaus singleton. Hae kautta ThreeMfFormat.getInstance().

FBX-muoto

FbxImporter

Lukee FBX-binääri- ja ASCII‑tiedostoja, mukaan lukien geometria, materiaalit, luurankot, blend shape -muodot ja animaatioleikkeet.

FbxExporter

Kirjoittaa FBX‑tiedostoja nykyisestä kohtauksesta. Sekä binääri‑ että ASCII‑FBX‑tulostus on tuettu asetuksista riippuen.

FbxLoadOptions

Latausasetukset FBX:lle. Määrittää, tuodaanko animaatiot, skin‑tiedot ja blend shape -muodot.

FbxSaveOptions

Tallennusasetukset FBX-viennille. Keskeinen ominaisuus: embedTextures (boolean, oletus false). Katso Formaatin lataus- ja tallennusasetukset tarkempia tietoja.

FbxFormat

Formaatin kuvausyksikkö. Hanki seuraavasti FbxFormat.getInstance().

COLLADA-muoto

COLLADA-tuonti ja -vienti vaativat xmldom vertaisriippuvuuden, joka asennetaan automaattisesti @aspose/3d.

ColladaImporter

Lukee COLLADA (.dae) XML-tiedostoja käyttäen xmldom. Käsittelee geometriaa, materiaaleja, kameroita, valoja ja animaatiota.

ColladaExporter

Kirjoittaa COLLADA XML -tulosteen nykyisestä kohtauksesta. Sopii tiedonsiirtoon DCC-työkalujen (Blender, Maya jne.) kanssa.

ColladaFormat

Formaatin kuvausyksikkö. Hanki seuraavasti ColladaFormat.getInstance().

Ominaisuuksien järjestelmä

ImageRenderOptions

Tyypitetty nimi/arvo-pari, joka voidaan liittää mihin tahansa A3DObject. Tukee skalaarisia ja vektorisia arvo-tyyppejä.

PropertyCollection

Järjestetty säiliö Property objekteja. Käytettävissä missä tahansa A3DObject kautta properties accessor.

CustomObject

Vapaamuotoinen ominaisuuskassi, joka laajentaa A3DObject. Käytetään tallentamaan mielivaltaista metadataa, joka ei vastaa standardiluokkaa.

Asset-tiedot

AssetInfo

Sisältää kohtatasoiset metatiedot, jotka on ladattu lähdetiedostosta: tekijä, sovelluksen nimi, luontipäivämäärä, yksikön skaala ja koordinaattiakselin tiedot.

ImageRenderOptions

Asetukset, jotka ohjaavat tekstuurien ja kuvien ratkaisemista ja koodaamista tallennettaessa formaatteihin, jotka upottavat kuvatietoa (esim. GLB, jossa binaryMode: true).

Katso myös

 Suomi