@windypro-rourou/dsh-eda 0.1.4 → 0.1.6

package/skill/format/pcb/component.md

@@ -1,132 +1,132 @@
-# Footprint System
-
-PCB footprints use a Master/Instance model, describing footprints through override rules with minimal redundancy.
-
-## COMPONENT Component Instance
-
-Instances only contain attributes. Attributes with the same `Key` in the instance will override those in the `FOOTPRINT`.
-
-```json
-{ "type": "COMPONENT", "id":"UUID", "ticket": 1 }||
-{
-  "partitionId":null,
-  "groupId":0,
-  "locked":1,
-  "zIndex":0.22,
-  "layerId":1,
-  "positionX":150,
-  "positionY":200,
-  "angle":45,
-  "attrs":{ "3D Model": "uuid", "3D Model Transform": "20,10,0,0,15,45,0,0,20" },
-}|
-```
-
-1. type instance `COMPONENT`.
-2. id primitive ID, unique within the document.
-3. ticket logical clock.
-4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
-5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
-6. locked whether locked.
-7. zIndex Z-axis height.
-8. layerId layer (only top and bottom).
-9. positionX position X.
-10. positionY position Y.
-11. angle rotation angle.
-12. attrs custom attributes.
-    - Fixed `3D Model` is the uuid of the 3D model. This uuid represents a record with doctype = 16 in the components table.
-    - Fixed `3D Model Transform` is the 3D model transformation parameters.
-
-```json
-["ATTR", "e102", 0, "e8", 1, "Designator", "U1", 0, 1, "SimSun", 50, 10, 0, 0, 0, 1, 2, 15, 1, 1]
-```
-
-```json
-["ATTR", "e103", 0, "e8", 1, "Footprint", "footprint-uuid", 0, 1, "SimSun", 50, 10, 0, 0, 0, 1, 2, 15, 1, 1]
-```
-
-```json
-["ATTR", "e104", 0, "e8", 1, "Device", "device-uuid", 0, 1, "SimSun", 50, 10, 0, 0, 0, 1, 2, 15, 1, 1]
-```
-
-### Pad-Net Mapping `PAD_NET`
-
-```json
-{ "type": "PAD_NET", "id":"COMPONENT_UUID", "ticket": 1 }||
-{
-  "padNum":"a1",
-  "padNet":"GND",
-  "padId":"e125",
-}|
-```
-
-1. type pad-net mapping `PAD_NET`.
-2. id parent component instance ID.
-3. ticket logical clock.
-4. padNum pad number.
-5. padNet net name.
-6. padId pad ID inside the footprint (optional).
-
-### Reuse Block Information `REUSE_BLOCK`
-
-```json
-{ "type": "REUSE_BLOCK", "id":"COMPONENT_UUID", "ticket": 1 }||
-{
-  "groupId":"$1e16",
-  "channelId":"$2e5_$4e3",
-}|
-```
-
-1. type reuse block information `REUSE_BLOCK`.
-2. id parent component instance ID.
-3. groupId group ID.
-4. channelId channel ID.
-
-### 3D Model Transform Special Notes
-
-```json
-{ "type": "COMPONENT", "id":"UUID", "ticket": 1 }||
-{
-  "partitionId":null,
-  "groupId":0,
-  "locked":1,
-  "zIndex":0.22,
-  "layerId":1,
-  "positionX":150,
-  "positionY":200,
-  "angle":45,
-  "attrs":{ "3D Model": "uuid", "3D Model Transform": "20,10,0,0,15,45,0,0,20" },
-}|
-```
-
-In the device, `3D Model Transform` is fixed as the transformation parameters required for the 3D model to match the device when it is [on the top layer], at [coordinates 0,0], and [rotation angle 0].
-
-The parameters are:
-
-1. sizeX: X-axis size.
-2. sizeY: Y-axis size.
-3. sizeZ: Z-axis size. There is a compatibility handling here: if 0, height is automatically adapted.
-4. rotZ: rotation angle around Z axis.
-5. rotX: rotation angle around X axis.
-6. rotY: rotation angle around Y axis.
-7. offX: X-axis offset.
-8. offY: Y-axis offset.
-9. offZ: Z-axis offset.
-
-The algorithm for generating the 3D model transformation matrix from the 3D model transform parameters is as follows:
-
-```python
-cx = X-axis midpoint of the 3D model
-cy = Y-axis midpoint of the 3D model
-bz = minimum Z value of the 3D model
-
-wx = X-axis width of the 3D model
-wy = Y-axis width of the 3D model
-wz = Z-axis width of the 3D model
-
-ORIGIN = translate(-cx, -cy, -bz)
-SCALE = scale(sizeX / wx, sizeY / wy, sizeZ / wz)
-ROT = rotateZXY(rotZ, rotX, rotY)
-OFFSET = translate(offX, offY, offZ)
-
-MATRIX = OFFSET X ROT X SCALE X ORIGIN
-```
+# Footprint System
+
+PCB footprints use a Master/Instance model, describing footprints through override rules with minimal redundancy.
+
+## COMPONENT Component Instance
+
+Instances only contain attributes. Attributes with the same `Key` in the instance will override those in the `FOOTPRINT`.
+
+```json
+{ "type": "COMPONENT", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":0.22,
+  "layerId":1,
+  "positionX":150,
+  "positionY":200,
+  "angle":45,
+  "attrs":{ "3D Model": "uuid", "3D Model Transform": "20,10,0,0,15,45,0,0,20" },
+}|
+```
+
+1. type instance `COMPONENT`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. layerId layer (only top and bottom).
+9. positionX position X.
+10. positionY position Y.
+11. angle rotation angle.
+12. attrs custom attributes.
+    - Fixed `3D Model` is the uuid of the 3D model. This uuid represents a record with doctype = 16 in the components table.
+    - Fixed `3D Model Transform` is the 3D model transformation parameters.
+
+```json
+["ATTR", "e102", 0, "e8", 1, "Designator", "U1", 0, 1, "SimSun", 50, 10, 0, 0, 0, 1, 2, 15, 1, 1]
+```
+
+```json
+["ATTR", "e103", 0, "e8", 1, "Footprint", "footprint-uuid", 0, 1, "SimSun", 50, 10, 0, 0, 0, 1, 2, 15, 1, 1]
+```
+
+```json
+["ATTR", "e104", 0, "e8", 1, "Device", "device-uuid", 0, 1, "SimSun", 50, 10, 0, 0, 0, 1, 2, 15, 1, 1]
+```
+
+### Pad-Net Mapping `PAD_NET`
+
+```json
+{ "type": "PAD_NET", "id":"COMPONENT_UUID", "ticket": 1 }||
+{
+  "padNum":"a1",
+  "padNet":"GND",
+  "padId":"e125",
+}|
+```
+
+1. type pad-net mapping `PAD_NET`.
+2. id parent component instance ID.
+3. ticket logical clock.
+4. padNum pad number.
+5. padNet net name.
+6. padId pad ID inside the footprint (optional).
+
+### Reuse Block Information `REUSE_BLOCK`
+
+```json
+{ "type": "REUSE_BLOCK", "id":"COMPONENT_UUID", "ticket": 1 }||
+{
+  "groupId":"$1e16",
+  "channelId":"$2e5_$4e3",
+}|
+```
+
+1. type reuse block information `REUSE_BLOCK`.
+2. id parent component instance ID.
+3. groupId group ID.
+4. channelId channel ID.
+
+### 3D Model Transform Special Notes
+
+```json
+{ "type": "COMPONENT", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":0.22,
+  "layerId":1,
+  "positionX":150,
+  "positionY":200,
+  "angle":45,
+  "attrs":{ "3D Model": "uuid", "3D Model Transform": "20,10,0,0,15,45,0,0,20" },
+}|
+```
+
+In the device, `3D Model Transform` is fixed as the transformation parameters required for the 3D model to match the device when it is [on the top layer], at [coordinates 0,0], and [rotation angle 0].
+
+The parameters are:
+
+1. sizeX: X-axis size.
+2. sizeY: Y-axis size.
+3. sizeZ: Z-axis size. There is a compatibility handling here: if 0, height is automatically adapted.
+4. rotZ: rotation angle around Z axis.
+5. rotX: rotation angle around X axis.
+6. rotY: rotation angle around Y axis.
+7. offX: X-axis offset.
+8. offY: Y-axis offset.
+9. offZ: Z-axis offset.
+
+The algorithm for generating the 3D model transformation matrix from the 3D model transform parameters is as follows:
+
+```python
+cx = X-axis midpoint of the 3D model
+cy = Y-axis midpoint of the 3D model
+bz = minimum Z value of the 3D model
+
+wx = X-axis width of the 3D model
+wy = Y-axis width of the 3D model
+wz = Z-axis width of the 3D model
+
+ORIGIN = translate(-cx, -cy, -bz)
+SCALE = scale(sizeX / wx, sizeY / wy, sizeZ / wz)
+ROT = rotateZXY(rotZ, rotX, rotY)
+OFFSET = translate(offX, offY, offZ)
+
+MATRIX = OFFSET X ROT X SCALE X ORIGIN
+```

