Sự miêu tả

API Python 3DCoat nhằm kích hoạt các lệnh giao diện người dùng, vận hành trên hiện trường và tạo các công cụ mới. Nó rất giống với C++ Core API, nhưng có những ưu điểm và nhược điểm riêng.

• Không cần bất kỳ thiết lập bổ sung nào để tạo tập lệnh của bạn; Python được nhúng vào bản phân phối 3DCoat .
• Python giống như một con dao Thụy Sĩ, cho phép bạn mang toàn bộ sức mạnh của các thư viện Python vào 3DCoat.
• Python chậm hơn nhiều so với C++, vì vậy nó chỉ có thể được sử dụng để quản lý chung, không dùng cho các thuật toán sâu và phức tạp.
• Nếu bạn đã quen thuộc với C++ Core API, thì Python API rất giống nhau, gần như 1:1, với cùng logic và tên hàm.

Cách sử dụng

• Sử dụng Tập lệnh->Tạo Tập lệnh Python để tạo tập lệnh mới. Bạn có thể chọn một mẫu ban đầu để bắt đầu. Tệp .py sẽ mở trong trình chỉnh sửa hiện tại của bạn được liên kết với các tệp .py.
• Chúng tôi sử dụng Python 3.8.10 nhúng để vận hành. Đây là phiên bản Python cuối cùng có thể chạy trên Windows 7.
• Nếu cần, bạn có thể tạo một tệp có tên tests.txt với danh sách các mô-đun đã sử dụng; trong trường hợp này, các mô-đun sẽ được cài đặt tự động trước khi tập lệnh chạy.
• Chúng tôi khuyên dùng Visual Studio Code, vì nó sẽ tự động nhận ra cú pháp lệnh chuyên dụng của 3DCoat và đưa ra các gợi ý chính xác.
• Chú ý: tệp coat.pyi nằm trong thư mục dự án chịu trách nhiệm về gợi ý mô-đun áo khoác trong Visual Studio. Bạn có thể mở tệp đó vì nó chứa danh sách tất cả các lớp và lệnh, có thể hữu ích cho việc tham khảo nhanh.
• Sử dụng Tập lệnh->Hiển thị Bảng điều khiển Python để xem đầu ra của bảng điều khiển từ Python. Hiện tại đây là cách duy nhất để gỡ lỗi scripth. Sau đó, chúng tôi dự định thêm tính năng gỡ lỗi gốc bằng Visual Studio Code.
• Bạn có thể cài đặt các mô-đun bổ sung cho Python bằng cách sử dụng Scripts->Install Python Modules . Một cách khác là sử dụng tests.txt trong cùng thư mục với vị trí của tệp .py.

lớp học chính

I/O chung: coat.io
Quản lý hộp thoại: coat.dialog
Hoạt động lưới: coat.Mesh
Rễ cảnh: áo khoác.Scene
Phần tử cảnh: áo khoác.SceneElement
Quản lý khối lượng: coat.Volume
Quản lý giao diện người dùng: coat.ui
Toán học vectơ 2D: coat.vec2
Toán học vectơ 3D: coat.vec3
Toán học 4D-vector: coat.vec4
Toán ma trận 3D: coat.mat3
Toán ma trận 4D: coat.mat4
Quản lý đối xứng: coat.symm