CadQuery / CadQuery/cadquery

There is no sufficient document for Sketch's arc function.

Đang mở
#1,663 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
docs
Ngôn ngữ chính
Python
Star
5.8k
Fork
541
Merge trung bình
3 ngày 2 giờ
Pull request đã merge (30 ngày)
5

Mô tả

In the current master, there is no sufficient document for Sketch's arc function, especially for the overload function of
```
@arc.register
def arc(
self: T,
c: Point,
r: Real,
a: Real,
da: Real,
tag: Optional[str] = None,
forConstruction: bool = False,
) -> T:
```
Maybe variable "a" and variable "da" should be given more cares.

From the source code, I guess "a" should be the start angle, and "da" should be the angle value with direction included. If the arc is toward CW, the "da" should be negtive. Otherwise, the "da" should be positive.

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Hướng nghiên cứu

Bắt đầu với overload cung của Sketch được nêu trong issue, sau đó so sánh phần giải thích hiện tại của nó trong README.md với tài liệu CadQuery tại cadquery.readthedocs.io. Ghi lại `a` và `da` biểu thị điều gì, bao gồm các quy ước về hướng đối với cung theo chiều kim đồng hồ và ngược chiều kim đồng hồ; công việc được xem là hoàn tất khi người đọc có thể sử dụng overload này mà không phải đoán ý nghĩa của các tham số.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
48/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.