package/skill/format/pcb/dimension.md

@@ -1,58 +1,58 @@
-# DIMENSION Dimension Tool Set
-
-```json
-{ "type": "DIMENSION", "id":"UUID", "ticket": 1 }||
-{
-  "partitionId":null,
-  "groupId":0,
-  "locked":1,
-  "zIndex":2.221,
-  "type":"RADIUS",
-  "layerId":3,
-  "unit":"mm",
-  "strokeWidth":0.5,
-  "precision":3,
-  "textFollow":1,
-  "coords": [100 200 300 400 400 400],
-}|
-["DIMENSION", "e101", 0, 1, 2.221, "RADIUS", 3, "mm", 0.5, 3, 1, [100 200 300 400 400 400]]
-```
-
-1. type dimension tool `DIMENSION`.
-2. id primitive ID, unique within the document.
-3. ticket logical clock.
-4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
-5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
-6. locked whether locked.
-7. zIndex Z-axis height.
-8. type dimension type: `RADIUS` radius, `LENGTH` length, `ANGLE` angle.
-9. layerId layer.
-10. unit unit: `mm`, `cm`, `inch`, `mil`.
-11. strokeWidth line width.
-12. precision precision.
-13. textFollow whether text follows: `1` tool automatically decides text position, `0` always use the position of `ATTR`.
-14. coords coordinate set X1 Y1 X2 Y2 X3 Y3 ... different dimension types define coordinates differently.
-
-```json
-["ATTR", "e102", 0, "e101", 1, 200, 150, "VALUE", "1234mm", 0, 1, "SimSun", 50, 10, 0, 0, 0, 2, 15, 1, 1]
-```
-
-`DIMENSION` needs to be accompanied by an attribute with Key `VALUE` to express the text part of the dimension tool. EDA should ignore unnecessary properties such as `whether to display Key` and `whether to display Value`.
-
-### RADIUS Radius Tool
-
-The first coordinate of the coordinate set is the endpoint touching the ARC, and the last coordinate is the default endpoint for displaying text, as shown below.
-
-![image](/storage/images/cn/format/pcb/dimension/dim_radius.png)
-
-### LENGTH Length Tool
-
-The coordinate set only needs four points, as shown below.
-
-![image](/storage/images/cn/format/pcb/dimension/dim_length.png)
-
-### ANGLE Angle Tool
-
-The coordinate set needs 3 points, as shown below.
-
-![image](/storage/images/cn/format/pcb/dimension/dim_angle.png)
+# DIMENSION Dimension Tool Set
+
+```json
+{ "type": "DIMENSION", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":2.221,
+  "type":"RADIUS",
+  "layerId":3,
+  "unit":"mm",
+  "strokeWidth":0.5,
+  "precision":3,
+  "textFollow":1,
+  "coords": [100 200 300 400 400 400],
+}|
+["DIMENSION", "e101", 0, 1, 2.221, "RADIUS", 3, "mm", 0.5, 3, 1, [100 200 300 400 400 400]]
+```
+
+1. type dimension tool `DIMENSION`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. type dimension type: `RADIUS` radius, `LENGTH` length, `ANGLE` angle.
+9. layerId layer.
+10. unit unit: `mm`, `cm`, `inch`, `mil`.
+11. strokeWidth line width.
+12. precision precision.
+13. textFollow whether text follows: `1` tool automatically decides text position, `0` always use the position of `ATTR`.
+14. coords coordinate set X1 Y1 X2 Y2 X3 Y3 ... different dimension types define coordinates differently.
+
+```json
+["ATTR", "e102", 0, "e101", 1, 200, 150, "VALUE", "1234mm", 0, 1, "SimSun", 50, 10, 0, 0, 0, 2, 15, 1, 1]
+```
+
+`DIMENSION` needs to be accompanied by an attribute with Key `VALUE` to express the text part of the dimension tool. EDA should ignore unnecessary properties such as `whether to display Key` and `whether to display Value`.
+
+### RADIUS Radius Tool
+
+The first coordinate of the coordinate set is the endpoint touching the ARC, and the last coordinate is the default endpoint for displaying text, as shown below.
+
+![image](/storage/images/cn/format/pcb/dimension/dim_radius.png)
+
+### LENGTH Length Tool
+
+The coordinate set only needs four points, as shown below.
+
+![image](/storage/images/cn/format/pcb/dimension/dim_length.png)
+
+### ANGLE Angle Tool
+
+The coordinate set needs 3 points, as shown below.
+
+![image](/storage/images/cn/format/pcb/dimension/dim_angle.png)

