Kehittäjän opas
Aspose.3D FOSS for Python on avoimen lähdekoodin, MIT-lisenssin alainen kirjasto, jonka avulla Python -kehittäjät voivat ladata, rakentaa, muuntaa ja viedä 3D‑kohtauksia ilman ulkoisia ajonaikaisia riippuvuuksia. Olitpa sitten rakentamassa assettiputkea, validointityökalua, geometria‑käsittelyskriptiä tai formaattimuunnospalvelua, tämä kirjasto tarjoaa puhtaan, yhdenmukaisen API:n, jota tukee kohtausgrafiikkamalli, joka heijastaa alan standardeja 3D‑käsitteitä.
Tämä kehittäjän opas kattaa kaiken, mitä tarvitset nopean aloitusasennuksen ylittämiseen ja tuotantotason 3D‑käsittelykoodin kirjoittamiseen.
Mitä löydät tässä osiossa
Ominaisuudet ja toiminnot
Se Ominaisuudet sivu on ensisijainen viite Aspose.3D FOSS:n Python kanssa työskentelemiseen. Se kattaa:
- Formaattituki: OBJ (.mtl-materiaalien kanssa), STL (binääri- ja ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, ja keskeneräinen FBX-tokenisoija, per formaatti -lataus- ja tallennusvaihtoehtoluokkien kanssa.
- Kohtausgrafiikka: Kuinka
Scene,Node,Entity,Transform, jaGlobalTransformkoosta täydelliseksi kohtaushierarkiaksi, mukaan lukien alisolmujen läpikäyntimallit. - Mesh API: Työskenteleminen
control_points,VertexElementNormal,VertexElementUV,VertexElementVertexColor, jaVertexElementSmoothingGroupgeometriankäsittelyyn. - Materiaalijärjestelmä: Soveltaminen
LambertMaterialjaPhongMaterialscene-solmuihin ja .mtl-tiedostoista ladattujen materiaalin ominaisuuksien lukemiseen. - Matematiikkatyökalut: Käyttäen
Vector2,Vector3,Vector4,FVector3,Quaternion,Matrix4, jaBoundingBoxmuunnoksille, bounding-box-kyselyille ja geometrisille laskelmille. - Animaatio: Rakentaminen ja lukeminen
AnimationClip,AnimationNode,KeyFrame, jaKeyframeSequencedata. - Lataus- ja tallennusasetukset: Per-formaatin asetusluokat, kuten
ObjLoadOptions(flip_coordinate_system, scale, enable_materials, normalize_normal) andStlSaveOptions. - Täydelliset käyttöesimerkit: Kokonaisvaltaiset Python-skriptit OBJ:n lataamiseen, STL:n vientiin, glTF:n kaksisuuntaiseen käsittelyyn ja kohtausgrafien läpikäymiseen.
- Vinkkejä, yleisiä ongelmia ja FAQ: Käytännön ohjeita yleisten sudenkuoppien välttämiseksi tuotantokäytössä.
- API-viitteiden yhteenveto: Nopea viite luettelo kaikista keskeisistä luokista.
Keskeiset käsitteet
Kohtausgrafi: Kaikki 3D-sisältö Aspose.3D FOSS:ssa esitetään puuna, jossa on Node objektit, jonka juurena on scene.root_node. Jokainen solmu voi kantaa Entity (kuten Mesh, Camera, tai Light) ja Transform joka sijoittaa sen hierarkiassa.
Formaattineutraali API: Avaa mikä tahansa tuettu formaatti kautta Scene.open() tai Scene.from_file() ja tallenna mihin tahansa tuettuun formaattiin kautta Scene.save(). Sama scene-graph -objektit käytetään riippumatta lähde- tai kohdeformaatista.
Ei riippuvuuksia: Kirjasto on puhdas Python. Ei ole natiivilaajennusta käännettäväksi, ei järjestelmäpakettia asennettavaksi, eikä kolmannen osapuolen kirjastoa hallittavaksi.
Aloittaminen
Jos et ole vielä asentanut kirjastoa, katso Aloittaminen osio ja Asennus opas ennen kuin luet eteenpäin.
Saatavilla olevat aiheet
- Ominaisuudet ja toiminnot: Täydellinen API-viite, jossa on koodiesimerkkejä jokaiselle tärkeimmälle ominaisuusalueelle.