Hướng Dẫn Nhà Phát Triển

Aspose.3D FOSS for TypeScript là một thư viện mã nguồn mở, được cấp phép MIT, cho phép các nhà phát triển Node.js tải, xây dựng, biến đổi và xuất các cảnh 3D với độ an toàn kiểu TypeScript đầy đủ. Dù bạn đang xây dựng một pipeline tài sản, một dịch vụ chuyển đổi định dạng, một công cụ kiểm tra hình học, hay một script tạo nội dung 3D, thư viện này cung cấp một API sạch sẽ, nhất quán, được hỗ trợ bởi mô hình đồ thị cảnh phản ánh các khái niệm 3D tiêu chuẩn trong ngành.

Hướng dẫn nhà phát triển này bao gồm mọi thứ bạn cần để vượt qua việc cài đặt nhanh và viết mã xử lý 3D chất lượng sản xuất.

Những gì bạn sẽ tìm thấy trong phần này

Tính năng và Chức năng

Các Tính năng trang là tài liệu tham khảo chính để làm việc với Aspose.3D FOSS cho TypeScript. Nó bao gồm:

  • Hỗ trợ định dạng: OBJ (với vật liệu .mtl), glTF 2.0 / GLB nhị phân, STL (nhị phân và ASCII), COLLADA (DAE), 3MF, và FBX, với các lớp tùy chọn tải và lưu cho mỗi định dạng bao gồm ObjLoadOptions và GltfSaveOptions.
  • Đồ thị cảnh: Cách Scene, Node, Entity, Transform, và SceneObject tạo thành một cây cảnh đầy đủ, bao gồm các mẫu duyệt nút con.
  • API hình học và lưới: Làm việc với Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, và ReferenceMode để xử lý hình học.
  • Hệ thống vật liệu: Áp dụng LambertMaterial, PhongMaterial, và PbrMaterial (PBR cho glTF) tới các nút cảnh, và đọc các thuộc tính vật liệu được tải từ các tệp .mtl.
  • Tiện ích toán học: Sử dụng Vector3, Vector4, Matrix4, Quaternion, và BoundingBox cho các phép biến đổi, truy vấn hộp bao, và các phép tính hình học.
  • Hoạt ảnh: Xây dựng và đọc AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, Extrapolation dữ liệu.
  • Hỗ trợ luồng và bộ đệm: Tải các cảnh 3D từ bộ nhớ trong Buffer đối tượng qua scene.openFromBuffer() cho các trường hợp sử dụng không máy chủ và truyền phát.
  • Các ví dụ sử dụng đầy đủ: Các script TypeScript đầu‑cuối để tải OBJ, xuất GLB, vòng lại STL, và duyệt đồ thị cảnh.
  • Mẹo, các vấn đề thường gặp và Câu hỏi thường gặp: Hướng dẫn thực tế để tránh các bẫy thường gặp trong môi trường sản xuất.
  • Tóm tắt tài liệu tham chiếu API: Danh sách tham chiếu nhanh của tất cả các lớp chính và các phương thức chính của chúng.

Các khái niệm chính

Đồ thị cảnh: Tất cả nội dung 3D trong Aspose.3D FOSS được biểu diễn dưới dạng một cây của Node các đối tượng có gốc tại scene.rootNode. Mỗi nút có thể mang một Entity (chẳng hạn như một Mesh, Camera, hoặc Light) Transform định vị nó trong cấu trúc phân cấp.

API không phụ thuộc vào định dạng: Bạn mở bất kỳ định dạng nào được hỗ trợ qua scene.open() hoặc scene.openFromBuffer() và lưu sang bất kỳ định dạng nào được hỗ trợ qua scene.save(). Các đối tượng đồ thị cảnh giống nhau được sử dụng bất kể định dạng nguồn hay đích.

Kiểu TypeScript mạnh mẽ: Thư viện đi kèm với các cài đặt biên dịch chặt chẽ (noImplicitAny, strictNullChecks) và định nghĩa kiểu đầy đủ. Mỗi lớp, phương thức và thuộc tính tùy chọn đều được khai báo kiểu đầy đủ, cung cấp tính năng tự động hoàn thành trong IDE và an toàn thời gian biên dịch cho toàn bộ mã xử lý 3D của bạn.

Một phụ thuộc duy nhất: Phụ thuộc thời gian chạy duy nhất là xmldom, được npm cài đặt tự động. Không có addon gốc nào cần biên dịch và không có gói hệ thống nào cần cài đặt.

Bắt đầu

Nếu bạn chưa cài đặt thư viện, hãy xem phần Bắt đầu và phần Cài đặt hướng dẫn trước khi đọc tiếp.

Các chủ đề có sẵn

 Tiếng Việt