package/skill/format/pcb/index.md

@@ -1,17 +1,17 @@
-# PCB Format Document
-
-This chapter details the format specification of the EasyEDA PCB file. PCB files mainly consist of the following parts:
-
-- [Common Format](/en/format/pcb/common.md): document header, canvas, layers, physical layers, preferences, etc.
-- [Partition Format](/en/format/pcb/partition.md): partition definitions.
-- [Basic Primitives](/en/format/pcb/primitive.md): nets, primitive configurations, groups, silkscreen configurations, associations, attributes, etc.
-- [Pads and Vias](/en/format/pcb/pad_via.md): pads and vias.
-- [Shape Primitives](/en/format/pcb/shape.md): lines, arcs, polygon systems, polylines, fills, regions, copper pours, images, teardrops, etc.
-- [Binary Objects](/en/format/pcb/obj.md): embedded objects.
-- [3D Shell](/en/format/pcb/3d.md): shells, creases, entities, bosses.
-- [Text System](/en/format/pcb/text.md): text.
-- [Attributes](/en/format/pcb/attr.md): attributes.
-- [Dimension Tools](/en/format/pcb/dimension.md): dimension annotations.
-- [Footprint System](/en/format/pcb/component.md): component instances.
-- [Design Rules](/en/format/pcb/rule.md): rule templates, rule definitions, rule selectors.
-- [Panelization](/en/format/pcb/panel.md): panelization parameters.
+# PCB Format Document
+
+This chapter details the format specification of the EasyEDA PCB file. PCB files mainly consist of the following parts:
+
+- [Common Format](/en/format/pcb/common.md): document header, canvas, layers, physical layers, preferences, etc.
+- [Partition Format](/en/format/pcb/partition.md): partition definitions.
+- [Basic Primitives](/en/format/pcb/primitive.md): nets, primitive configurations, groups, silkscreen configurations, associations, attributes, etc.
+- [Pads and Vias](/en/format/pcb/pad_via.md): pads and vias.
+- [Shape Primitives](/en/format/pcb/shape.md): lines, arcs, polygon systems, polylines, fills, regions, copper pours, images, teardrops, etc.
+- [Binary Objects](/en/format/pcb/obj.md): embedded objects.
+- [3D Shell](/en/format/pcb/3d.md): shells, creases, entities, bosses.
+- [Text System](/en/format/pcb/text.md): text.
+- [Attributes](/en/format/pcb/attr.md): attributes.
+- [Dimension Tools](/en/format/pcb/dimension.md): dimension annotations.
+- [Footprint System](/en/format/pcb/component.md): component instances.
+- [Design Rules](/en/format/pcb/rule.md): rule templates, rule definitions, rule selectors.
+- [Panelization](/en/format/pcb/panel.md): panelization parameters.

