คู่มือผู้พัฒนา

Aspose.3D FOSS for TypeScript เป็นไลบรารีโอเพ่นซอร์สที่ใช้ใบอนุญาต MIT ซึ่งช่วยให้นักพัฒนา Node.js สามารถโหลด, สร้าง, แปลง, และส่งออกฉาก 3 มิติพร้อมความปลอดภัยของประเภท TypeScript อย่างเต็มรูปแบบ ไม่ว่าคุณจะกำลังสร้าง pipeline สินทรัพย์, บริการแปลงรูปแบบ, เครื่องมือตรวจสอบความถูกต้องของเรขาคณิต, หรือสคริปต์การสร้างเนื้อหา 3 มิติ ไลบรารีนี้มอบ API ที่สะอาดและสอดคล้องโดยอิงโมเดลกราฟฉากที่สะท้อนแนวคิด 3 มิติมาตรฐานอุตสาหกรรม.

คู่มือพัฒนานี้ครอบคลุมทุกสิ่งที่คุณต้องการเพื่อก้าวข้ามการติดตั้งแบบเริ่มต้นอย่างรวดเร็วและเขียนโค้ดการประมวลผล 3 มิติคุณภาพระดับการผลิต.

สิ่งที่คุณจะพบในส่วนนี้

คุณลักษณะและฟังก์ชันการทำงาน

หน้า คุณลักษณะ หน้าเป็นเอกสารอ้างอิงหลักสำหรับการทำงานกับ Aspose.3D FOSS สำหรับ TypeScript. มีเนื้อหาเกี่ยวกับ:

  • การสนับสนุนรูปแบบ: OBJ (พร้อมวัสดุ .mtl), glTF 2.0 / GLB แบบไบนารี, STL (ไบนารีและ ASCII), COLLADA (DAE), 3MF, และ FBX, พร้อมคลาสตัวเลือกการโหลดและบันทึกต่อรูปแบบที่รวมถึง ObjLoadOptions และ GltfSaveOptions.
  • กราฟฉาก: วิธี Scene, Node, Entity, Transform, และ SceneObject ประกอบเป็นลำดับชั้นฉากเต็มรูปแบบ, รวมถึงรูปแบบการท่องโหนดลูก.
  • API เรขาคณิตและเมช: การทำงานกับ Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, และ ReferenceMode สำหรับการประมวลผลเรขาคณิต.
  • ระบบวัสดุ: การประยุกต์ใช้ LambertMaterial, PhongMaterial, และ PbrMaterial (PBR for glTF) ไปยังโหนดของฉาก, และการอ่านคุณสมบัติวัสดุที่โหลดจากไฟล์ .mtl.
  • ยูทิลิตี้คณิตศาสตร์: การใช้ Vector3, Vector4, Matrix4, Quaternion, และ BoundingBox สำหรับการแปลง, การสอบถามกล่องขอบเขต, และการคำนวณเชิงเรขาคณิต.
  • แอนิเมชัน: การสร้างและการอ่าน AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, และ Extrapolation ข้อมูล.
  • การสนับสนุนสตรีมและบัฟเฟอร์: การโหลดฉาก 3D จากหน่วยความจำใน‑เครื่อง Buffer วัตถุผ่าน scene.openFromBuffer() สำหรับกรณีการใช้งานแบบไม่มีเซิร์ฟเวอร์และสตรีมมิ่ง.
  • ตัวอย่างการใช้งานครบถ้วน: สคริปต์ TypeScript แบบครบวงจรสำหรับการโหลด OBJ, การส่งออก GLB, การแปลงไป‑กลับ STL, และการสำรวจกราฟฉาก.
  • เคล็ดลับ, ปัญหาทั่วไป, และคำถามที่พบบ่อย: คำแนะนำเชิงปฏิบัติเพื่อหลีกเลี่ยงข้อผิดพลาดทั่วไปในการใช้งานจริง.
  • สรุปอ้างอิง API: รายการอ้างอิงอย่างรวดเร็วของคลาสสำคัญทั้งหมดและเมธอดหลักของพวกมัน.

แนวคิดสำคัญ

กราฟซีน: เนื้อหา 3D ทั้งหมดใน Aspose.3D FOSS ถูกแสดงเป็นต้นไม้ของ Node อ็อบเจ็กต์ที่รากอยู่ที่ scene.rootNode. แต่ละโหนดสามารถบรรจุ Entity (เช่น a Mesh, Camera, หรือ Light) Transform ที่กำหนดตำแหน่งของมันในลำดับชั้น.

API ที่ไม่ขึ้นกับรูปแบบ: คุณเปิดรูปแบบที่รองรับใดก็ได้ผ่าน scene.open() หรือ scene.openFromBuffer() และบันทึกเป็นรูปแบบที่รองรับใดก็ได้ผ่าน scene.save(). วัตถุ scene-graph เดียวกันจะถูกใช้ไม่ว่าต้นทางหรือปลายทางจะเป็นรูปแบบใด.

การพิมพ์ TypeScript อย่างเข้มงวด: ไลบรารีมาพร้อมกับการตั้งค่าคอมไพเลอร์ที่เข้มงวด (noImplicitAny, strictNullChecks) และคำนิยามประเภทที่สมบูรณ์ ทุกคลาส, เมธอด, และคุณสมบัติของตัวเลือกจะถูกกำหนดประเภทอย่างเต็มที่ ทำให้คุณได้รับการเติมข้อความอัตโนมัติใน IDE และความปลอดภัยในเวลาคอมไพล์ตลอดโค้ดการประมวลผล 3D ของคุณ.

การพึ่งพาเดียว: การพึ่งพา runtime เพียงอย่างเดียวคือ xmldom, ซึ่งจะถูกติดตั้งโดยอัตโนมัติผ่าน npm. ไม่มีแอดออนเนทีฟที่ต้องคอมไพล์และไม่มีแพ็กเกจระบบที่ต้องติดตั้ง.

เริ่มต้นใช้งาน

หากคุณยังไม่ได้ติดตั้งไลบรารีนี้, ดูที่ เริ่มต้นใช้งาน ส่วนและ การติดตั้ง คู่มือก่อนอ่านต่อ.

Available Topics

 ภาษาไทย