diff --git a/docs/assets/path_example.png b/docs/assets/path_example.png new file mode 100644 index 0000000..a25ea73 Binary files /dev/null and b/docs/assets/path_example.png differ diff --git a/docs/outlines.md b/docs/outlines.md index 2f57e42..e70337f 100644 --- a/docs/outlines.md +++ b/docs/outlines.md @@ -508,9 +508,120 @@ With this, let's see a list of what actual shapes we can place, what extra attri ::: +- **`path`**: A custom vector path shape made of connected segments. + - **`segments`**: A mandatory array of segment definitions. Each segment specifies a structural portion of the path using a **`type`** (such as `line` or `arc`) and an array of **`points`** using standard Ergogen anchors. Consecutive segments automatically start from where the previous segment left off. +
Path Example - from b0b's board Good-Wings +

+ + + + +```yaml + outer_outline: + - what: path + segments: + - type: arc # thumb arc + points: + - ref: thumbs_far_thumb + shift: [0.6px, -0.6py] + - ref: thumbs_middle_thumb + shift: [0px, -0.6py] + - ref: thumbs_tuck_thumb + shift: [-0.6px, -0.6py] + + - type: line # thumb to pinky line + points: + - ref: thumbs_tuck_thumb + shift: [-0.6px, 0ky] + - ref: matrix_pinky_bottom + shift: [0.6px, -0.6ky] + - ref: matrix_outer-pinky_bottom + shift: [-0.6px, -0.6ky] + - ref: matrix_outer-pinky_top + shift: [-0.6px, 0.6ky] + + - type: line # top steplike lines + points: + - ref: matrix_ring_top + shift: [-0.6px, 0ky] + - ref: matrix_ring_top + shift: [-0.6px, 0.6ky] + - ref: matrix_middle_top + shift: [-0.6px, 0.15ky] + - ref: matrix_middle_top + shift: [-0.6px, 0.6ky] + - ref: matrix_middle_top + shift: [0.6px, 0.6ky] + - ref: matrix_middle_top + shift: [0.6px, 0.4ky] + + - type: arc # top arc + points: + - ref.aggregate.parts: [matrix_inner_top, mirror_matrix_inner_top] + shift: [0px, 0.6py] + - ref: mirror_matrix_middle_top + shift: [0.6px, 0.4ky] + + - type: line # top steplike lines mirror + points: + - ref: mirror_matrix_middle_top + shift: [0.6px, 0.4ky] + - ref: mirror_matrix_middle_top + shift: [0.6px, 0.6ky] + - ref: mirror_matrix_middle_top + shift: [-0.6px, 0.6ky] + - ref: mirror_matrix_middle_top + shift: [-0.6px, 0.15ky] + - ref: mirror_matrix_ring_top + shift: [-0.6px, 0.6ky] + - ref: mirror_matrix_ring_top + shift: [-0.6px, 0ky] + + - type: line # thumb to pinky line mirror + points: + - ref: mirror_matrix_outer-pinky_top + shift: [-0.6px, 0.6ky] + - ref: mirror_matrix_outer-pinky_bottom + shift: [-0.6px, -0.6ky] + - ref: mirror_matrix_pinky_bottom + shift: [0.6px, -0.6ky] + - ref: mirror_thumbs_tuck_thumb + shift: [-0.6px, 0ky] + - ref: mirror_thumbs_tuck_thumb + shift: [-0.6px, -0.6ky] + + - type: arc # thumb arc mirror + points: + - ref: mirror_thumbs_middle_thumb + shift: [0px, -0.6py] + - ref: mirror_thumbs_far_thumb + shift: [0.6px, -0.6py] + + - type: line # thumb v shape thing bottom + points: + - ref: mirror_thumbs_far_thumb + shift: [0.6px, 0.3py] + - ref: thumbs_far_thumb + shift: [0.6px, 0.3py] + + fillet: 1 +``` + + + +

+ +![Good-Wings Path Example](./assets/path_example.png) + +
+ + + +

+