@jlceda/pro-api-types 0.1.78 → 0.1.80

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.d.ts +1925 -461
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -744,11 +744,14 @@ declare class EDA {
744
744
  pcb_Primitive: PCB_Primitive;
745
745
  pcb_PrimitiveArc: PCB_PrimitiveArc;
746
746
  pcb_PrimitiveComponent: PCB_PrimitiveComponent;
747
+ pcb_PrimitiveFill: PCB_PrimitiveFill;
747
748
  pcb_PrimitiveDimension: PCB_PrimitiveDimension;
748
749
  pcb_PrimitiveImage: PCB_PrimitiveImage;
749
750
  pcb_PrimitiveLine: PCB_PrimitiveLine;
750
751
  pcb_PrimitivePad: PCB_PrimitivePad;
751
752
  pcb_PrimitivePolyline: PCB_PrimitivePolyline;
753
+ pcb_PrimitivePour: PCB_PrimitivePour;
754
+ pcb_PrimitiveRegion: PCB_PrimitiveRegion;
752
755
  pcb_PrimitiveVia: PCB_PrimitiveVia;
753
756
  pcb_SelectControl: PCB_SelectControl;
754
757
  pnl_Document: PNL_Document;
@@ -781,6 +784,7 @@ declare class EDA {
781
784
  sys_MessageBox: SYS_MessageBox;
782
785
  sys_PanelControl: SYS_PanelControl;
783
786
  sys_ShortcutKey: SYS_ShortcutKey;
787
+ sys_Storage: SYS_Storage;
784
788
  sys_Timer: SYS_Timer;
785
789
  sys_ToastMessage: SYS_ToastMessage;
786
790
  sys_Unit: SYS_Unit;
@@ -955,11 +959,17 @@ declare enum ELIB_SymbolType {
955
959
  * @public
956
960
  */
957
961
  declare enum ENetlistType {
962
+ /** Allegro */
958
963
  ALLEGRO = "Allegro",
964
+ /** PADS */
959
965
  PADS = "PADS",
966
+ /** Protel 2 */
960
967
  PROTEL2 = "Protel2",
968
+ /** 嘉立创 EDA 专业版 */
961
969
  JLCEDA_PRO = "JLCEDA",
970
+ /** EasyEDA Pro Edition */
962
971
  EASYEDA_PRO = "EasyEDA",
972
+ /** Altium Designer */
963
973
  ALTIUM_DESIGNER = "AltiumDesigner"
964
974
  }
965
975
 
@@ -1177,7 +1187,7 @@ declare enum EPCB_LayerId {
1177
1187
  SHELL_3D_TOP = 54,
1178
1188
  /** 3D 外壳底层 */
1179
1189
  SHELL_3D_BOTTOM = 55,
1180
- /** 钻孔图层 */
1190
+ /** 钻��图层 */
1181
1191
  DRILL_DRAWING = 56
1182
1192
  }
1183
1193
 
@@ -1236,11 +1246,26 @@ declare enum EPCB_PrimitiveArcInteractiveMode {
1236
1246
  */
1237
1247
  declare enum EPCB_PrimitiveDimensionType {
1238
1248
  /** 半径 */
1239
- RADIUS = "RADIUS",
1249
+ RADIUS = "Radius Dimension",
1240
1250
  /** 长度 */
1241
- LENGTH = "LENGTH",
1251
+ LENGTH = "Length Dimension",
1242
1252
  /** 角度 */
1243
- ANGLE = "ANGLE"
1253
+ ANGLE = "Protractor Dimension"
1254
+ }
1255
+
1256
+ /**
1257
+ * 填充图元填充模式
1258
+ *
1259
+ * @public
1260
+ * @remarks 网格填充和内电层填充为预留配置
1261
+ */
1262
+ declare enum EPCB_PrimitiveFillMode {
1263
+ /** 实心填充 */
1264
+ SOLID = 0,
1265
+ /** 网格填充 */
1266
+ MESH = 1,
1267
+ /** 内电层填充 */
1268
+ INNER_ELECTRICAL_LAYER = 2
1244
1269
  }
1245
1270
 
1246
1271
  /**
@@ -1301,6 +1326,29 @@ declare enum EPCB_PrimitivePadShapeType {
1301
1326
  POLYLINE_COMPLEX_POLYGON = "POLYGON"
1302
1327
  }
1303
1328
 
1329
+ /**
1330
+ * 区域图元区域规则类型
1331
+ *
1332
+ * @public
1333
+ * @remarks {@link EPCB_PrimitiveRegionRuleType.FOLLOW_REGION_RULE | FOLLOW_REGION_RULE} 即为约束区域
1334
+ */
1335
+ declare enum EPCB_PrimitiveRegionRuleType {
1336
+ /** 禁止元件 */
1337
+ NO_COMPONENTS = 2,
1338
+ /** 禁止过孔 */
1339
+ NO_VIAS = 3,
1340
+ /** 禁止布线 */
1341
+ NO_WIRES = 5,
1342
+ /** 禁止填充 */
1343
+ NO_FILLS = 6,
1344
+ /** 禁止覆铜 */
1345
+ NO_POURS = 7,
1346
+ /** 禁止内电层 */
1347
+ NO_INNER_ELECTRICAL_LAYERS = 8,
1348
+ /** 约束区域 */
1349
+ FOLLOW_REGION_RULE = 9
1350
+ }
1351
+
1304
1352
  /**
1305
1353
  * 图元类型
1306
1354
  *
@@ -1315,6 +1363,12 @@ declare enum EPCB_PrimitiveType {
1315
1363
  PAD = "Pad",
1316
1364
  /** 折线 */
1317
1365
  POLYLINE = "Polyline",
1366
+ /** 覆铜边框 */
1367
+ POUR = "Pour",
1368
+ /** 填充 */
1369
+ FILL = "Fill",
1370
+ /** 区域 */
1371
+ REGION = "Region",
1318
1372
  /** 直线 */
1319
1373
  LINE = "Line",
1320
1374
  /** 过孔 */
@@ -1322,9 +1376,7 @@ declare enum EPCB_PrimitiveType {
1322
1376
  /** 尺寸标注 */
1323
1377
  DIMENSION = "Dimension",
1324
1378
  /** 图像 */
1325
- IMAGE = "Image",
1326
- /** 图像 */
1327
- PICTURE = "Picture"
1379
+ IMAGE = "Image"
1328
1380
  }
1329
1381
 
1330
1382
  /**
@@ -1878,7 +1930,7 @@ declare interface ILIB_CbbItem {
1878
1930
  }
1879
1931
 
1880
1932
  /**
1881
- * 搜索到的复用模块属性
1933
+ * 搜索��的复用模块属性
1882
1934
  *
1883
1935
  * @public
1884
1936
  */
@@ -2381,51 +2433,204 @@ declare class IPCB_PrimitiveArc implements IPCB_Primitive {
2381
2433
  /** 是否锁定 */
2382
2434
  private primitiveLock;
2383
2435
  /* Excluded from this release type: __constructor */
2436
+ /* Excluded from this release type: create */
2384
2437
  /**
2385
- * 在 PCB 画布中创建图元
2438
+ * 获取属性状态:图元类型
2439
+ *
2440
+ * @public
2441
+ * @returns 图元类型
2442
+ */
2443
+ getState_PrimitiveType(): EPCB_PrimitiveType;
2444
+ /**
2445
+ * 获取属性状态:图元 ID
2446
+ *
2447
+ * @public
2448
+ * @returns 图元 ID
2449
+ */
2450
+ getState_PrimitiveId(): string;
2451
+ /**
2452
+ * 获取属性状态:网络名称
2453
+ *
2454
+ * @public
2455
+ * @returns 网络名称
2456
+ */
2457
+ getState_Net(): string;
2458
+ /**
2459
+ * 获取属性状态:层
2460
+ *
2461
+ * @public
2462
+ * @returns 层
2463
+ */
2464
+ getState_Layer(): TPCB_LayersOfLine;
2465
+ /**
2466
+ * 获取属性状态:起始位置 X
2467
+ *
2468
+ * @public
2469
+ * @returns 起始位置 X
2470
+ */
2471
+ getState_StartX(): number;
2472
+ /**
2473
+ * 获取属性状态:起始位置 Y
2474
+ *
2475
+ * @public
2476
+ * @returns 起始位置 Y
2477
+ */
2478
+ getState_StartY(): number;
2479
+ /**
2480
+ * 获取属性状态:终止位置 X
2481
+ *
2482
+ * @public
2483
+ * @returns 终止位置 X
2484
+ */
2485
+ getState_EndX(): number;
2486
+ /**
2487
+ * 获取属性状态:终止位置 Y
2488
+ *
2489
+ * @public
2490
+ * @returns 终止位置 Y
2491
+ */
2492
+ getState_EndY(): number;
2493
+ /**
2494
+ * 获取属性状态:圆弧角度
2495
+ *
2496
+ * @public
2497
+ * @returns 圆弧角度
2498
+ */
2499
+ getState_ArcAngle(): number;
2500
+ /**
2501
+ * 获取属性状态:线宽
2502
+ *
2503
+ * @public
2504
+ * @returns 线宽
2505
+ */
2506
+ getState_LineWidth(): number;
2507
+ /**
2508
+ * 获取属性状态:交互模式
2509
+ *
2510
+ * @public
2511
+ * @returns 交互模式
2512
+ */
2513
+ getState_InteractiveMode(): EPCB_PrimitiveArcInteractiveMode;
2514
+ /**
2515
+ * 获取属性状态:是否锁定
2516
+ *
2517
+ * @public
2518
+ * @returns 是否锁定
2519
+ */
2520
+ getState_PrimitiveLock(): boolean;
2521
+ /**
2522
+ * 设置属性状态:网络名称
2386
2523
  *
2387
2524
  * @beta
2525
+ * @param net - 网络名称
2388
2526
  * @returns 圆弧线图元对象
2389
2527
  */
2390
- create(): Promise<IPCB_PrimitiveArc>;
2528
+ setState_Net(net: string): IPCB_PrimitiveArc;
2391
2529
  /**
2392
- * 获取对象的图元 ID
2530
+ * 设置属性状态:层
2393
2531
  *
2394
- * @returns
2532
+ * @beta
2533
+ * @param layer - 层
2534
+ * @returns 圆弧线图元对象
2395
2535
  */
2396
- getState_PrimitiveId(): string;
2397
- /* Excluded from this release type: setState_Net */
2398
- /* Excluded from this release type: setState_Layer */
2399
- /* Excluded from this release type: setState_StartX */
2400
- /* Excluded from this release type: setState_StartY */
2401
- /* Excluded from this release type: setState_EndX */
2402
- /* Excluded from this release type: setState_EndY */
2403
- /* Excluded from this release type: setState_ArcAngle */
2404
- /* Excluded from this release type: setState_LineWidth */
2405
- /* Excluded from this release type: setState_InteractiveMode */
2406
- /* Excluded from this release type: setState_PrimitiveLock */
2536
+ setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitiveArc;
2537
+ /**
2538
+ * 设置属性状态:起始位置 X
2539
+ *
2540
+ * @beta
2541
+ * @param startX - 起始位置 X
2542
+ * @returns 圆弧线图元对象
2543
+ */
2544
+ setState_StartX(startX: number): IPCB_PrimitiveArc;
2545
+ /**
2546
+ * 设置属性状态:起始位置 Y
2547
+ *
2548
+ * @beta
2549
+ * @param startY - 起始位置 Y
2550
+ * @returns 圆弧线图元对象
2551
+ */
2552
+ setState_StartY(startY: number): IPCB_PrimitiveArc;
2553
+ /**
2554
+ * 设置属性状态:终止位置 X
2555
+ *
2556
+ * @beta
2557
+ * @param endX - 终止位置 X
2558
+ * @returns 圆弧线图元对象
2559
+ */
2560
+ setState_EndX(endX: number): IPCB_PrimitiveArc;
2561
+ /**
2562
+ * 设置属性状态:终止位置 Y
2563
+ *
2564
+ * @beta
2565
+ * @param endY - 终止位置 Y
2566
+ * @returns 圆弧线图元对象
2567
+ */
2568
+ setState_EndY(endY: number): IPCB_PrimitiveArc;
2569
+ /**
2570
+ * 设置属性状态:圆弧角度
2571
+ *
2572
+ * @beta
2573
+ * @param arcAngle - 圆弧角度
2574
+ * @returns 圆弧线图元对象
2575
+ */
2576
+ setState_ArcAngle(arcAngle: number): IPCB_PrimitiveArc;
2577
+ /**
2578
+ * 设置属性状态:线宽
2579
+ *
2580
+ * @beta
2581
+ * @param lineWidth - 线宽
2582
+ * @returns 圆弧线图元对象
2583
+ */
2584
+ setState_LineWidth(lineWidth: number): IPCB_PrimitiveArc;
2585
+ /**
2586
+ * 设置属性状态:交互模式
2587
+ *
2588
+ * @beta
2589
+ * @param interactiveMode - 交互模式
2590
+ * @returns 圆弧线图元对象
2591
+ */
2592
+ setState_InteractiveMode(interactiveMode: EPCB_PrimitiveArcInteractiveMode): IPCB_PrimitiveArc;
2593
+ /**
2594
+ * 设置属性状态:是否锁定
2595
+ *
2596
+ * @beta
2597
+ * @param primitiveLock - 是否锁定
2598
+ * @returns 圆弧线图元对象
2599
+ */
2600
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveArc;
2407
2601
  /**
2408
2602
  * 将图元转换为异步图元
2603
+ *
2604
+ * @public
2605
+ * @returns 圆弧线图元对象
2409
2606
  */
2410
2607
  toAsync(): IPCB_PrimitiveArc;
2411
2608
  /**
2412
2609
  * 将图元转换为同步图元
2610
+ *
2611
+ * @public
2612
+ * @returns 圆弧线图元对象
2413
2613
  */
2414
2614
  toSync(): IPCB_PrimitiveArc;
2415
2615
  /**
2416
2616
  * 查询图元是否为异步图元
2617
+ *
2618
+ * @public
2619
+ * @returns 是否为异步图元
2417
2620
  */
2418
2621
  isAsync(): boolean;
2419
2622
  /**
2420
2623
  * 将异步图元重置为当前画布状态
2421
2624
  *
2422
2625
  * @beta
2626
+ * @returns 圆弧线图元对象
2423
2627
  */
2424
2628
  reset(): Promise<IPCB_PrimitiveArc>;
2425
2629
  /**
2426
2630
  * 将对图元的更改应用到画布
2427
2631
  *
2428
2632
  * @beta
2633
+ * @returns 圆弧线图元对象
2429
2634
  */
2430
2635
  done(): Promise<IPCB_PrimitiveArc>;
2431
2636
  }
@@ -2566,21 +2771,77 @@ declare class IPCB_PrimitiveDimension implements IPCB_Primitive {
2566
2771
  /** 是否锁定 */
2567
2772
  private primitiveLock;
2568
2773
  /* Excluded from this release type: __constructor */
2774
+ /* Excluded from this release type: create */
2569
2775
  /**
2570
- * 在 PCB 画布中创建图元
2776
+ * 获取属性状态:图元类型
2571
2777
  *
2572
- * @beta
2573
- * @returns 尺寸标注图元对象
2778
+ * @public
2779
+ * @returns 图元类型
2574
2780
  */
2575
- create(): Promise<IPCB_PrimitiveDimension>;
2576
- /** @alpha 定义 getState_* 函数 × 10 */
2781
+ getState_PrimitiveType(): EPCB_PrimitiveType;
2577
2782
  /**
2578
- * 获取对象的图元 ID
2783
+ * 获取属性状态:图元 ID
2579
2784
  *
2580
- * @returns
2785
+ * @public
2786
+ * @returns 图元 ID
2581
2787
  */
2582
2788
  getState_PrimitiveId(): string;
2583
- /** @alpha 所有的 setState_* 方法都需要对数据进行基本的格式校验 */
2789
+ /**
2790
+ * 获取属性状态:尺寸标注类型
2791
+ *
2792
+ * @public
2793
+ * @returns 尺寸标注类型
2794
+ */
2795
+ getState_DimensionType(): EPCB_PrimitiveDimensionType;
2796
+ /**
2797
+ * 获取属性状态:坐标集
2798
+ *
2799
+ * @public
2800
+ * @returns 坐标集
2801
+ */
2802
+ getState_CoordinateSet(): TPCB_PrimitiveDimensionCoordinateSet;
2803
+ /**
2804
+ * 获取属性状态:层
2805
+ *
2806
+ * @public
2807
+ * @returns 层
2808
+ */
2809
+ getState_Layer(): TPCB_LayersOfDimension;
2810
+ /**
2811
+ * 获取属性状态:单位
2812
+ *
2813
+ * @public
2814
+ * @returns 单位
2815
+ */
2816
+ getState_Unit(): ESYS_Unit.MILLIMETER | ESYS_Unit.CENTIMETER | ESYS_Unit.INCH | ESYS_Unit.MIL;
2817
+ /**
2818
+ * 获取属性状态:线宽
2819
+ *
2820
+ * @public
2821
+ * @returns 线宽
2822
+ */
2823
+ getState_LineWidth(): number;
2824
+ /**
2825
+ * 获取属性状态:精度
2826
+ *
2827
+ * @public
2828
+ * @returns 精度
2829
+ */
2830
+ getState_Precision(): number;
2831
+ /**
2832
+ * 获取属性状态:文字跟随
2833
+ *
2834
+ * @public
2835
+ * @returns 文字跟随
2836
+ */
2837
+ getState_TextFollow(): 0 | 1;
2838
+ /**
2839
+ * 获取属性状态:是否锁定
2840
+ *
2841
+ * @public
2842
+ * @returns 是否锁定
2843
+ */
2844
+ getState_PrimitiveLock(): boolean;
2584
2845
  /**
2585
2846
  * 设置属性状态:尺寸标注类型
2586
2847
  *
@@ -2675,129 +2936,943 @@ declare class IPCB_PrimitiveDimension implements IPCB_Primitive {
2675
2936
  }
2676
2937
 
2677
2938
  /**
2678
- * 图像图元
2939
+ * 填充图元
2679
2940
  *
2680
2941
  * @public
2681
2942
  */
2682
- declare class IPCB_PrimitiveImage implements IPCB_Primitive {
2943
+ declare class IPCB_PrimitiveFill implements IPCB_Primitive {
2683
2944
  /** 异步 */
2684
2945
  private async;
2685
2946
  /** 图元类型 */
2686
2947
  private readonly primitiveType;
2687
2948
  /** 图元 ID */
2688
2949
  private primitiveId?;
2689
- /** BBox 左上点坐标 X */
2690
- private x;
2691
- /** BBox 左上点坐标 Y */
2692
- private y;
2693
- /** 图像源数据(复杂多边形) */
2694
- private complexPolygon;
2950
+ /** 网络名称 */
2951
+ private net;
2695
2952
  /** 层 */
2696
2953
  private layer;
2697
- /** */
2698
- private width;
2699
- /** */
2700
- private height;
2701
- /** 旋转角度 */
2702
- private rotation;
2703
- /** 是否水平镜像 */
2704
- private horizonMirror;
2954
+ /** 复杂多边形 */
2955
+ private complexPolygon;
2956
+ /** 填充模式 */
2957
+ private fillMode;
2958
+ /** 线宽 */
2959
+ private lineWidth?;
2705
2960
  /** 是否锁定 */
2706
2961
  private primitiveLock;
2707
2962
  /* Excluded from this release type: __constructor */
2963
+ /* Excluded from this release type: create */
2708
2964
  /**
2709
- * 在 PCB 画布中创建图元
2965
+ * 获取属性状态:图元类型
2710
2966
  *
2711
- * @beta
2712
- * @returns 图像图元对象
2967
+ * @public
2968
+ * @returns 图元类型
2713
2969
  */
2714
- create(): Promise<IPCB_PrimitiveImage>;
2715
- /** @alpha 定义 getState_* 函数 × 11 */
2970
+ getState_PrimitiveType(): EPCB_PrimitiveType;
2716
2971
  /**
2717
- * 获取对象的图元 ID
2972
+ * 获取属性状态:图元 ID
2718
2973
  *
2719
- * @returns
2974
+ * @public
2975
+ * @returns 图元 ID
2720
2976
  */
2721
2977
  getState_PrimitiveId(): string;
2722
- /** @alpha 所有的 setState_* 方法都需要对数据进行基本的格式校验 */
2723
2978
  /**
2724
- * 设置属性状态:BBox 左上点坐标 X
2979
+ * 获取属性状态:网络名称
2725
2980
  *
2726
- * @beta
2727
- * @param x - BBox 左上点坐标 X
2728
- * @returns 图像图元对象
2981
+ * @public
2982
+ * @returns 网络名称
2729
2983
  */
2730
- setState_X(x: number): IPCB_PrimitiveImage;
2984
+ getState_Net(): string;
2731
2985
  /**
2732
- * 设置属性状态:BBox 左上点坐标 Y
2986
+ * 获取属性状态:层
2733
2987
  *
2734
- * @beta
2735
- * @param y - BBox 左上点坐标 Y
2736
- * @returns 图像图元对象
2988
+ * @public
2989
+ * @returns
2737
2990
  */
2738
- setState_Y(y: number): IPCB_PrimitiveImage;
2991
+ getState_Layer(): TPCB_LayersOfFill;
2739
2992
  /**
2740
- * 设置属性状态:层
2993
+ * 获取属性状态:复杂多边形
2741
2994
  *
2742
- * @beta
2743
- * @param layer - 层
2744
- * @returns 图像图元对象
2995
+ * @public
2996
+ * @returns 复杂多边形
2745
2997
  */
2746
- setState_Layer(layer: TPCB_LayersOfImage): IPCB_PrimitiveImage;
2998
+ getState_ComplexPolygon(): IPCB_ComplexPolygon;
2747
2999
  /**
2748
- * 设置属性状态:宽
3000
+ * 获取属性状态:填充模式
2749
3001
  *
2750
- * @beta
2751
- * @param width - 宽
2752
- * @returns 图像图元对象
3002
+ * @public
3003
+ * @returns 填充模式
2753
3004
  */
2754
- setState_Width(width: number): IPCB_PrimitiveImage;
3005
+ getState_FillMode(): EPCB_PrimitiveFillMode;
2755
3006
  /**
2756
- * 设置属性状态:高
3007
+ * 获取属性状态:线宽
2757
3008
  *
2758
- * @beta
2759
- * @param height - 高
2760
- * @returns 图像图元对象
3009
+ * @public
3010
+ * @returns 线宽
2761
3011
  */
2762
- setState_Height(height: number): IPCB_PrimitiveImage;
3012
+ getState_LineWidth(): number;
2763
3013
  /**
2764
- * 设置属性状态:旋转角度
3014
+ * 获取属性状态:是否锁定
2765
3015
  *
2766
- * @beta
2767
- * @param rotation - 旋转角度
2768
- * @returns 图像图元对象
3016
+ * @public
3017
+ * @returns 是否锁定
2769
3018
  */
2770
- setState_Rotation(rotation: number): IPCB_PrimitiveImage;
3019
+ getState_PrimitiveLock(): boolean;
2771
3020
  /**
2772
- * 设置属性状态:是否水平镜像
3021
+ * 设置属性状态:网络名称
2773
3022
  *
2774
3023
  * @beta
2775
- * @param horizonMirror - 是否水平镜像
2776
- * @returns 图像图元对象
3024
+ * @param net - 网络名称
3025
+ * @returns 填充图元对象
2777
3026
  */
2778
- setState_HorizonMirror(horizonMirror: boolean): IPCB_PrimitiveImage;
3027
+ setState_Net(net: string): IPCB_PrimitiveFill;
2779
3028
  /**
2780
- * 设置属性状态:是否锁定
3029
+ * 设置属性状态:层
2781
3030
  *
2782
3031
  * @beta
2783
- * @param primitiveLock - 是否锁定
2784
- * @returns 图像图元对象
3032
+ * @param layer -
3033
+ * @returns 填充图元对象
2785
3034
  */
2786
- setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveImage;
3035
+ setState_Layer(layer: TPCB_LayersOfFill): IPCB_PrimitiveFill;
3036
+ /**
3037
+ * 设置属性状态:复杂多边形
3038
+ *
3039
+ * @beta
3040
+ * @param complexPolygon - 复杂多边形
3041
+ * @returns 填充图元对象
3042
+ */
3043
+ setState_ComplexPolygon(complexPolygon: IPCB_ComplexPolygon): IPCB_PrimitiveFill;
3044
+ /**
3045
+ * 设置属性状态:填充模式
3046
+ *
3047
+ * @beta
3048
+ * @param fillMode - 填充模式
3049
+ * @returns 填充图元对象
3050
+ */
3051
+ setState_FillMode(fillMode: EPCB_PrimitiveFillMode): IPCB_PrimitiveFill;
3052
+ /**
3053
+ * 设置属性状态:线宽
3054
+ *
3055
+ * @beta
3056
+ * @param lineWidth - 线宽
3057
+ * @returns 填充图元对象
3058
+ */
3059
+ setState_LineWidth(lineWidth: number): IPCB_PrimitiveFill;
3060
+ /**
3061
+ * 设置属性状态:是否锁定
3062
+ *
3063
+ * @beta
3064
+ * @param primitiveLock - 是否锁定
3065
+ * @returns 填充图元对象
3066
+ */
3067
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveFill;
3068
+ /**
3069
+ * 将图元转换为异步图元
3070
+ *
3071
+ * @public
3072
+ * @returns 填充图元对象
3073
+ */
3074
+ toAsync(): IPCB_PrimitiveFill;
3075
+ /**
3076
+ * 将图元转换为同步图元
3077
+ *
3078
+ * @public
3079
+ * @returns 填充图元对象
3080
+ */
3081
+ toSync(): IPCB_PrimitiveFill;
3082
+ /**
3083
+ * 查询图元是否为异步图元
3084
+ *
3085
+ * @public
3086
+ * @returns 是否为异步图元
3087
+ */
3088
+ isAsync(): boolean;
3089
+ /* Excluded from this release type: reset */
3090
+ /* Excluded from this release type: done */
3091
+ /* Excluded from this release type: convertToPolyline */
3092
+ /* Excluded from this release type: convertToPour */
3093
+ /* Excluded from this release type: convertToRegion */
3094
+ }
3095
+
3096
+ /**
3097
+ * 图像图元
3098
+ *
3099
+ * @public
3100
+ */
3101
+ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
3102
+ /** 异步 */
3103
+ private async;
3104
+ /** 图元类型 */
3105
+ private readonly primitiveType;
3106
+ /** 图元 ID */
3107
+ private primitiveId?;
3108
+ /** BBox 左上点坐标 X */
3109
+ private x;
3110
+ /** BBox 左上点坐标 Y */
3111
+ private y;
3112
+ /** 图像源数据(复杂多边形) */
3113
+ private complexPolygon;
3114
+ /** 层 */
3115
+ private layer;
3116
+ /** 宽 */
3117
+ private width;
3118
+ /** 高 */
3119
+ private height;
3120
+ /** 旋转角度 */
3121
+ private rotation;
3122
+ /** 是否水平镜像 */
3123
+ private horizonMirror;
3124
+ /** 是否锁定 */
3125
+ private primitiveLock;
3126
+ /* Excluded from this release type: __constructor */
3127
+ /* Excluded from this release type: create */
3128
+ /**
3129
+ * 获取属性状态:图元类型
3130
+ *
3131
+ * @public
3132
+ * @returns 图元类型
3133
+ */
3134
+ getState_PrimitiveType(): EPCB_PrimitiveType;
3135
+ /**
3136
+ * 获取属性状态:图元 ID
3137
+ *
3138
+ * @public
3139
+ * @returns 图元 ID
3140
+ */
3141
+ getState_PrimitiveId(): string;
3142
+ /**
3143
+ * 获取属性状态:BBox 左上点坐标 X
3144
+ *
3145
+ * @public
3146
+ * @returns BBox 左上点坐标 X
3147
+ */
3148
+ getState_X(): number;
3149
+ /**
3150
+ * 获取属性状态:BBox 左上点坐标 Y
3151
+ *
3152
+ * @public
3153
+ * @returns BBox 左上点坐标 Y
3154
+ */
3155
+ getState_Y(): number;
3156
+ /**
3157
+ * 获取属性状态:图像源数据(复杂多边形)
3158
+ *
3159
+ * @public
3160
+ * @returns 图像源数据(复杂多边形)
3161
+ */
3162
+ getState_ComplexPolygon(): TPCB_PolygonSourceArray | Array<TPCB_PolygonSourceArray>;
3163
+ /**
3164
+ * 获取属性状态:层
3165
+ *
3166
+ * @public
3167
+ * @returns 层
3168
+ */
3169
+ getState_Layer(): TPCB_LayersOfImage;
3170
+ /**
3171
+ * 获取属性状态:宽
3172
+ *
3173
+ * @public
3174
+ * @returns 宽
3175
+ */
3176
+ getState_Width(): number;
3177
+ /**
3178
+ * 获取属性状态:高
3179
+ *
3180
+ * @public
3181
+ * @returns 高
3182
+ */
3183
+ getState_Height(): number;
3184
+ /**
3185
+ * 获取属性状态:旋转角度
3186
+ *
3187
+ * @public
3188
+ * @returns 旋转角度
3189
+ */
3190
+ getState_Rotation(): number;
3191
+ /**
3192
+ * 获取属性状态:是否水平镜像
3193
+ *
3194
+ * @public
3195
+ * @returns 是否水平镜像
3196
+ */
3197
+ getState_HorizonMirror(): boolean;
3198
+ /**
3199
+ * 获取属性状态:是否锁定
3200
+ *
3201
+ * @public
3202
+ * @returns 是否锁定
3203
+ */
3204
+ getState_PrimitiveLock(): boolean;
3205
+ /**
3206
+ * 设置属性状态:BBox 左上点坐标 X
3207
+ *
3208
+ * @beta
3209
+ * @param x - BBox 左上点坐标 X
3210
+ * @returns 图像图元对象
3211
+ */
3212
+ setState_X(x: number): IPCB_PrimitiveImage;
3213
+ /**
3214
+ * 设置属性状态:BBox 左上点坐标 Y
3215
+ *
3216
+ * @beta
3217
+ * @param y - BBox 左上点坐标 Y
3218
+ * @returns 图像图元对象
3219
+ */
3220
+ setState_Y(y: number): IPCB_PrimitiveImage;
3221
+ /**
3222
+ * 设置属性状态:层
3223
+ *
3224
+ * @beta
3225
+ * @param layer - 层
3226
+ * @returns 图像图元对象
3227
+ */
3228
+ setState_Layer(layer: TPCB_LayersOfImage): IPCB_PrimitiveImage;
3229
+ /**
3230
+ * 设置属性状态:宽
3231
+ *
3232
+ * @beta
3233
+ * @param width - 宽
3234
+ * @returns 图像图元对象
3235
+ */
3236
+ setState_Width(width: number): IPCB_PrimitiveImage;
3237
+ /**
3238
+ * 设置属性状态:高
3239
+ *
3240
+ * @beta
3241
+ * @param height - 高
3242
+ * @returns 图像图元对象
3243
+ */
3244
+ setState_Height(height: number): IPCB_PrimitiveImage;
3245
+ /**
3246
+ * 设置属性状态:旋转角度
3247
+ *
3248
+ * @beta
3249
+ * @param rotation - 旋转角度
3250
+ * @returns 图像图元对象
3251
+ */
3252
+ setState_Rotation(rotation: number): IPCB_PrimitiveImage;
3253
+ /**
3254
+ * 设置属性状态:是否水平镜像
3255
+ *
3256
+ * @beta
3257
+ * @param horizonMirror - 是否水平镜像
3258
+ * @returns 图像图元对象
3259
+ */
3260
+ setState_HorizonMirror(horizonMirror: boolean): IPCB_PrimitiveImage;
3261
+ /**
3262
+ * 设置属性状态:是否锁定
3263
+ *
3264
+ * @beta
3265
+ * @param primitiveLock - 是否锁定
3266
+ * @returns 图像图元对象
3267
+ */
3268
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveImage;
3269
+ /**
3270
+ * 将图元转换为异步图元
3271
+ *
3272
+ * @public
3273
+ * @returns 图像图元对象
3274
+ */
3275
+ toAsync(): IPCB_PrimitiveImage;
3276
+ /**
3277
+ * 将图元转换为同步图元
3278
+ *
3279
+ * @public
3280
+ * @returns 图像图元对象
3281
+ */
3282
+ toSync(): IPCB_PrimitiveImage;
3283
+ /**
3284
+ * 查询图元是否为异步图元
3285
+ *
3286
+ * @public
3287
+ * @returns 是否为异步图元
3288
+ */
3289
+ isAsync(): boolean;
3290
+ /**
3291
+ * 将异步图元重置为当前画布状态
3292
+ *
3293
+ * @beta
3294
+ * @returns 图像图元对象
3295
+ */
3296
+ reset(): Promise<IPCB_PrimitiveImage>;
3297
+ /**
3298
+ * 将对图元的更改应用到画布
3299
+ *
3300
+ * @beta
3301
+ * @returns 图像图元对象
3302
+ */
3303
+ done(): Promise<IPCB_PrimitiveImage>;
3304
+ /* Excluded from this release type: setState_ComplexPolygon */
3305
+ }
3306
+
3307
+ /**
3308
+ * 导线图元
3309
+ *
3310
+ * @public
3311
+ */
3312
+ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
3313
+ /** 异步 */
3314
+ private async;
3315
+ /** 图元类型 */
3316
+ private readonly primitiveType;
3317
+ /** 图元 ID */
3318
+ private primitiveId?;
3319
+ /** 网络名称 */
3320
+ private net;
3321
+ /** 层 */
3322
+ private layer;
3323
+ /** 起始位置 X */
3324
+ private startX;
3325
+ /** 起始位置 Y */
3326
+ private startY;
3327
+ /** 终止位置 X */
3328
+ private endX;
3329
+ /** 终止位置 Y */
3330
+ private endY;
3331
+ /** 线宽 */
3332
+ private lineWidth;
3333
+ /** 是否锁定 */
3334
+ private primitiveLock;
3335
+ /* Excluded from this release type: __constructor */
3336
+ /* Excluded from this release type: create */
3337
+ /**
3338
+ * 获取属性状态:图元类型
3339
+ *
3340
+ * @public
3341
+ * @returns 图元类型
3342
+ */
3343
+ getState_PrimitiveType(): EPCB_PrimitiveType;
3344
+ /**
3345
+ * 获取属性状态:图元 ID
3346
+ *
3347
+ * @public
3348
+ * @returns 图元 ID
3349
+ */
3350
+ getState_PrimitiveId(): string;
3351
+ /**
3352
+ * 获取属性状态:网络名称
3353
+ *
3354
+ * @public
3355
+ * @returns 网络名称
3356
+ */
3357
+ getState_Net(): string;
3358
+ /**
3359
+ * 获取属性状态:层
3360
+ *
3361
+ * @public
3362
+ * @returns 层
3363
+ */
3364
+ getState_Layer(): TPCB_LayersOfLine;
3365
+ /**
3366
+ * 获取属性状态:起始位置 X
3367
+ *
3368
+ * @public
3369
+ * @returns 起始位置 X
3370
+ */
3371
+ getState_StartX(): number;
3372
+ /**
3373
+ * 获取属性状态:起始位置 Y
3374
+ *
3375
+ * @public
3376
+ * @returns 起始位置 Y
3377
+ */
3378
+ getState_StartY(): number;
3379
+ /**
3380
+ * 获取属性状态:终止位置 X
3381
+ *
3382
+ * @public
3383
+ * @returns 终止位置 X
3384
+ */
3385
+ getState_EndX(): number;
3386
+ /**
3387
+ * 获取属性状态:终止位置 Y
3388
+ *
3389
+ * @public
3390
+ * @returns 终止位置 Y
3391
+ */
3392
+ getState_EndY(): number;
3393
+ /**
3394
+ * 获取属性状态:线宽
3395
+ *
3396
+ * @public
3397
+ * @returns 线宽
3398
+ */
3399
+ getState_LineWidth(): number;
3400
+ /**
3401
+ * 获取属性状态:是否锁定
3402
+ *
3403
+ * @public
3404
+ * @returns 是否锁定
3405
+ */
3406
+ getState_PrimitiveLock(): boolean;
3407
+ /**
3408
+ * 设置属性状态:网络名称
3409
+ *
3410
+ * @beta
3411
+ * @param net - 网络名称
3412
+ * @returns 导线图元对象
3413
+ */
3414
+ setState_Net(net: string): IPCB_PrimitiveLine;
3415
+ /**
3416
+ * 设置属性状态:层
3417
+ *
3418
+ * @beta
3419
+ * @param layer - 层
3420
+ * @returns 导线图元对象
3421
+ */
3422
+ setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitiveLine;
3423
+ /**
3424
+ * 设置属性状态:起始位置 X
3425
+ *
3426
+ * @beta
3427
+ * @param startX - 起始位置 X
3428
+ * @returns 导线图元对象
3429
+ */
3430
+ setState_StartX(startX: number): IPCB_PrimitiveLine;
3431
+ /**
3432
+ * 设置属性状态:起始位置 Y
3433
+ *
3434
+ * @beta
3435
+ * @param startY - 起始位置 Y
3436
+ * @returns 导线图元对象
3437
+ */
3438
+ setState_StartY(startY: number): IPCB_PrimitiveLine;
3439
+ /**
3440
+ * 设置属性状态:终止位置 X
3441
+ *
3442
+ * @beta
3443
+ * @param endX - 终止位置 X
3444
+ * @returns 导线图元对象
3445
+ */
3446
+ setState_EndX(endX: number): IPCB_PrimitiveLine;
3447
+ /**
3448
+ * 设置属性状态:终止位置 Y
3449
+ *
3450
+ * @beta
3451
+ * @param endY - 终止位置 Y
3452
+ * @returns 导线图元对象
3453
+ */
3454
+ setState_EndY(endY: number): IPCB_PrimitiveLine;
3455
+ /**
3456
+ * 设置属性状态:线宽
3457
+ *
3458
+ * @beta
3459
+ * @param lineWidth - 线宽
3460
+ * @returns 导线图元对象
3461
+ */
3462
+ setState_LineWidth(lineWidth: number): IPCB_PrimitiveLine;
3463
+ /**
3464
+ * 设置属性状态:是否锁定
3465
+ *
3466
+ * @beta
3467
+ * @param primitiveLock - 是否锁定
3468
+ * @returns 导线图元对象
3469
+ */
3470
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveLine;
3471
+ /**
3472
+ * 将图元转换为异步图元
3473
+ *
3474
+ * @public
3475
+ * @returns 导线图元对象
3476
+ */
3477
+ toAsync(): IPCB_PrimitiveLine;
3478
+ /**
3479
+ * 将图元转换为同步图元
3480
+ *
3481
+ * @public
3482
+ * @returns 导线图元对象
3483
+ */
3484
+ toSync(): IPCB_PrimitiveLine;
3485
+ /**
3486
+ * 查询图元是否为异步图元
3487
+ *
3488
+ * @public
3489
+ * @returns 是否为异步图元
3490
+ */
3491
+ isAsync(): boolean;
3492
+ /**
3493
+ * 将异步图元重置为当前画布状态
3494
+ *
3495
+ * @beta
3496
+ * @returns 导线图元对象
3497
+ */
3498
+ reset(): Promise<IPCB_PrimitiveLine>;
3499
+ /**
3500
+ * 将对图元的更改应用到画布
3501
+ *
3502
+ * @beta
3503
+ * @returns 导线图元对象
3504
+ */
3505
+ done(): Promise<IPCB_PrimitiveLine>;
3506
+ }
3507
+
3508
+ /**
3509
+ * 焊盘图元
3510
+ *
3511
+ * @public
3512
+ */
3513
+ declare class IPCB_PrimitivePad implements IPCB_Primitive {
3514
+ /** 异步 */
3515
+ private async;
3516
+ /** 图元类型 */
3517
+ private readonly primitiveType;
3518
+ /** 图元 ID */
3519
+ private primitiveId?;
3520
+ /** 层 */
3521
+ private layer;
3522
+ /** 焊盘编号 */
3523
+ private padNumber;
3524
+ /** 位置 X */
3525
+ private x;
3526
+ /** 位置 Y */
3527
+ private y;
3528
+ /** 旋转角度 */
3529
+ private rotation;
3530
+ /** 焊盘外形 */
3531
+ private pad?;
3532
+ /** 网络名称 */
3533
+ private net?;
3534
+ /** 孔 */
3535
+ private hole;
3536
+ /** 孔偏移 X */
3537
+ private holeOffsetX;
3538
+ /** 孔偏移 Y */
3539
+ private holeOffsetY;
3540
+ /** 孔相对于焊盘的旋转角度 */
3541
+ private holeRotation;
3542
+ /** 是否金属化孔壁 */
3543
+ private metallization;
3544
+ /** 焊盘功能 */
3545
+ private padFunction;
3546
+ /** 特殊焊盘外形 */
3547
+ private specialPad?;
3548
+ /** 阻焊/助焊扩展 */
3549
+ private solderMaskAndPasteMaskExpansion;
3550
+ /** 热焊优化参数 */
3551
+ private heatWelding;
3552
+ /** 是否锁定 */
3553
+ private primitiveLock;
3554
+ /* Excluded from this release type: __constructor */
3555
+ /**
3556
+ * 在 PCB 画布中创建图元
3557
+ *
3558
+ * @beta
3559
+ * @returns 焊盘图元对象
3560
+ */
3561
+ create(): Promise<IPCB_PrimitivePad>;
3562
+ /**
3563
+ * 获取属性状态:图元类型
3564
+ *
3565
+ * @public
3566
+ * @returns 图元类型
3567
+ */
3568
+ getState_PrimitiveType(): EPCB_PrimitiveType;
3569
+ /**
3570
+ * 获取属性状态:图元 ID
3571
+ *
3572
+ * @public
3573
+ * @returns 图元 ID
3574
+ */
3575
+ getState_PrimitiveId(): string;
3576
+ /**
3577
+ * 获取属性状态:层
3578
+ *
3579
+ * @public
3580
+ * @returns 层
3581
+ */
3582
+ getState_Layer(): TPCB_LayersOfPad;
3583
+ /**
3584
+ * 获取属性状态:焊盘编号
3585
+ *
3586
+ * @public
3587
+ * @returns 焊盘编号
3588
+ */
3589
+ getState_PadNumber(): string;
3590
+ /**
3591
+ * 获取属性状态:位置 X
3592
+ *
3593
+ * @public
3594
+ * @returns 位置 X
3595
+ */
3596
+ getState_X(): number;
3597
+ /**
3598
+ * 获取属性状态:位置 Y
3599
+ *
3600
+ * @public
3601
+ * @returns 位置 Y
3602
+ */
3603
+ getState_Y(): number;
3604
+ /**
3605
+ * 获取属性状态:旋转角度
3606
+ *
3607
+ * @public
3608
+ * @returns 旋转角度
3609
+ */
3610
+ getState_Rotation(): number;
3611
+ /**
3612
+ * 获取属性状态:焊盘外形
3613
+ *
3614
+ * @public
3615
+ * @returns 焊盘外形
3616
+ */
3617
+ getState_Pad(): TPCB_PrimitivePadShape | undefined;
3618
+ /**
3619
+ * 获取属性状态:网络名称
3620
+ *
3621
+ * @public
3622
+ * @returns 网络名称
3623
+ */
3624
+ getState_Net(): string | undefined;
3625
+ /**
3626
+ * 获取属性状态:孔
3627
+ *
3628
+ * @public
3629
+ * @returns 孔
3630
+ */
3631
+ getState_Hole(): TPCB_PrimitivePadHole | null;
3632
+ /**
3633
+ * 获取属性状态:孔偏移 X
3634
+ *
3635
+ * @public
3636
+ * @returns 孔偏移 X
3637
+ */
3638
+ getState_HoleOffsetX(): number;
3639
+ /**
3640
+ * 获取属性状态:孔偏移 Y
3641
+ *
3642
+ * @public
3643
+ * @returns 孔偏移 Y
3644
+ */
3645
+ getState_HoleOffsetY(): number;
3646
+ /**
3647
+ * 获取属性状态:孔相对于焊盘的旋转角度
3648
+ *
3649
+ * @public
3650
+ * @returns 孔相对于焊盘的旋转角度
3651
+ */
3652
+ getState_HoleRotation(): number;
3653
+ /**
3654
+ * 获取属性状态:是否金属化孔壁
3655
+ *
3656
+ * @public
3657
+ * @returns 是否金属化孔壁
3658
+ */
3659
+ getState_Metallization(): boolean;
3660
+ /**
3661
+ * 获取属性状态:焊盘功能
3662
+ *
3663
+ * @public
3664
+ * @returns 焊盘功能
3665
+ */
3666
+ getState_PadFunction(): EPCB_PrimitivePadFunction;
3667
+ /**
3668
+ * 获取属性状态:特殊焊盘外形
3669
+ *
3670
+ * @public
3671
+ * @returns 特殊焊盘外形
3672
+ */
3673
+ getState_SpecialPad(): TPCB_PrimitiveSpecialPadShape | undefined;
3674
+ /**
3675
+ * 获取属性状态:阻焊/助焊扩展
3676
+ *
3677
+ * @public
3678
+ * @returns 阻焊/助焊扩展
3679
+ */
3680
+ getState_SolderMaskAndPasteMaskExpansion(): IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null;
3681
+ /**
3682
+ * 获取属性状态:热焊优化参数
3683
+ *
3684
+ * @public
3685
+ * @returns 热焊优化参数
3686
+ */
3687
+ getState_HeatWelding(): IPCB_PrimitivePadHeatWelding | null;
3688
+ /**
3689
+ * 获取属性状态:是否锁定
3690
+ *
3691
+ * @public
3692
+ * @returns 是否锁定
3693
+ */
3694
+ getState_PrimitiveLock(): boolean;
3695
+ /**
3696
+ * 设置属性状态:层
3697
+ *
3698
+ * @beta
3699
+ * @remarks
3700
+ * 设置层时将会联动设置部分其它属性状态:
3701
+ *
3702
+ * 1. 顶层与底层切换时:阻焊/助焊扩展属性将会跟随切换,数据值不变
3703
+ *
3704
+ * 2. 多层切换到单层时:判断切换到顶层还是底层,阻焊/助焊扩展属性将只保留指定层对应的数据;如若存在特殊焊盘,将转换为普通焊盘属性,并且只保留指定层对应的数据;与孔有关的属性将被重置到默认值
3705
+ *
3706
+ * 3. 单层切换到多层时:阻焊/助焊扩展属性将只保留阻焊扩展,并复制原数据应用于顶层和底层;焊盘钻孔属性将被赋指定值,长宽均为焊盘直径(焊盘为长圆形或正多边形)、宽(焊盘为矩形)的 60% 的长圆形(数据层面上是长圆形,实则是正圆形),如若焊盘为折线复杂多边形,则通过专用算法计算得出数据(通常比较抽象,建议后期修改)
3707
+ *
3708
+ * @param layer - 层
3709
+ * @returns 焊盘图元对象
3710
+ */
3711
+ setState_Layer(layer: TPCB_LayersOfPad): IPCB_PrimitivePad;
3712
+ /**
3713
+ * 设置属性状态:焊盘编号
3714
+ *
3715
+ * @beta
3716
+ * @param padNumber - 焊盘编号
3717
+ * @returns 焊盘图元对象
3718
+ */
3719
+ setState_PadNumber(padNumber: string): IPCB_PrimitivePad;
3720
+ /**
3721
+ * 设置属性状态:位置 X
3722
+ *
3723
+ * @beta
3724
+ * @param x - 位置 X
3725
+ * @returns 焊盘图元对象
3726
+ */
3727
+ setState_X(x: number): IPCB_PrimitivePad;
3728
+ /**
3729
+ * 设置属性状态:位置 Y
3730
+ *
3731
+ * @beta
3732
+ * @param y - 位置 Y
3733
+ * @returns 焊盘图元对象
3734
+ */
3735
+ setState_Y(y: number): IPCB_PrimitivePad;
3736
+ /**
3737
+ * 设置属性状态:旋转角度
3738
+ *
3739
+ * @beta
3740
+ * @param rotation - 旋转角度
3741
+ * @returns 焊盘图元对象
3742
+ */
3743
+ setState_Rotation(rotation: number): IPCB_PrimitivePad;
3744
+ /**
3745
+ * 设置属性状态:焊盘外形
3746
+ *
3747
+ * @beta
3748
+ * @remarks
3749
+ * 设置焊盘外形时将会联动设置部分其它属性状态:
3750
+ *
3751
+ * 1. 特殊焊盘外形属性将被清空
3752
+ *
3753
+ * @param pad - 焊盘外形
3754
+ * @returns 焊盘图元对象
3755
+ */
3756
+ setState_Pad(pad: TPCB_PrimitivePadShape): IPCB_PrimitivePad;
3757
+ /**
3758
+ * 设置属性状态:网络
3759
+ *
3760
+ * @beta
3761
+ * @remarks 本接口仅在 PCB 编辑器可用,空字符串与 `undefined` 均被视为空网络
3762
+ * @param net - 网络名称
3763
+ * @returns 焊盘图元对象
3764
+ */
3765
+ setState_Net(net?: string): IPCB_PrimitivePad;
3766
+ /**
3767
+ * 设置属性状态:孔
3768
+ *
3769
+ * @beta
3770
+ * @remarks
3771
+ * 设置孔时将会联动设置部分其它属性状态:
3772
+ *
3773
+ * 1. 层将会强制切换到多层
3774
+ *
3775
+ * 本接口无法将孔设置为 `null`,如果想要移除孔属性,请使用 {@link IPCB_PrimitivePad.setState_Layer | setState_Layer} 方法切换层为顶层或底层
3776
+ *
3777
+ * @param hole - 焊盘钻孔
3778
+ * @returns 焊盘图元对象
3779
+ */
3780
+ setState_Hole(hole: TPCB_PrimitivePadHole): IPCB_PrimitivePad;
3781
+ /**
3782
+ * 设置属性状态:孔偏移 X
3783
+ *
3784
+ * @beta
3785
+ * @remarks 如若孔不存在,则属性将不会被修改
3786
+ * @param holeOffsetX - 孔偏移 X
3787
+ * @returns 焊盘图元对象
3788
+ */
3789
+ setState_HoleOffsetX(holeOffsetX: number): IPCB_PrimitivePad;
3790
+ /**
3791
+ * 设置属性状态:孔偏移 Y
3792
+ *
3793
+ * @beta
3794
+ * @remarks 如若孔不存在,则属性将不会被修改
3795
+ * @param holeOffsetY - 孔偏移 Y
3796
+ * @returns 焊盘图元对象
3797
+ */
3798
+ setState_HoleOffsetY(holeOffsetY: number): IPCB_PrimitivePad;
3799
+ /**
3800
+ * 设置属性状态:孔相对于焊盘的旋转角度
3801
+ *
3802
+ * @beta
3803
+ * @remarks 如若孔不存在,则属性将不会被修改
3804
+ * @param holeRotation - 孔相对于焊盘的旋转角度
3805
+ * @returns 焊盘图元对象
3806
+ */
3807
+ setState_HoleRotation(holeRotation: number): IPCB_PrimitivePad;
3808
+ /**
3809
+ * 设置属性状态:是否金属化孔壁
3810
+ *
3811
+ * @beta
3812
+ * @remarks 如若孔不存在,则属性将不会被修改
3813
+ * @param metallization - 是否金属化孔壁
3814
+ * @returns 焊盘图元对象
3815
+ */
3816
+ setState_Metallization(metallization: boolean): IPCB_PrimitivePad;
3817
+ /**
3818
+ * 设置属性状态:焊盘功能
3819
+ *
3820
+ * @beta
3821
+ * @param padFunction - 焊盘功能
3822
+ * @returns 焊盘图元对象
3823
+ */
3824
+ setState_PadFunction(padFunction: EPCB_PrimitivePadFunction): IPCB_PrimitivePad;
3825
+ /**
3826
+ * 设置属性状态:特殊焊盘外形
3827
+ *
3828
+ * @beta
3829
+ * @remarks
3830
+ * 设置特殊焊盘外形时将会联动设置部分其它属性状态:
3831
+ *
3832
+ * 1. 焊盘外形属性将被清空
3833
+ *
3834
+ * @param pad - 特殊焊盘外形
3835
+ * @returns 焊盘图元对象
3836
+ */
3837
+ setState_SpecialPad(specialPad: TPCB_PrimitiveSpecialPadShape): IPCB_PrimitivePad;
3838
+ /**
3839
+ * 设置属性状态:阻焊/助焊扩展
3840
+ *
3841
+ * @beta
3842
+ * @param solderMaskAndPasteMaskExpansion - 阻焊/助焊扩展
3843
+ * @returns 焊盘图元对象
3844
+ */
3845
+ setState_SolderMaskAndPasteMaskExpansion(solderMaskAndPasteMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null): IPCB_PrimitivePad;
3846
+ /**
3847
+ * 设置属性状态:热焊优化参数
3848
+ *
3849
+ * @beta
3850
+ * @param heatWelding - 热焊优化参数
3851
+ * @returns 焊盘图元对象
3852
+ */
3853
+ setState_HeatWelding(heatWelding: IPCB_PrimitivePadHeatWelding | null): IPCB_PrimitivePad;
3854
+ /**
3855
+ * 设置属性状态:是否锁定
3856
+ *
3857
+ * @beta
3858
+ * @param primitiveLock - 是否锁定
3859
+ * @returns 焊盘图元对象
3860
+ */
3861
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePad;
2787
3862
  /**
2788
3863
  * 将图元转换为异步图元
2789
3864
  *
2790
3865
  * @public
2791
- * @returns 图像图元对象
3866
+ * @returns 焊盘图元对象
2792
3867
  */
2793
- toAsync(): IPCB_PrimitiveImage;
3868
+ toAsync(): IPCB_PrimitivePad;
2794
3869
  /**
2795
3870
  * 将图元转换为同步图元
2796
3871
  *
2797
3872
  * @public
2798
- * @returns 图像图元对象
3873
+ * @returns 焊盘图元对象
2799
3874
  */
2800
- toSync(): IPCB_PrimitiveImage;
3875
+ toSync(): IPCB_PrimitivePad;
2801
3876
  /**
2802
3877
  * 查询图元是否为异步图元
2803
3878
  *
@@ -2809,32 +3884,42 @@ declare class IPCB_PrimitiveImage implements IPCB_Primitive {
2809
3884
  * 将异步图元重置为当前画布状态
2810
3885
  *
2811
3886
  * @beta
2812
- * @returns 图像图元对象
3887
+ * @returns 焊盘图元对象
2813
3888
  */
2814
- reset(): Promise<IPCB_PrimitiveImage>;
3889
+ reset(): Promise<IPCB_PrimitivePad>;
2815
3890
  /**
2816
3891
  * 将对图元的更改应用到画布
2817
3892
  *
2818
3893
  * @beta
2819
- * @returns 图像图元对象
2820
- */
2821
- done(): Promise<IPCB_PrimitiveImage>;
2822
- /**
2823
- * 设置属性状态:图像源数据
2824
- *
2825
- * @beta
2826
- * @param complexPolygon - 图像源数据
2827
- * @returns 图像图元对象
3894
+ * @returns 尺寸标注图元对象
2828
3895
  */
2829
- private setState_ComplexPolygon;
3896
+ done(): Promise<IPCB_PrimitivePad>;
2830
3897
  }
2831
3898
 
2832
3899
  /**
2833
- * 导线图元
3900
+ * 焊盘热焊优化参数
2834
3901
  *
2835
3902
  * @public
3903
+ * @remarks
3904
+ * 当连接方式({@link IPCB_PrimitivePadHeatWelding.connectionMethod | connectionMethod})为直连({@link EPCB_PrimitivePadHeatWeldingConnectionMethod.DIRECT_CONNECTED | DIRECT_CONNECTED})、无连接({@link EPCB_PrimitivePadHeatWeldingConnectionMethod.NON_CONNECTED | NON_CONNECTED})时,发散间距、发散线宽、发散角度的设置将被忽略
2836
3905
  */
2837
- declare class IPCB_PrimitiveLine implements IPCB_Primitive {
3906
+ declare interface IPCB_PrimitivePadHeatWelding {
3907
+ /** 连接方式 */
3908
+ connectionMethod: EPCB_PrimitivePadHeatWeldingConnectionMethod;
3909
+ /** 发散间距 */
3910
+ divergenceSpacing?: number;
3911
+ /** 发散线宽 */
3912
+ divergenceLineWidth?: number;
3913
+ /** 发散角度 */
3914
+ divergenceAngle?: number;
3915
+ }
3916
+
3917
+ /**
3918
+ * 折线图元
3919
+ *
3920
+ * @public
3921
+ */
3922
+ declare class IPCB_PrimitivePolyline implements IPCB_Primitive {
2838
3923
  /** 异步 */
2839
3924
  private async;
2840
3925
  /** 图元类型 */
@@ -2845,309 +3930,338 @@ declare class IPCB_PrimitiveLine implements IPCB_Primitive {
2845
3930
  private net;
2846
3931
  /** 层 */
2847
3932
  private layer;
2848
- /** 起始位置 X */
2849
- private startX;
2850
- /** 起始位置 Y */
2851
- private startY;
2852
- /** 终止位置 X */
2853
- private endX;
2854
- /** 终止位置 Y */
2855
- private endY;
3933
+ /** 单多边形 */
3934
+ private polygon;
2856
3935
  /** 线宽 */
2857
3936
  private lineWidth;
2858
3937
  /** 是否锁定 */
2859
3938
  private primitiveLock;
2860
3939
  /* Excluded from this release type: __constructor */
3940
+ /* Excluded from this release type: create */
2861
3941
  /**
2862
- * 在 PCB 画布中创建图元
3942
+ * 获取属性状态:图元类型
2863
3943
  *
2864
- * @beta
2865
- * @returns 导线图元对象
3944
+ * @public
3945
+ * @returns 图元类型
2866
3946
  */
2867
- create(): Promise<IPCB_PrimitiveLine>;
3947
+ getState_PrimitiveType(): EPCB_PrimitiveType;
2868
3948
  /**
2869
- * 获取对象的图元 ID
3949
+ * 获取属性状态:图元 ID
2870
3950
  *
2871
- * @returns
3951
+ * @public
3952
+ * @returns 图元 ID
2872
3953
  */
2873
3954
  getState_PrimitiveId(): string;
2874
- /* Excluded from this release type: setState_Net */
2875
- /* Excluded from this release type: setState_Layer */
2876
- /* Excluded from this release type: setState_StartX */
2877
- /* Excluded from this release type: setState_StartY */
2878
- /* Excluded from this release type: setState_EndX */
2879
- /* Excluded from this release type: setState_EndY */
2880
- /* Excluded from this release type: setState_LineWidth */
2881
- /* Excluded from this release type: setState_PrimitiveLock */
3955
+ /**
3956
+ * 获取属性状态:网络名称
3957
+ *
3958
+ * @public
3959
+ * @returns 网络名称
3960
+ */
3961
+ getState_Net(): string;
3962
+ /**
3963
+ * 获取属性状态:层
3964
+ *
3965
+ * @public
3966
+ * @returns 层
3967
+ */
3968
+ getState_Layer(): TPCB_LayersOfLine;
3969
+ /**
3970
+ * 获取属性状态:单多边形
3971
+ *
3972
+ * @public
3973
+ * @returns 单多边形
3974
+ */
3975
+ getState_Polygon(): IPCB_Polygon;
3976
+ /**
3977
+ * 获取属性状态:线宽
3978
+ *
3979
+ * @public
3980
+ * @returns 线宽
3981
+ */
3982
+ getState_LineWidth(): number;
3983
+ /**
3984
+ * 获取属性状态:是否锁定
3985
+ *
3986
+ * @public
3987
+ * @returns 是否锁定
3988
+ */
3989
+ getState_PrimitiveLock(): boolean;
3990
+ /**
3991
+ * 设置属性状态:网络名称
3992
+ *
3993
+ * @beta
3994
+ * @param net - 网络名称
3995
+ * @returns 折线图元对象
3996
+ */
3997
+ setState_Net(net: string): IPCB_PrimitivePolyline;
3998
+ /**
3999
+ * 设置属性状态:层
4000
+ *
4001
+ * @beta
4002
+ * @param layer - 层
4003
+ * @returns 折线图元对象
4004
+ */
4005
+ setState_Layer(layer: TPCB_LayersOfLine): IPCB_PrimitivePolyline;
4006
+ /**
4007
+ * 设置属性���态:单多边形
4008
+ *
4009
+ * @beta
4010
+ * @param polygon - 单多边形
4011
+ * @returns 折线图元对象
4012
+ */
4013
+ setState_Polygon(polygon: IPCB_Polygon): IPCB_PrimitivePolyline;
4014
+ /**
4015
+ * 设置属性状态:线宽
4016
+ *
4017
+ * @beta
4018
+ * @param lineWidth - 线宽
4019
+ * @returns 折线图元对象
4020
+ */
4021
+ setState_LineWidth(lineWidth: number): IPCB_PrimitivePolyline;
4022
+ /**
4023
+ * 设置属性状态:是否锁定
4024
+ *
4025
+ * @beta
4026
+ * @param primitiveLock - 是否锁定
4027
+ * @returns 折线图元对象
4028
+ */
4029
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePolyline;
2882
4030
  /**
2883
4031
  * 将图元转换为异步图元
4032
+ *
4033
+ * @public
4034
+ * @returns 折线图元对象
2884
4035
  */
2885
- toAsync(): IPCB_PrimitiveLine;
4036
+ toAsync(): IPCB_PrimitivePolyline;
2886
4037
  /**
2887
4038
  * 将图元转换为同步图元
4039
+ *
4040
+ * @public
4041
+ * @returns 折线图元对象
2888
4042
  */
2889
- toSync(): IPCB_PrimitiveLine;
4043
+ toSync(): IPCB_PrimitivePolyline;
2890
4044
  /**
2891
4045
  * 查询图元是否为异步图元
4046
+ *
4047
+ * @public
4048
+ * @returns 是否为异步图元
2892
4049
  */
2893
4050
  isAsync(): boolean;
2894
4051
  /**
2895
4052
  * 将异步图元重置为当前画布状态
2896
4053
  *
2897
4054
  * @beta
4055
+ * @returns 折线图元对象
2898
4056
  */
2899
- reset(): Promise<IPCB_PrimitiveLine>;
4057
+ reset(): Promise<IPCB_PrimitivePolyline>;
2900
4058
  /**
2901
4059
  * 将对图元的更改应用到画布
2902
4060
  *
2903
4061
  * @beta
4062
+ * @returns 折线图元对象
2904
4063
  */
2905
- done(): Promise<IPCB_PrimitiveLine>;
4064
+ done(): Promise<IPCB_PrimitivePolyline>;
4065
+ /* Excluded from this release type: convertToFill */
4066
+ /* Excluded from this release type: convertToPour */
4067
+ /* Excluded from this release type: convertToRegion */
2906
4068
  }
2907
4069
 
2908
4070
  /**
2909
- * 焊盘图元
4071
+ * 覆铜边框图元
2910
4072
  *
2911
4073
  * @public
2912
4074
  */
2913
- declare class IPCB_PrimitivePad implements IPCB_Primitive {
4075
+ declare class IPCB_PrimitivePour implements IPCB_Primitive {
2914
4076
  /** 异步 */
2915
4077
  private async;
2916
4078
  /** 图元类型 */
2917
4079
  private readonly primitiveType;
2918
4080
  /** 图元 ID */
2919
4081
  private primitiveId?;
4082
+ /** 网络名称 */
4083
+ private net;
2920
4084
  /** 层 */
2921
4085
  private layer;
2922
- /** 焊盘编号 */
2923
- private padNumber;
2924
- /** 位置 X */
2925
- private x;
2926
- /** 位置 Y */
2927
- private y;
2928
- /** 旋转角度 */
2929
- private rotation;
2930
- /** 焊盘外形 */
2931
- private pad?;
2932
- /** 网络名称 */
2933
- private net?;
2934
- /** 孔 */
2935
- private hole;
2936
- /** 孔偏移 X */
2937
- private holeOffsetX;
2938
- /** 孔偏移 Y */
2939
- private holeOffsetY;
2940
- /** 孔相对于焊盘的旋转角度 */
2941
- private holeRotation;
2942
- /** 是否金属化孔壁 */
2943
- private metallization;
2944
- /** 焊盘功能 */
2945
- private padFunction;
2946
- /** 特殊焊盘外形 */
2947
- private specialPad?;
2948
- /** 阻焊/助焊扩展 */
2949
- private solderMaskAndPasteMaskExpansion;
2950
- /** 热焊优化参数 */
2951
- private heatWelding;
4086
+ /** 复杂多边形 */
4087
+ private complexPolygon;
4088
+ /** 覆铜填充方法 */
4089
+ private pourFillMethod;
4090
+ /** 是否保留孤岛 */
4091
+ private preserveSilos;
4092
+ /** 覆铜边框名称 */
4093
+ private pourName?;
4094
+ /** 覆铜优先级 */
4095
+ private pourPriority?;
4096
+ /** 线宽 */
4097
+ private lineWidth?;
2952
4098
  /** 是否锁定 */
2953
4099
  private primitiveLock;
2954
4100
  /* Excluded from this release type: __constructor */
4101
+ /* Excluded from this release type: create */
2955
4102
  /**
2956
- * 在 PCB 画布中创建图元
4103
+ * 获取属性状态:图元类型
2957
4104
  *
2958
- * @beta
2959
- * @returns 焊盘图元对象
4105
+ * @public
4106
+ * @returns 图元类型
2960
4107
  */
2961
- create(): Promise<IPCB_PrimitivePad>;
4108
+ getState_PrimitiveType(): EPCB_PrimitiveType;
2962
4109
  /**
2963
- * 获取对象的图元 ID
4110
+ * 获取属性状态:图元 ID
2964
4111
  *
2965
- * @returns
4112
+ * @public
4113
+ * @returns 图元 ID
2966
4114
  */
2967
4115
  getState_PrimitiveId(): string;
2968
- /** @alpha 定义 getState_* 函数 × 19 */
2969
- /** @alpha 所有的 setState_* 方法都需要对数据进行基本的格式校验 */
2970
- /**
2971
- * 设置属性状态:层
2972
- *
2973
- * @beta
2974
- * @remarks
2975
- * 设置层时将会联动设置部分其它属性状态:
2976
- *
2977
- * 1. 顶层与底层切换时:阻焊/助焊扩展属性将会跟随切换,数据值不变
2978
- *
2979
- * 2. 多层切换到单层时:判断切换到顶层还是底层,阻焊/助焊扩展属性将只保留指定层对应的数据;如若存在特殊焊盘,将转换为普通焊盘属性,并且只保留指定层对应的数据;与孔有关的属性将被重置到默认值
2980
- *
2981
- * 3. 单层切换到多层时:阻焊/助焊扩展属性将只保留阻焊扩展,并复制原数据应用于顶层和底层;焊盘钻孔属性将被赋指定值,长宽均为焊盘直径(焊盘为长圆形或正多边形)、宽(焊盘为矩形)的 60% 的长圆形(数据层面上是长圆形,实则是正圆形),如若焊盘为折线复杂多边形,则通过专用算法计算得出数据(通常比较抽象,建议后期修改)
2982
- *
2983
- * @param layer - 层
2984
- * @returns 焊盘图元对象
2985
- */
2986
- setState_Layer(layer: TPCB_LayersOfPad): IPCB_PrimitivePad;
2987
- /**
2988
- * 设置属性状态:焊盘编号
2989
- *
2990
- * @beta
2991
- * @param padNumber - 焊盘编号
2992
- * @returns 焊盘图元对象
2993
- */
2994
- setState_PadNumber(padNumber: string): IPCB_PrimitivePad;
2995
4116
  /**
2996
- * 设置属性状态:位置 X
4117
+ * 获取属性状态:网络名称
2997
4118
  *
2998
- * @beta
2999
- * @param x - 位置 X
3000
- * @returns 焊盘图元对象
4119
+ * @public
4120
+ * @returns 网络名称
3001
4121
  */
3002
- setState_X(x: number): IPCB_PrimitivePad;
4122
+ getState_Net(): string;
3003
4123
  /**
3004
- * 设置属性状态:位置 Y
4124
+ * 获取属性状态:层
3005
4125
  *
3006
- * @beta
3007
- * @param y - 位置 Y
3008
- * @returns 焊盘图元对象
4126
+ * @public
4127
+ * @returns
3009
4128
  */
3010
- setState_Y(y: number): IPCB_PrimitivePad;
4129
+ getState_Layer(): TPCB_LayersOfCopper;
3011
4130
  /**
3012
- * 设置属性状态:旋转角度
4131
+ * 获取属性状态:复杂多边形
3013
4132
  *
3014
- * @beta
3015
- * @param rotation - 旋转角度
3016
- * @returns 焊盘图元对象
4133
+ * @public
4134
+ * @returns 复杂多边形
3017
4135
  */
3018
- setState_Rotation(rotation: number): IPCB_PrimitivePad;
4136
+ getState_ComplexPolygon(): IPCB_ComplexPolygon;
3019
4137
  /**
3020
- * 设置属性状态:焊盘外形
4138
+ * 获取属性状态:覆铜填充方法
3021
4139
  *
3022
- * @beta
3023
- * @remarks
3024
- * 设置焊盘外形时将会联动设置部分其它属性状态:
3025
- *
3026
- * 1. 特殊焊盘外形属性将被清空
3027
- *
3028
- * @param pad - 焊盘外形
3029
- * @returns 焊盘图元对象
4140
+ * @public
4141
+ * @returns 覆铜填充方法
3030
4142
  */
3031
- setState_Pad(pad: TPCB_PrimitivePadShape): IPCB_PrimitivePad;
4143
+ getState_PourFillMethod(): any;
3032
4144
  /**
3033
- * 设置属性状态:网络
4145
+ * 获取属性状态:是否保留孤岛
3034
4146
  *
3035
- * @beta
3036
- * @remarks 本接口仅在 PCB 编辑器可用,空字符串与 `undefined` 均被视为空网络
3037
- * @param net - 网络名称
3038
- * @returns 焊盘图元对象
4147
+ * @public
4148
+ * @returns 是否保留孤岛
3039
4149
  */
3040
- setState_Net(net?: string): IPCB_PrimitivePad;
4150
+ getState_PreserveSilos(): boolean;
3041
4151
  /**
3042
- * 设置属性状态:孔
4152
+ * 获取属性状态:覆铜边框名称
3043
4153
  *
3044
- * @beta
3045
- * @remarks
3046
- * 设置孔时将会联动设置部分其它属性状态:
4154
+ * @public
4155
+ * @returns 覆铜边框名称
4156
+ */
4157
+ getState_PourName(): string;
4158
+ /**
4159
+ * 获取属性状态:覆铜优先级
3047
4160
  *
3048
- * 1. 层将会强制切换到多层
4161
+ * @public
4162
+ * @returns 覆铜优先级
4163
+ */
4164
+ getState_PourPriority(): number;
4165
+ /**
4166
+ * 获取属性状态:线宽
3049
4167
  *
3050
- * 本接口无法将孔设置为 `null`,如果想要移除孔属性,请使用 {@link IPCB_PrimitivePad.setState_Layer | setState_Layer} 方法切换层为顶层或底层
4168
+ * @public
4169
+ * @returns 线宽
4170
+ */
4171
+ getState_LineWidth(): number;
4172
+ /**
4173
+ * 获取属性状态:是否锁定
3051
4174
  *
3052
- * @param hole - 焊盘钻孔
3053
- * @returns 焊盘图元对象
4175
+ * @public
4176
+ * @returns 是否锁定
3054
4177
  */
3055
- setState_Hole(hole: TPCB_PrimitivePadHole): IPCB_PrimitivePad;
4178
+ getState_PrimitiveLock(): boolean;
3056
4179
  /**
3057
- * 设置属性状态:孔偏移 X
4180
+ * 设置属性状态:网络名称
3058
4181
  *
3059
4182
  * @beta
3060
- * @remarks 如若孔不存在,则属性将不会被修改
3061
- * @param holeOffsetX - 孔偏移 X
3062
- * @returns 焊盘图元对象
4183
+ * @param net - 网络名称
4184
+ * @returns 覆铜边框图元对象
3063
4185
  */
3064
- setState_HoleOffsetX(holeOffsetX: number): IPCB_PrimitivePad;
4186
+ setState_Net(net: string): IPCB_PrimitivePour;
3065
4187
  /**
3066
- * 设置属性状态:孔偏移 Y
4188
+ * 设置属性状态:层
3067
4189
  *
3068
4190
  * @beta
3069
- * @remarks 如若孔不存在,则属性将不会被修改
3070
- * @param holeOffsetY - 孔偏移 Y
3071
- * @returns 焊盘图元对象
4191
+ * @param layer - 层
4192
+ * @returns 覆铜边框图元对象
3072
4193
  */
3073
- setState_HoleOffsetY(holeOffsetY: number): IPCB_PrimitivePad;
4194
+ setState_Layer(layer: TPCB_LayersOfCopper): IPCB_PrimitivePour;
3074
4195
  /**
3075
- * 设置属性状态:孔相对于焊盘的旋转角度
4196
+ * 设置属性状态:复杂多边形
3076
4197
  *
3077
4198
  * @beta
3078
- * @remarks 如若孔不存在,则属性将不会被修改
3079
- * @param holeRotation - 孔相对于焊盘的旋转角度
3080
- * @returns 焊盘图元对象
4199
+ * @param complexPolygon - 复杂多边形
4200
+ * @returns 覆铜边框图元对象
3081
4201
  */
3082
- setState_HoleRotation(holeRotation: number): IPCB_PrimitivePad;
4202
+ setState_ComplexPolygon(complexPolygon: IPCB_ComplexPolygon): IPCB_PrimitivePour;
3083
4203
  /**
3084
- * 设置属性状态:是否金属化孔壁
4204
+ * 设置属性状态:覆铜填充方法
3085
4205
  *
3086
4206
  * @beta
3087
- * @remarks 如若孔不存在,则属性将不会被修改
3088
- * @param metallization - 是否金属化孔壁
3089
- * @returns 焊盘图元对象
4207
+ * @param pourFillMethod - 覆铜填充方法
4208
+ * @returns 覆铜边框图元对象
3090
4209
  */
3091
- setState_Metallization(metallization: boolean): IPCB_PrimitivePad;
4210
+ setState_PourFillMethod(pourFillMethod: any): IPCB_PrimitivePour;
3092
4211
  /**
3093
- * 设置属性状态:焊盘功能
4212
+ * 设置属性状态:是否保留孤岛
3094
4213
  *
3095
4214
  * @beta
3096
- * @param padFunction - 焊盘功能
3097
- * @returns 焊盘图元对象
4215
+ * @param preserveSilos - 是否保留孤岛
4216
+ * @returns 覆铜边框图元对象
3098
4217
  */
3099
- setState_PadFunction(padFunction: EPCB_PrimitivePadFunction): IPCB_PrimitivePad;
4218
+ setState_PreserveSilos(preserveSilos: boolean): IPCB_PrimitivePour;
3100
4219
  /**
3101
- * 设置属性状态:特殊焊盘外形
4220
+ * 设置属性状态:覆铜边框名称
3102
4221
  *
3103
4222
  * @beta
3104
- * @remarks
3105
- * 设置特殊焊盘外形时将会联动设置部分其它属性状态:
3106
- *
3107
- * 1. 焊盘外形属性将被清空
3108
- *
3109
- * @param pad - 特殊焊盘外形
3110
- * @returns 焊盘图元对象
4223
+ * @param pourName - 覆铜边框名称
4224
+ * @returns 覆铜边框图元对象
3111
4225
  */
3112
- setState_SpecialPad(specialPad: TPCB_PrimitiveSpecialPadShape): IPCB_PrimitivePad;
4226
+ setState_PourName(pourName: string): IPCB_PrimitivePour;
3113
4227
  /**
3114
- * 设置属性状态:阻焊/助焊扩展
4228
+ * 设置属性状态:覆铜优先级
3115
4229
  *
3116
4230
  * @beta
3117
- * @param solderMaskAndPasteMaskExpansion - 阻焊/助焊扩展
3118
- * @returns 焊盘图元对象
4231
+ * @param pourPriority - 覆铜优先级
4232
+ * @returns 覆铜边框图元对象
3119
4233
  */
3120
- setState_SolderMaskAndPasteMaskExpansion(solderMaskAndPasteMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null): IPCB_PrimitivePad;
4234
+ setState_PourPriority(pourPriority: number): IPCB_PrimitivePour;
3121
4235
  /**
3122
- * 设置属性状态:热焊优化参数
4236
+ * 设置属性状态:线宽
3123
4237
  *
3124
4238
  * @beta
3125
- * @param heatWelding - 热焊优化参数
3126
- * @returns 焊盘图元对象
4239
+ * @param lineWidth - 线宽
4240
+ * @returns 覆铜边框图元对象
3127
4241
  */
3128
- setState_HeatWelding(heatWelding: IPCB_PrimitivePadHeatWelding | null): IPCB_PrimitivePad;
4242
+ setState_LineWidth(lineWidth: number): IPCB_PrimitivePour;
3129
4243
  /**
3130
4244
  * 设置属性状态:是否锁定
3131
4245
  *
3132
4246
  * @beta
3133
4247
  * @param primitiveLock - 是否锁定
3134
- * @returns 焊盘图元对象
4248
+ * @returns 覆铜边框图元对象
3135
4249
  */
3136
- setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePad;
4250
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitivePour;
3137
4251
  /**
3138
4252
  * 将图元转换为异步图元
3139
4253
  *
3140
4254
  * @public
3141
- * @returns 焊盘图元对象
4255
+ * @returns 覆铜边框图元对象
3142
4256
  */
3143
- toAsync(): IPCB_PrimitivePad;
4257
+ toAsync(): IPCB_PrimitivePour;
3144
4258
  /**
3145
4259
  * 将图元转换为同步图元
3146
4260
  *
3147
4261
  * @public
3148
- * @returns 焊盘图元对象
4262
+ * @returns 覆铜边框图元对象
3149
4263
  */
3150
- toSync(): IPCB_PrimitivePad;
4264
+ toSync(): IPCB_PrimitivePour;
3151
4265
  /**
3152
4266
  * 查询图元是否为异步图元
3153
4267
  *
@@ -3155,105 +4269,173 @@ declare class IPCB_PrimitivePad implements IPCB_Primitive {
3155
4269
  * @returns 是否为异步图元
3156
4270
  */
3157
4271
  isAsync(): boolean;
3158
- /**
3159
- * 将异步图元重置为当前画布状态
3160
- *
3161
- * @beta
3162
- * @returns 焊盘图元对象
3163
- */
3164
- reset(): Promise<IPCB_PrimitivePad>;
3165
- /**
3166
- * 将对图元的更改应用到画布
3167
- *
3168
- * @beta
3169
- * @returns 尺寸标注图元对象
3170
- */
3171
- done(): Promise<IPCB_PrimitivePad>;
3172
- }
3173
-
3174
- /**
3175
- * 焊盘热焊优化参数
3176
- *
3177
- * @public
3178
- * @remarks
3179
- * 当连接方式({@link IPCB_PrimitivePadHeatWelding.connectionMethod | connectionMethod})为直连({@link EPCB_PrimitivePadHeatWeldingConnectionMethod.DIRECT_CONNECTED | DIRECT_CONNECTED})、无连接({@link EPCB_PrimitivePadHeatWeldingConnectionMethod.NON_CONNECTED | NON_CONNECTED})时,发散间距、发散线宽、发散角度的设置将被忽略
3180
- */
3181
- declare interface IPCB_PrimitivePadHeatWelding {
3182
- /** 连接方式 */
3183
- connectionMethod: EPCB_PrimitivePadHeatWeldingConnectionMethod;
3184
- /** 发散间距 */
3185
- divergenceSpacing?: number;
3186
- /** 发散线宽 */
3187
- divergenceLineWidth?: number;
3188
- /** 发散角度 */
3189
- divergenceAngle?: number;
4272
+ /* Excluded from this release type: reset */
4273
+ /* Excluded from this release type: done */
4274
+ /* Excluded from this release type: convertToFill */
4275
+ /* Excluded from this release type: convertToPolyline */
4276
+ /* Excluded from this release type: convertToRegion */
3190
4277
  }
3191
4278
 
3192
4279
  /**
3193
- * 折线图元
4280
+ * 区域图元
3194
4281
  *
3195
4282
  * @public
3196
4283
  */
3197
- declare class IPCB_PrimitivePolyline implements IPCB_Primitive {
4284
+ declare class IPCB_PrimitiveRegion implements IPCB_Primitive {
3198
4285
  /** 异步 */
3199
4286
  private async;
3200
4287
  /** 图元类型 */
3201
4288
  private readonly primitiveType;
3202
4289
  /** 图元 ID */
3203
4290
  private primitiveId?;
3204
- /** 网络名称 */
3205
- private net;
3206
4291
  /** 层 */
3207
4292
  private layer;
3208
- /** 单多边形 */
3209
- private polygon;
4293
+ /** 复杂多边形 */
4294
+ private complexPolygon;
4295
+ /** 区域规则类型 */
4296
+ private ruleType;
4297
+ /** 区域名称 */
4298
+ private regionName?;
3210
4299
  /** 线宽 */
3211
- private lineWidth;
4300
+ private lineWidth?;
3212
4301
  /** 是否锁定 */
3213
4302
  private primitiveLock;
3214
4303
  /* Excluded from this release type: __constructor */
4304
+ /* Excluded from this release type: create */
3215
4305
  /**
3216
- * 在 PCB 画布中创建图元
4306
+ * 获取属性状态:图元类型
3217
4307
  *
3218
- * @beta
3219
- * @returns 折线图元对象
4308
+ * @public
4309
+ * @returns 图元类型
3220
4310
  */
3221
- create(): Promise<IPCB_PrimitivePolyline>;
4311
+ getState_PrimitiveType(): EPCB_PrimitiveType;
3222
4312
  /**
3223
- * 获取对象的图元 ID
4313
+ * 获取属性状态:图元 ID
3224
4314
  *
3225
- * @returns
4315
+ * @public
4316
+ * @returns 图元 ID
3226
4317
  */
3227
4318
  getState_PrimitiveId(): string;
3228
- /* Excluded from this release type: setState_Net */
3229
- /* Excluded from this release type: setState_Layer */
3230
- /* Excluded from this release type: setState_Polygon */
3231
- /* Excluded from this release type: setState_LineWidth */
3232
- /* Excluded from this release type: setState_PrimitiveLock */
3233
4319
  /**
3234
- * 将图元转换为异步图元
4320
+ * 获取属性状态:层
4321
+ *
4322
+ * @public
4323
+ * @returns 层
3235
4324
  */
3236
- toAsync(): IPCB_PrimitivePolyline;
4325
+ getState_Layer(): TPCB_LayersOfRegion;
3237
4326
  /**
3238
- * 将图元转换为同步图元
4327
+ * 获取属性状态:复杂多边形
4328
+ *
4329
+ * @public
4330
+ * @returns 复杂多边形
3239
4331
  */
3240
- toSync(): IPCB_PrimitivePolyline;
4332
+ getState_ComplexPolygon(): IPCB_ComplexPolygon;
3241
4333
  /**
3242
- * 查询图元是否为异步图元
4334
+ * 获取属性状态:区域规则类型
4335
+ *
4336
+ * @public
4337
+ * @returns 区域规则类型
3243
4338
  */
3244
- isAsync(): boolean;
4339
+ getState_RuleType(): Array<EPCB_PrimitiveRegionRuleType>;
3245
4340
  /**
3246
- * 将异步图元重置为当前画布状态
4341
+ * 获取属性状态:区域名称
4342
+ *
4343
+ * @public
4344
+ * @returns 区域名称
4345
+ */
4346
+ getState_RegionName(): string | undefined;
4347
+ /**
4348
+ * 获取属性状态:线宽
4349
+ *
4350
+ * @public
4351
+ * @returns 线宽
4352
+ */
4353
+ getState_LineWidth(): number;
4354
+ /**
4355
+ * 获取属性状态:是否锁定
4356
+ *
4357
+ * @public
4358
+ * @returns 是否锁定
4359
+ */
4360
+ getState_PrimitiveLock(): boolean;
4361
+ /**
4362
+ * 设置属性状态:层
3247
4363
  *
3248
4364
  * @beta
4365
+ * @param layer - 层
4366
+ * @returns 区域图元对象
3249
4367
  */
3250
- reset(): Promise<IPCB_PrimitivePolyline>;
4368
+ setState_Layer(layer: TPCB_LayersOfRegion): IPCB_PrimitiveRegion;
3251
4369
  /**
3252
- * 将对图元的更改应用到画布
4370
+ * 设置属性状态:复杂多边形
3253
4371
  *
3254
4372
  * @beta
4373
+ * @param complexPolygon - 复杂多边形
4374
+ * @returns 区域图元对象
3255
4375
  */
3256
- done(): Promise<IPCB_PrimitivePolyline>;
4376
+ setState_ComplexPolygon(complexPolygon: IPCB_ComplexPolygon): IPCB_PrimitiveRegion;
4377
+ /**
4378
+ * 设置属性状态:区域规则类型
4379
+ *
4380
+ * @beta
4381
+ * @param ruleType - 区域规则类型
4382
+ * @returns 区域图元对象
4383
+ */
4384
+ setState_RuleType(ruleType: Array<EPCB_PrimitiveRegionRuleType>): IPCB_PrimitiveRegion;
4385
+ /**
4386
+ * 设置属性状态:区域名称
4387
+ *
4388
+ * @beta
4389
+ * @remarks
4390
+ * 仅当 `ruleType` 为 {@link EPCB_PrimitiveRegionRuleType.FOLLOW_REGION_RULE} 时有效,用于匹配区域 DRC 规则
4391
+ *
4392
+ * 如若 `ruleType` 为 {@link EPCB_PrimitiveRegionRuleType.FOLLOW_REGION_RULE} 但 `regionName` 为空,则系统将会自动分配名称
4393
+ * @param regionName - 区域名称
4394
+ * @returns 区域图元对象
4395
+ */
4396
+ setState_RegionName(regionName?: string): IPCB_PrimitiveRegion;
4397
+ /**
4398
+ * 设置属性状态:线宽
4399
+ *
4400
+ * @beta
4401
+ * @param lineWidth - 线宽
4402
+ * @returns 区域图元对象
4403
+ */
4404
+ setState_LineWidth(lineWidth: number): IPCB_PrimitiveRegion;
4405
+ /**
4406
+ * 设置属性状态:是否锁定
4407
+ *
4408
+ * @beta
4409
+ * @param primitiveLock - 是否锁定
4410
+ * @returns 区域图元对象
4411
+ */
4412
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveRegion;
4413
+ /**
4414
+ * 将图元转换为异步图元
4415
+ *
4416
+ * @public
4417
+ * @returns 区域图元对象
4418
+ */
4419
+ toAsync(): IPCB_PrimitiveRegion;
4420
+ /**
4421
+ * 将图元转换为同步图元
4422
+ *
4423
+ * @public
4424
+ * @returns 区域图元对象
4425
+ */
4426
+ toSync(): IPCB_PrimitiveRegion;
4427
+ /**
4428
+ * 查询图元是否为异步图元
4429
+ *
4430
+ * @public
4431
+ * @returns 是否为异步图元
4432
+ */
4433
+ isAsync(): boolean;
4434
+ /* Excluded from this release type: reset */
4435
+ /* Excluded from this release type: done */
4436
+ /* Excluded from this release type: convertToFill */
4437
+ /* Excluded from this release type: convertToPolyline */
4438
+ /* Excluded from this release type: convertToPour */
3257
4439
  }
3258
4440
 
3259
4441
  /**
@@ -3313,50 +4495,189 @@ declare class IPCB_PrimitiveVia implements IPCB_Primitive {
3313
4495
  /** 是否锁定 */
3314
4496
  private primitiveLock;
3315
4497
  /* Excluded from this release type: __constructor */
4498
+ /* Excluded from this release type: create */
4499
+ /**
4500
+ * 获取属性状态:图元类型
4501
+ *
4502
+ * @public
4503
+ * @returns 图元类型
4504
+ */
4505
+ getState_PrimitiveType(): EPCB_PrimitiveType;
4506
+ /**
4507
+ * 获取属性状态:图元 ID
4508
+ *
4509
+ * @public
4510
+ * @returns 图元 ID
4511
+ */
4512
+ getState_PrimitiveId(): string;
4513
+ /**
4514
+ * 获取属性状态:网络名称
4515
+ *
4516
+ * @public
4517
+ * @returns 网络名称
4518
+ */
4519
+ getState_Net(): string;
4520
+ /**
4521
+ * 获取属性状态:坐标 X
4522
+ *
4523
+ * @public
4524
+ * @returns 坐标 X
4525
+ */
4526
+ getState_X(): number;
4527
+ /**
4528
+ * 获取属性状态:坐标 Y
4529
+ *
4530
+ * @public
4531
+ * @returns 坐标 Y
4532
+ */
4533
+ getState_Y(): number;
4534
+ /**
4535
+ * 获取属性状态:孔径
4536
+ *
4537
+ * @public
4538
+ * @returns 孔径
4539
+ */
4540
+ getState_HoleDiameter(): number;
4541
+ /**
4542
+ * 获取属性状态:外径
4543
+ *
4544
+ * @public
4545
+ * @returns 外径
4546
+ */
4547
+ getState_Diameter(): number;
4548
+ /**
4549
+ * 获取属性状态:过孔类型
4550
+ *
4551
+ * @public
4552
+ * @returns 过孔类型
4553
+ */
4554
+ getState_ViaType(): EPCB_PrimitiveViaType;
4555
+ /**
4556
+ * 获取属性状态:盲埋孔设计规则项名称
4557
+ *
4558
+ * @public
4559
+ * @returns 盲埋孔设计规则项名称
4560
+ */
4561
+ getState_DesignRuleBlindViaName(): string | null;
4562
+ /**
4563
+ * 获取属性状态:阻焊/助焊扩展
4564
+ *
4565
+ * @public
4566
+ * @returns 阻焊/助焊扩展
4567
+ */
4568
+ getState_SolderMaskExpansion(): IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null;
4569
+ /**
4570
+ * 获取属性状态:是否锁定
4571
+ *
4572
+ * @public
4573
+ * @returns 是否锁定
4574
+ */
4575
+ getState_PrimitiveLock(): boolean;
4576
+ /**
4577
+ * 设置属性状态:网络名称
4578
+ *
4579
+ * @beta
4580
+ * @param net - 网络名称
4581
+ * @returns 过孔图元对象
4582
+ */
4583
+ setState_Net(net: string): IPCB_PrimitiveVia;
4584
+ /**
4585
+ * 设置属性状态:坐标 X
4586
+ *
4587
+ * @beta
4588
+ * @param x - 坐标 X
4589
+ * @returns 过孔图元对象
4590
+ */
4591
+ setState_X(x: number): IPCB_PrimitiveVia;
4592
+ /**
4593
+ * 设置属性状态:坐标 Y
4594
+ *
4595
+ * @beta
4596
+ * @param y - 坐标 Y
4597
+ * @returns 过孔图元对象
4598
+ */
4599
+ setState_Y(y: number): IPCB_PrimitiveVia;
3316
4600
  /**
3317
- * 在 PCB 画布中创建图元
4601
+ * 设置属性状态:孔径
3318
4602
  *
3319
4603
  * @beta
4604
+ * @param holeDiameter - 孔径
3320
4605
  * @returns 过孔图元对象
3321
4606
  */
3322
- create(): Promise<IPCB_PrimitiveVia>;
4607
+ setState_HoleDiameter(holeDiameter: number): IPCB_PrimitiveVia;
3323
4608
  /**
3324
- * 获取对象的图元 ID
4609
+ * 设置属性状态:外径
3325
4610
  *
3326
- * @returns
4611
+ * @beta
4612
+ * @param diameter - 外径
4613
+ * @returns 过孔图元对象
3327
4614
  */
3328
- getState_PrimitiveId(): string;
3329
- /* Excluded from this release type: setState_Net */
3330
- /* Excluded from this release type: setState_X */
3331
- /* Excluded from this release type: setState_Y */
3332
- /* Excluded from this release type: setState_HoleDiameter */
3333
- /* Excluded from this release type: setState_Diameter */
3334
- /* Excluded from this release type: setState_ViaType */
3335
- /* Excluded from this release type: setState_DesignRuleBlindViaName */
3336
- /* Excluded from this release type: setState_SolderMaskExpansion */
3337
- /* Excluded from this release type: setState_PrimitiveLock */
4615
+ setState_Diameter(diameter: number): IPCB_PrimitiveVia;
4616
+ /**
4617
+ * 设置属性状态:过孔类型
4618
+ *
4619
+ * @beta
4620
+ * @param viaType - 过孔类型
4621
+ * @returns 过孔图元对象
4622
+ */
4623
+ setState_ViaType(viaType: EPCB_PrimitiveViaType): IPCB_PrimitiveVia;
4624
+ /**
4625
+ * 设置属性状态:盲埋孔设计规则项名称
4626
+ *
4627
+ * @beta
4628
+ * @param designRuleBlindViaName - 盲埋孔设计规则项名称
4629
+ * @returns 过孔图元对象
4630
+ */
4631
+ setState_DesignRuleBlindViaName(designRuleBlindViaName: string | null): IPCB_PrimitiveVia;
4632
+ /**
4633
+ * 设置属性状态:阻焊/助焊扩展
4634
+ *
4635
+ * @beta
4636
+ * @param solderMaskExpansion - 阻焊/助焊扩展
4637
+ * @returns 过孔图元对象
4638
+ */
4639
+ setState_SolderMaskExpansion(solderMaskExpansion: IPCB_PrimitiveSolderMaskAndPasteMaskExpansion | null): IPCB_PrimitiveVia;
4640
+ /**
4641
+ * 设置属性状态:是否锁定
4642
+ *
4643
+ * @beta
4644
+ * @param primitiveLock - 是否锁定
4645
+ * @returns 过孔图元对象
4646
+ */
4647
+ setState_PrimitiveLock(primitiveLock: boolean): IPCB_PrimitiveVia;
3338
4648
  /**
3339
4649
  * 将图元转换为异步图元
4650
+ *
4651
+ * @public
4652
+ * @returns 过孔图元对象
3340
4653
  */
3341
4654
  toAsync(): IPCB_PrimitiveVia;
3342
4655
  /**
3343
4656
  * 将图元转换为同步图元
4657
+ *
4658
+ * @public
4659
+ * @returns 过孔图元对象
3344
4660
  */
3345
4661
  toSync(): IPCB_PrimitiveVia;
3346
4662
  /**
3347
4663
  * 查询图元是否为异步图元
4664
+ *
4665
+ * @public
4666
+ * @returns 是否为异步图元
3348
4667
  */
3349
4668
  isAsync(): boolean;
3350
4669
  /**
3351
4670
  * 将异步图元重置为当前画布状态
3352
4671
  *
3353
4672
  * @beta
4673
+ * @returns 过孔图元对象
3354
4674
  */
3355
4675
  reset(): Promise<IPCB_PrimitiveVia>;
3356
4676
  /**
3357
4677
  * 将对图元的更改应用到画布
3358
4678
  *
3359
4679
  * @beta
4680
+ * @returns 过孔图元对象
3360
4681
  */
3361
4682
  done(): Promise<IPCB_PrimitiveVia>;
3362
4683
  }
@@ -4368,7 +5689,7 @@ declare class LIB_Cbb {
4368
5689
  * 复制复用模块
4369
5690
  *
4370
5691
  * @beta
4371
- * @param cbbUuid - 复用模块 UUID
5692
+ * @param cbbUuid - 复用模��� UUID
4372
5693
  * @param libraryUuid - 库 UUID,可以使用 {@link LIB_LibrariesList} 内的接口获取
4373
5694
  * @param targetLibraryUuid - 目标库 UUID
4374
5695
  * @param targetClassification - 目标库内的分类
@@ -5619,7 +6940,7 @@ declare class PCB_ManufactureData {
5619
6940
  *
5620
6941
  * @beta
5621
6942
  * @remarks
5622
- * 请注意:只有以 STEP 格式导入的元件模型,才能在导出的 STEP 文件中体现
6943
+ * 请注意:只有以 STEP 格式导入的元件模型,才能在导出的 STEP 文件���体现
5623
6944
  *
5624
6945
  * 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
5625
6946
  * @param fileName - 文件名
@@ -5683,7 +7004,7 @@ declare class PCB_ManufactureData {
5683
7004
  */
5684
7005
  getNetlistFile(fileName?: string, netlistType?: ENetlistType): Promise<File | undefined>;
5685
7006
  /**
5686
- * 获取 DXF ���件
7007
+ * 获取 DXF 文件
5687
7008
  *
5688
7009
  * @beta
5689
7010
  * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
@@ -5912,16 +7233,7 @@ declare class PCB_PrimitiveArc implements IPCB_PrimitiveAPI {
5912
7233
  *
5913
7234
  * @beta
5914
7235
  * @param primitiveId - 图元 ID
5915
- * @param net - 网络名称
5916
- * @param layer - 层
5917
- * @param startX - 起始位置 X
5918
- * @param startY - 起始位置 Y
5919
- * @param endX - 终止位置 X
5920
- * @param endY - 终止位置 Y
5921
- * @param arcAngle - 圆弧角度
5922
- * @param lineWidth - 线宽
5923
- * @param interactiveMode - 交互模式
5924
- * @param primitiveLock - 是否锁定
7236
+ * @param property - 修改参数
5925
7237
  * @returns 圆弧线图元对象
5926
7238
  */
5927
7239
  modify(primitiveId: string | IPCB_PrimitiveArc, property: {
@@ -5941,9 +7253,17 @@ declare class PCB_PrimitiveArc implements IPCB_PrimitiveAPI {
5941
7253
  *
5942
7254
  * @beta
5943
7255
  * @param primitiveIds - 圆弧线的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
5944
- * @returns 圆弧线图元对象
7256
+ * @returns 圆弧线图元对象,`undefined` 表示获取失败
5945
7257
  */
5946
7258
  get(primitiveIds: string): Promise<IPCB_PrimitiveArc | undefined>;
7259
+ /**
7260
+ * 获取圆弧线
7261
+ *
7262
+ * @beta
7263
+ * @remarks 如若传入多个图元 ID,任意图元 ID 未匹配到不影响其它图元的返回,即可能返回少于传入的图元 ID 数量的图元对象
7264
+ * @param primitiveIds - 圆弧线的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
7265
+ * @returns 圆弧线图元对象,空数组表示获取失败
7266
+ */
5947
7267
  get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveArc>>;
5948
7268
  /**
5949
7269
  * 获取所有圆弧线的图元 ID
@@ -6100,13 +7420,7 @@ declare class PCB_PrimitiveDimension implements IPCB_PrimitiveAPI {
6100
7420
  *
6101
7421
  * @beta
6102
7422
  * @param primitiveId - 图元 ID
6103
- * @param dimensionType - 尺寸标注类型
6104
- * @param coordinateSet - 尺寸标注坐标集
6105
- * @param layer - 层
6106
- * @param unit - 单位
6107
- * @param lineWidth - 线宽
6108
- * @param precision - 精度,取值范围 `0`-`4`
6109
- * @param primitiveLock - 是否锁定
7423
+ * @param property - 修改参数
6110
7424
  * @returns 尺寸标注图元对象
6111
7425
  */
6112
7426
  modify(primitiveId: string | IPCB_PrimitiveDimension, property: {
@@ -6123,9 +7437,17 @@ declare class PCB_PrimitiveDimension implements IPCB_PrimitiveAPI {
6123
7437
  *
6124
7438
  * @beta
6125
7439
  * @param primitiveIds - 尺寸标注的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
6126
- * @returns 尺寸标注图元对象
7440
+ * @returns 尺寸标注图元对象,`undefined` 表示获取失败
6127
7441
  */
6128
7442
  get(primitiveIds: string): Promise<IPCB_PrimitiveDimension | undefined>;
7443
+ /**
7444
+ * 获取尺寸标注
7445
+ *
7446
+ * @beta
7447
+ * @remarks 如若传入多个图元 ID,任意图元 ID 未匹配到不影响其它图元的返回,即可能返回少于传入的图元 ID 数量的图元对象
7448
+ * @param primitiveIds - 尺寸标注的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
7449
+ * @returns 尺寸标注图元对象,空数组表示获取失败
7450
+ */
6129
7451
  get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveDimension>>;
6130
7452
  /**
6131
7453
  * 获取所有尺寸标注的图元 ID
@@ -6147,6 +7469,21 @@ declare class PCB_PrimitiveDimension implements IPCB_PrimitiveAPI {
6147
7469
  getAll(layer?: TPCB_LayersOfDimension, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveDimension>>;
6148
7470
  }
6149
7471
 
7472
+ /**
7473
+ * PCB & 封装 / 填充图元类
7474
+ *
7475
+ * @public
7476
+ */
7477
+ declare class PCB_PrimitiveFill implements IPCB_PrimitiveAPI {
7478
+ /* Excluded from this release type: create */
7479
+ /* Excluded from this release type: delete */
7480
+ /* Excluded from this release type: modify */
7481
+ /* Excluded from this release type: get */
7482
+ /* Excluded from this release type: get */
7483
+ /* Excluded from this release type: getAllPrimitiveId */
7484
+ /* Excluded from this release type: getAll */
7485
+ }
7486
+
6150
7487
  /**
6151
7488
  * PCB & 封装 / 图像图元类
6152
7489
  *
@@ -6182,14 +7519,7 @@ declare class PCB_PrimitiveImage implements IPCB_PrimitiveAPI {
6182
7519
  *
6183
7520
  * @beta
6184
7521
  * @param primitiveId - 图元 ID
6185
- * @param x - BBox 左上点坐标 X
6186
- * @param y - BBox 左上点坐标 Y
6187
- * @param layer - 层
6188
- * @param width - 宽
6189
- * @param height - 高
6190
- * @param rotation - 旋转角度
6191
- * @param horizonMirror - 是否水平镜像
6192
- * @param primitiveLock - 是否锁定
7522
+ * @param property - 修改参数
6193
7523
  * @returns 图像图元对象
6194
7524
  */
6195
7525
  modify(primitiveId: string | IPCB_PrimitiveImage, property: {
@@ -6207,9 +7537,17 @@ declare class PCB_PrimitiveImage implements IPCB_PrimitiveAPI {
6207
7537
  *
6208
7538
  * @beta
6209
7539
  * @param primitiveIds - 图像的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
6210
- * @returns 图像图元对象
7540
+ * @returns 图像图元对象,`undefined` 表示获取失败
6211
7541
  */
6212
7542
  get(primitiveIds: string): Promise<IPCB_PrimitiveImage | undefined>;
7543
+ /**
7544
+ * 获取图像
7545
+ *
7546
+ * @beta
7547
+ * @remarks 如若传入多个图元 ID,任意图元 ID 未匹配到不影响其它图元的返回,即可能返回少于传入的图元 ID 数量的图元对象
7548
+ * @param primitiveIds - 图像的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
7549
+ * @returns 图像图元对象,空数组表示获取失败
7550
+ */
6213
7551
  get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveImage>>;
6214
7552
  /**
6215
7553
  * 获取所有图像的图元 ID
@@ -6240,7 +7578,7 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
6240
7578
  /**
6241
7579
  * 创建导线
6242
7580
  *
6243
- * @beta
7581
+ * @public
6244
7582
  * @param net - 网络名称
6245
7583
  * @param layer - 层
6246
7584
  * @param startX - 起始位置 X
@@ -6265,14 +7603,7 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
6265
7603
  *
6266
7604
  * @beta
6267
7605
  * @param primitiveId - 图元 ID
6268
- * @param net - 网络名称
6269
- * @param layer - 层
6270
- * @param startX - 起始位置 X
6271
- * @param startY - 起始位置 Y
6272
- * @param endX - 终止位置 X
6273
- * @param endY - 终止位置 Y
6274
- * @param lineWidth - 线宽
6275
- * @param primitiveLock - 是否锁定
7606
+ * @param property - 修改参数
6276
7607
  * @returns 导线图元对象
6277
7608
  */
6278
7609
  modify(primitiveId: string | IPCB_PrimitiveLine, property: {
@@ -6290,9 +7621,17 @@ declare class PCB_PrimitiveLine implements IPCB_PrimitiveAPI {
6290
7621
  *
6291
7622
  * @beta
6292
7623
  * @param primitiveIds - 导线的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
6293
- * @returns 导线图元对象
7624
+ * @returns 导线图元对象,`undefined` 表示获取失败
6294
7625
  */
6295
7626
  get(primitiveIds: string): Promise<IPCB_PrimitiveLine | undefined>;
7627
+ /**
7628
+ * 获取导线
7629
+ *
7630
+ * @beta
7631
+ * @remarks 如若传入多个图元 ID,任意图元 ID 未匹配到不影响其它图元的返回,即可能返回少于传入的图元 ID 数量的图元对象
7632
+ * @param primitiveIds - 导线的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
7633
+ * @returns 导线图元对象,空数组表示获取失败
7634
+ */
6296
7635
  get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveLine>>;
6297
7636
  /**
6298
7637
  * 获取所有导线的图元 ID
@@ -6359,23 +7698,7 @@ declare class PCB_PrimitivePad implements IPCB_PrimitiveAPI {
6359
7698
  *
6360
7699
  * @beta
6361
7700
  * @param primitiveId - 图元 ID
6362
- * @param layer -
6363
- * @param padNumber - 焊盘编号
6364
- * @param x - 位置 X
6365
- * @param y - 位置 Y
6366
- * @param rotation - 旋转角度
6367
- * @param pad - 焊盘外形
6368
- * @param net - 网络名称
6369
- * @param hole - 孔,`null` 标识无孔
6370
- * @param holeOffsetX - 孔偏移 X
6371
- * @param holeOffsetY - 孔偏移 Y
6372
- * @param holeRotation - 孔相对于焊盘的旋转角度
6373
- * @param metallization - 是否金属化孔壁
6374
- * @param padFunction - 焊盘功能
6375
- * @param specialPad - 特殊焊盘外形
6376
- * @param solderMaskAndPasteMaskExpansion - 阻焊/助焊扩展,`null` 表示遵循规则
6377
- * @param heatWelding - 热焊优化参数
6378
- * @param primitiveLock - 是否锁定
7701
+ * @param property - 修改参数
6379
7702
  * @returns 焊盘图元对象
6380
7703
  */
6381
7704
  modify(primitiveId: string | IPCB_PrimitivePad, property: {
@@ -6402,9 +7725,17 @@ declare class PCB_PrimitivePad implements IPCB_PrimitiveAPI {
6402
7725
  *
6403
7726
  * @beta
6404
7727
  * @param primitiveIds - 焊盘的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
6405
- * @returns 焊盘图元对象
7728
+ * @returns 焊盘图元对象,`undefined` 表示获取失败
6406
7729
  */
6407
7730
  get(primitiveIds: string): Promise<IPCB_PrimitivePad | undefined>;
7731
+ /**
7732
+ * 获取焊盘
7733
+ *
7734
+ * @beta
7735
+ * @remarks 如若传入多个图元 ID,任意图元 ID 未匹配到不影响其它图元的返回,即可能返回少于传入的图元 ID 数量的图元对象
7736
+ * @param primitiveIds - 焊盘的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
7737
+ * @returns 焊盘图元对象,空数组表示获取失败
7738
+ */
6408
7739
  get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitivePad>>;
6409
7740
  /**
6410
7741
  * 获取所有焊盘的图元 ID
@@ -6437,7 +7768,7 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
6437
7768
  /**
6438
7769
  * 创建折线
6439
7770
  *
6440
- * @beta
7771
+ * @public
6441
7772
  * @param net - 网络名称
6442
7773
  * @param layer - 层
6443
7774
  * @param polygon - 单多边形对象
@@ -6459,11 +7790,7 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
6459
7790
  *
6460
7791
  * @beta
6461
7792
  * @param primitiveId - 图元 ID
6462
- * @param net - 网络名称
6463
- * @param layer - 层
6464
- * @param polygon - 单多边形对象
6465
- * @param lineWidth - 线宽
6466
- * @param primitiveLock - 是否锁定
7793
+ * @param property - 修改参数
6467
7794
  * @returns 折线图元对象
6468
7795
  */
6469
7796
  modify(primitiveId: string | IPCB_PrimitivePolyline, property: {
@@ -6478,9 +7805,17 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
6478
7805
  *
6479
7806
  * @beta
6480
7807
  * @param primitiveIds - 折线的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
6481
- * @returns 折线图元对象
7808
+ * @returns 折线图元对象,`undefined` 表示获取失败
6482
7809
  */
6483
7810
  get(primitiveIds: string): Promise<IPCB_PrimitivePolyline | undefined>;
7811
+ /**
7812
+ * 获取折线
7813
+ *
7814
+ * @beta
7815
+ * @remarks 如若传入多个图元 ID,任意图元 ID 未匹配到不影响其它图元的返回,即可能返回少于传入的图元 ID 数量的图元对象
7816
+ * @param primitiveIds - 折线的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
7817
+ * @returns 折线图元对象,空数组表示获取失败
7818
+ */
6484
7819
  get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitivePolyline>>;
6485
7820
  /**
6486
7821
  * 获取所有折线的图元 ID
@@ -6504,6 +7839,36 @@ declare class PCB_PrimitivePolyline implements IPCB_PrimitiveAPI {
6504
7839
  getAll(net?: string, layer?: TPCB_LayersOfLine, primitiveLock?: boolean): Promise<Array<IPCB_PrimitivePolyline>>;
6505
7840
  }
6506
7841
 
7842
+ /**
7843
+ * PCB & 封装 / 覆铜边框图元类
7844
+ *
7845
+ * @public
7846
+ */
7847
+ declare class PCB_PrimitivePour implements IPCB_PrimitiveAPI {
7848
+ /* Excluded from this release type: create */
7849
+ /* Excluded from this release type: delete */
7850
+ /* Excluded from this release type: modify */
7851
+ /* Excluded from this release type: get */
7852
+ /* Excluded from this release type: get */
7853
+ /* Excluded from this release type: getAllPrimitiveId */
7854
+ /* Excluded from this release type: getAll */
7855
+ }
7856
+
7857
+ /**
7858
+ * PCB & 封装 / 区域图元类
7859
+ *
7860
+ * @public
7861
+ */
7862
+ declare class PCB_PrimitiveRegion implements IPCB_PrimitiveAPI {
7863
+ /* Excluded from this release type: create */
7864
+ /* Excluded from this release type: delete */
7865
+ /* Excluded from this release type: modify */
7866
+ /* Excluded from this release type: get */
7867
+ /* Excluded from this release type: get */
7868
+ /* Excluded from this release type: getAllPrimitiveId */
7869
+ /* Excluded from this release type: getAll */
7870
+ }
7871
+
6507
7872
  /**
6508
7873
  * PCB & 封装 / 过孔图元类
6509
7874
  *
@@ -6513,13 +7878,13 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
6513
7878
  /**
6514
7879
  * 创建过孔
6515
7880
  *
6516
- * @beta
7881
+ * @public
6517
7882
  * @param net - 网络名称
6518
7883
  * @param x - 坐标 X
6519
7884
  * @param y - 坐标 Y
6520
7885
  * @param holeDiameter - 孔径
6521
7886
  * @param diameter - 外径
6522
- * @param viaType - 过孔类型,`0` 普通过孔,`1` 缝合孔
7887
+ * @param viaType - 过孔类型
6523
7888
  * @param designRuleBlindViaName - 盲埋孔设计规则项名称,定义过孔的开始层与结束层,`null` 表示非盲埋孔
6524
7889
  * @param solderMaskExpansion - 阻焊/助焊扩展,`null` 表示跟随规则
6525
7890
  * @param primitiveLock - 是否锁定
@@ -6539,15 +7904,7 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
6539
7904
  *
6540
7905
  * @beta
6541
7906
  * @param primitiveId - 图元 ID
6542
- * @param net - 网络名称
6543
- * @param x - 坐标 X
6544
- * @param y - 坐标 Y
6545
- * @param holeDiameter - 孔径
6546
- * @param diameter - 外径
6547
- * @param viaType - 过孔类型,`0` 普通过孔,`1` 缝合孔
6548
- * @param designRuleBlindViaName - 盲埋孔设计规则项名称,定义过孔的开始层与结束层,`null` 表示非盲埋孔
6549
- * @param solderMaskExpansion - 阻焊/助焊扩展,`null` 表示跟随规则
6550
- * @param primitiveLock - 是否锁定
7907
+ * @param property - 修改参数
6551
7908
  * @returns 过孔图元对象
6552
7909
  */
6553
7910
  modify(primitiveId: string | IPCB_PrimitiveVia, property: {
@@ -6566,15 +7923,25 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
6566
7923
  *
6567
7924
  * @beta
6568
7925
  * @param primitiveIds - 过孔的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
6569
- * @returns 过孔图元对象
7926
+ * @returns 过孔图元对象,`undefined` 表示获取失败
6570
7927
  */
6571
7928
  get(primitiveIds: string): Promise<IPCB_PrimitiveVia | undefined>;
7929
+ /**
7930
+ * 获取过孔
7931
+ *
7932
+ * @beta
7933
+ * @remarks 如若传入多个图元 ID,任意图元 ID 未匹配到不影响其它图元的返回,即可能返回少于传入的图元 ID 数量的图元对象
7934
+ * @param primitiveIds - 过孔的图元 ID,可以为字符串或字符串数组,如若为数组,则返回的也是数组
7935
+ * @returns 过孔图元对象,空数组表示获取失败
7936
+ */
6572
7937
  get(primitiveIds: Array<string>): Promise<Array<IPCB_PrimitiveVia>>;
6573
7938
  /**
6574
7939
  * 获取所有过孔图元 ID
6575
7940
  *
6576
7941
  * @beta
6577
- * @returns
7942
+ * @param net - 网络名称
7943
+ * @param primitiveLock - 是否锁定
7944
+ * @returns 过孔的图元 ID 数组
6578
7945
  */
6579
7946
  getAllPrimitiveId(net?: string, primitiveLock?: boolean): Promise<Array<string>>;
6580
7947
  /**
@@ -6582,7 +7949,7 @@ declare class PCB_PrimitiveVia implements IPCB_PrimitiveAPI {
6582
7949
  *
6583
7950
  * @beta
6584
7951
  * @param net - 网络名称
6585
- * @param primitiveLock - 锁定
7952
+ * @param primitiveLock - 是否锁定
6586
7953
  * @returns 过孔图元对象数组
6587
7954
  */
6588
7955
  getAll(net?: string, primitiveLock?: boolean): Promise<Array<IPCB_PrimitiveVia>>;
@@ -6749,7 +8116,7 @@ declare class SCH_Event {
6749
8116
  * 原理图 & 符号 / 生产资料类
6750
8117
  *
6751
8118
  * @public
6752
- * @remarks 获取当前原理图图页的生产资料文件及快捷下单
8119
+ * @remarks 获取当前原理图图页的生产资料文件及快��下单
6753
8120
  */
6754
8121
  declare class SCH_ManufactureData {
6755
8122
  /**
@@ -7316,7 +8683,7 @@ declare class SCH_PrimitivePin implements ISCH_PrimitiveAPI {
7316
8683
  *
7317
8684
  * @beta
7318
8685
  * @remarks 当处于符号编辑器时,componentPrimitiveId 应始终为 undefined
7319
- * @returns 引脚的图元 ID 数组
8686
+ * @returns 引脚���图元 ID 数组
7320
8687
  */
7321
8688
  getAllPrimitiveId(componentPrimitiveId?: string | ISCH_PrimitiveComponent): Promise<Array<string>>;
7322
8689
  /**
@@ -7410,7 +8777,7 @@ declare class SCH_PrimitiveRectangle implements ISCH_PrimitiveAPI {
7410
8777
  * @param cornerRadius - 圆角半径
7411
8778
  * @param rotation - 旋转角度,绕左上点旋转,可选 `0` `90` `180` `270`
7412
8779
  * @param color - 颜色,`null` 表示默认
7413
- * @param fillColor - 填充颜色,`none` 表示无填充,`null` 表示默认
8780
+ * @param fillColor - 填充颜色,`none` 表示无填充,`null` 表示���认
7414
8781
  * @param lineWidth - 线宽,范围 `1-10`,`null` 表示默认
7415
8782
  * @param lineType - 线型,`0` 实线,`1` 短划线,`2` 点线,`3` 点划线,`null` 表示默认
7416
8783
  * @returns 矩形图元对象
@@ -7691,7 +9058,7 @@ declare class SYS_ClientUrl {
7691
9058
  *
7692
9059
  * @public
7693
9060
  * @remarks
7694
- * 请注意,需要在被请求的站点上允许跨源资源共享(CORS),否则接口将始终返回错误结果。
9061
+ * 请注意,需要在被请求的站点上允许跨源资源共享(CORS),否��接口将始终返回错误结果。
7695
9062
  *
7696
9063
  * 更多信息,请查阅 {@link https://developer.mozilla.org/docs/Web/HTTP/CORS | 跨源资源共享 (CORS) - MDN}。
7697
9064
  *
@@ -7848,16 +9215,7 @@ declare class SYS_FileManager {
7848
9215
  * @returns 器件文件数据,`undefined` 表示数据获取失败
7849
9216
  */
7850
9217
  getDeviceFileByDeviceUuid(deviceUuid: string | Array<string>, libraryUuid?: string): Promise<File | undefined>;
7851
- /**
7852
- * 使用符号 UUID 获取符号文件
7853
- *
7854
- * @beta
7855
- * @remarks 可以使用 {@link SYS_FileSystem.saveFile} 接口将文件导出到本地文件系统
7856
- * @param symbolUuid - 符号 UUID 或符号 UUID 列表
7857
- * @param libraryUuid - 库 UUID,可以使用 {@link LIB_LibrariesList} 内的接口获取
7858
- * @returns 符号文件数据,`undefined` 表示数据获取失败
7859
- */
7860
- getSymbolFileBySymbolUuid(symbolUuid: string | Array<string>, libraryUuid?: string): Promise<File | undefined>;
9218
+ /* Excluded from this release type: getSymbolFileBySymbolUuid */
7861
9219
  /**
7862
9220
  * 使用封装 UUID 获取封装文件
7863
9221
  *
@@ -7981,6 +9339,7 @@ declare class SYS_I18n {
7981
9339
  * 刷新当前语言环境
7982
9340
  *
7983
9341
  * @public
9342
+ * @remarks 使扩展内部语言环境与 EDA 当前语言环境同步
7984
9343
  */
7985
9344
  flushCurrentLanguage(): Promise<void>;
7986
9345
  /**
@@ -8002,8 +9361,10 @@ declare class SYS_I18n {
8002
9361
  * 导入多语言
8003
9362
  *
8004
9363
  * @public
9364
+ * @remarks 注意:本接口仅扩展有效,在独立脚本环境内调用将始终 `throw Error`
8005
9365
  * @param language - 语言
8006
9366
  * @param source - 欲导入的多语言数据对象
9367
+ * @returns 导入是否成功
8007
9368
  */
8008
9369
  importMultilingual(language: string, source: ISYS_LanguageKeyValuePairs): boolean;
8009
9370
  /**
@@ -8013,6 +9374,7 @@ declare class SYS_I18n {
8013
9374
  * @param namespace - 命名空间
8014
9375
  * @param language - 语言
8015
9376
  * @param source - 欲导入的多语言数据对象
9377
+ * @returns 导入是否成功
8016
9378
  */
8017
9379
  importMultilingualLanguage(namespace: string, language: string, source: ISYS_LanguageKeyValuePairs): boolean;
8018
9380
  /**
@@ -8021,6 +9383,7 @@ declare class SYS_I18n {
8021
9383
  * @public
8022
9384
  * @param namespace - 命名空间
8023
9385
  * @param source - 欲导入的多语言数据对象
9386
+ * @returns 导入是否成功
8024
9387
  */
8025
9388
  importMultilingualNamespace(namespace: string, source: ISYS_MultilingualLanguagesData): boolean;
8026
9389
  }
@@ -8174,7 +9537,7 @@ declare class SYS_PanelControl {
8174
9537
  * 打开左侧面板
8175
9538
  *
8176
9539
  * @public
8177
- * @param tab - 标签页,���若不指定则不切换标签页
9540
+ * @param tab - 标签页,如若不指定则不切换标签页
8178
9541
  */
8179
9542
  openLeftPanel(tab?: ESYS_LeftPanelTab): void;
8180
9543
  /**
@@ -8293,6 +9656,84 @@ declare class SYS_ShortcutKey {
8293
9656
  }>>;
8294
9657
  }
8295
9658
 
9659
+ /**
9660
+ * 系统 / 存储类
9661
+ *
9662
+ * @public
9663
+ * @remarks 可以进行扩展的用户配置存储、浏览器本地存储的操作接口
9664
+ */
9665
+ declare class SYS_Storage {
9666
+ /** 扩展 UUID */
9667
+ private extensionUuid?;
9668
+ /* Excluded from this release type: __constructor */
9669
+ /**
9670
+ * 获取扩展所有用户配置
9671
+ *
9672
+ * @public
9673
+ * @remarks 注意:本接口仅扩展有效,在独立脚本环境内调用将始终 `throw Error`
9674
+ * @returns 扩展所有用户配置信息
9675
+ */
9676
+ getExtensionAllUserConfigs(): {
9677
+ [key: string]: any;
9678
+ };
9679
+ /**
9680
+ * 设置扩展所有用户配置
9681
+ *
9682
+ * @public
9683
+ * @remarks
9684
+ * 此举会覆盖当前扩展的所有用户配置信息,请谨慎操作
9685
+ *
9686
+ * 注意:本接口仅扩展有效,在独立脚本环境内调用将始终 `throw Error`
9687
+ * @param configs - 扩展所有用户配置
9688
+ * @returns 操作是否成功
9689
+ */
9690
+ setExtensionAllUserConfigs(configs: {
9691
+ [key: string]: any;
9692
+ }): Promise<boolean>;
9693
+ /**
9694
+ * 清除扩展所有用户配置
9695
+ *
9696
+ * @public
9697
+ * @remarks
9698
+ * 此举会删除当前扩展的所有用户配置信息,请谨慎操作
9699
+ *
9700
+ * 注意:本接口仅扩展有效,在独立脚本环境内调用将始终 `throw Error`
9701
+ * @returns 操作是否成功
9702
+ */
9703
+ clearExtensionAllUserConfigs(): Promise<boolean>;
9704
+ /**
9705
+ * 获取扩展用户配置
9706
+ *
9707
+ * @public
9708
+ * @remarks 注意:本接口仅扩展有效,在独立脚本环境内调用将始终 `throw Error`
9709
+ * @param key - 配置项
9710
+ * @returns 配置项对应的值,不存在将返回 `undefined`
9711
+ */
9712
+ getExtensionUserConfig(key: string): any | undefined;
9713
+ /**
9714
+ * 设置扩展用户配置
9715
+ *
9716
+ * @public
9717
+ * @remarks
9718
+ * 新建扩展用户配置也使用本接口,在设置时如果不存在将会自动新建
9719
+ *
9720
+ * 注意:本接口仅扩展有效,在独立脚本环境内调用将始终 `throw Error`
9721
+ * @param key - 配置项
9722
+ * @param value - 值
9723
+ * @returns 操作是否成功
9724
+ */
9725
+ setExtensionUserConfig(key: string, value: any): Promise<boolean>;
9726
+ /**
9727
+ * 删除扩展用户配置
9728
+ *
9729
+ * @public
9730
+ * @remarks 注意:本接口仅扩展有效,在独立脚本环境内调用将始终 `throw Error`
9731
+ * @param key - 配置项
9732
+ * @returns 操作是否成功
9733
+ */
9734
+ deleteExtensionUserConfig(key: string): Promise<boolean>;
9735
+ }
9736
+
8296
9737
  /**
8297
9738
  * 系统 / 定时器类
8298
9739
  *
@@ -8370,9 +9811,17 @@ declare class SYS_ToastMessage {
8370
9811
  * 系统 / 单位类
8371
9812
  *
8372
9813
  * @public
8373
- * @remarks 控制系统单位与单位转换基础函数,当前系统标准单位跨度等效为 `mil`
9814
+ * @remarks 控制系统数据单位与单位转换基础函数,当前系统数据单位跨度等效为 `mil`
8374
9815
  */
8375
9816
  declare class SYS_Unit {
9817
+ /**
9818
+ * 获取 API 系统数据单位跨度
9819
+ *
9820
+ * @public
9821
+ * @remarks 当前 API 系统数据单位跨度等效为 `mil`,不会发生改变
9822
+ * @returns 单位
9823
+ */
9824
+ getSystemDataUnit(): ESYS_Unit.MIL;
8376
9825
  /**
8377
9826
  * 单位转换:密尔到毫米
8378
9827
  *
@@ -8430,7 +9879,7 @@ declare class SYS_Unit {
8430
9879
  }
8431
9880
 
8432
9881
  /**
8433
- * 系统 / WebSocket 类
9882
+ * ���统 / WebSocket 类
8434
9883
  *
8435
9884
  * @public
8436
9885
  * @remarks 与 WebSocket 服务器交互
@@ -8556,6 +10005,14 @@ declare type TPCB_LayersOfCustom = EPCB_LayerId.CUSTOM_1 | EPCB_LayerId.CUSTOM_2
8556
10005
  */
8557
10006
  declare type TPCB_LayersOfDimension = TPCB_LayersOfCustom | EPCB_LayerId.TOP_SILKSCREEN | EPCB_LayerId.BOTTOM_SILKSCREEN | EPCB_LayerId.DOCUMENT | EPCB_LayerId.MECHANICAL;
8558
10007
 
10008
+ /**
10009
+ * 填充所属层
10010
+ *
10011
+ * @public
10012
+ * @remarks 填充所属层为 {@link EPCB_LayerId.MULTI} 时代表挖槽区域
10013
+ */
10014
+ declare type TPCB_LayersOfFill = TPCB_LayersOfCopper | TPCB_LayersOfCustom | EPCB_LayerId.TOP_SILKSCREEN | EPCB_LayerId.TOP_SOLDER_MASK | EPCB_LayerId.TOP_PASTE_MASK | EPCB_LayerId.TOP_ASSEMBLY | EPCB_LayerId.BOTTOM_SILKSCREEN | EPCB_LayerId.BOTTOM_SOLDER_MASK | EPCB_LayerId.BOTTOM_PASTE_MASK | EPCB_LayerId.BOTTOM_ASSEMBLY | EPCB_LayerId.DOCUMENT | EPCB_LayerId.MECHANICAL | EPCB_LayerId.MULTI;
10015
+
8559
10016
  /**
8560
10017
  * SVG 图像所属层
8561
10018
  *
@@ -8584,6 +10041,13 @@ declare type TPCB_LayersOfLine = TPCB_LayersOfCopper | TPCB_LayersOfCustom | EPC
8584
10041
  */
8585
10042
  declare type TPCB_LayersOfPad = EPCB_LayerId.TOP | EPCB_LayerId.BOTTOM | EPCB_LayerId.MULTI;
8586
10043
 
10044
+ /**
10045
+ * 区域所属层
10046
+ *
10047
+ * @public
10048
+ */
10049
+ declare type TPCB_LayersOfRegion = TPCB_LayersOfCopper | EPCB_LayerId.MULTI;
10050
+
8587
10051
  /**
8588
10052
  * 内层允许设置的图层类型
8589
10053
  *
@@ -8596,7 +10060,7 @@ declare type TPCB_LayerTypesOfInnerLayer = EPCB_LayerType.SIGNAL | EPCB_LayerTyp
8596
10060
  *
8597
10061
  * @public
8598
10062
  * @remarks
8599
- * 单多边形为首尾重合的一条不间断的线所描述的区域��如果首尾不重合将会自动重合。
10063
+ * 单多边形为首尾重合的一条不间断的线所描述的区域,如果首尾不重合将会自动重合。
8600
10064
  *
8601
10065
  * 单多边形的数据格式举例:
8602
10066
  *