package/skill/format/pcb/obj.md

@@ -1,43 +1,43 @@
-# OBJ Binary Embedded Object
-
-Files and other data are encoded into the following primitive to be embedded in the page as images and files, which can be downloaded as attachments or displayed directly.
-
-```json
-{ "type": "OBJ", "id":"UUID", "ticket": 1 }||
-{
-  "partitionId":null,
-  "groupId":0,
-  "locked":1,
-  "zIndex":5.286,
-  "layerId":15,
-  "fileName":"a.png",
-  "startX":200,
-  "startY":300,
-  "width":10,
-  "height":20,
-  "angle":0,
-  "mirror":1,
-  "path":"blob:1234ade2f",
-}|
-["OBJ", "e662", 0, 1, 5.286, 15, "a.png", 200, 300, 10, 20, 0, 1, "blob:1234ade2f"]
-```
-
-1. type binary embedded object identifier: OBJ.
-2. id primitive ID, unique within the document.
-3. ticket logical clock.
-4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
-5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
-6. locked whether locked.
-7. zIndex Z-axis height.
-8. layerId layer.
-9. fileName file name.
-10. startX top-left X.
-11. startY top-left Y.
-12. width width.
-13. height height.
-14. angle rotation angle, around `top-left`.
-15. mirror whether the original image is horizontally mirrored. Mirroring is performed around the center of the original image's BBox.
-16. path binary data.
-    1. General format, compatible with `Data URLs`: `data:[<mediatype>][;base64],<data>`
-        - e.g. `data:image/png;base64,asdfasdfwer`
-    2. BLOB reference format, `blob:hashid`.
+# OBJ Binary Embedded Object
+
+Files and other data are encoded into the following primitive to be embedded in the page as images and files, which can be downloaded as attachments or displayed directly.
+
+```json
+{ "type": "OBJ", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":5.286,
+  "layerId":15,
+  "fileName":"a.png",
+  "startX":200,
+  "startY":300,
+  "width":10,
+  "height":20,
+  "angle":0,
+  "mirror":1,
+  "path":"blob:1234ade2f",
+}|
+["OBJ", "e662", 0, 1, 5.286, 15, "a.png", 200, 300, 10, 20, 0, 1, "blob:1234ade2f"]
+```
+
+1. type binary embedded object identifier: OBJ.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. layerId layer.
+9. fileName file name.
+10. startX top-left X.
+11. startY top-left Y.
+12. width width.
+13. height height.
+14. angle rotation angle, around `top-left`.
+15. mirror whether the original image is horizontally mirrored. Mirroring is performed around the center of the original image's BBox.
+16. path binary data.
+    1. General format, compatible with `Data URLs`: `data:[<mediatype>][;base64],<data>`
+        - e.g. `data:image/png;base64,asdfasdfwer`
+    2. BLOB reference format, `blob:hashid`.