# 熔化-美化PCB

**Repository Path**: m-RNA/Easy_EDA_PCB_Beautify

## Basic Information

- **Project Name**: 熔化-美化PCB
- **Description**: 嘉立创EDA扩展：一键将PCB拐角圆弧美化，线宽突变处贝塞尔美化；支持DRC、撤销、快照
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-07-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ![LOGO](./images/readme-logo.png) Melt/Optimize/Beautify PCB Routing

[简体中文](./README.md) | [English](./README.en.md) | When translation has deviations, the Chinese version shall prevail.

One-click optimization of PCB corners into arcs to improve geometric continuity and routing appearance while reducing manufacturing and stress risks from sharp corners; Bezier transitions at sudden trace-width changes; supports differential/equal-length protection, DRC checks, automatic copper-region rebuild, multi-step undo, snapshot management, forced arc generation, and other advanced optimization features

> Inspiration: [[Melt your circuit boards]](https://www.youtube.com/watch?v=euJgtLcWWyo)

1. Corner beautification to arcs (radius can be edited afterward)
![preview](./images/preview1.gif)
1. Smooth beautification at sudden width changes (based on Bezier curves)
![preview](./images/preview2.gif)
1. Snapshot management & undo support
![preview](./images/preview3.gif)
1. DRC Rule Check
![preview](./images/preview4.jpg)

> Note: Plugin under development. It's recommended to backup your project before operation. Feedback welcome when encountering issues.

**Usage**

Menu location: Advanced → Beautify PCB

- Smooth Routing (Selected/All) – Process trace corners (arc-based beautification); the corner-radius ratio defaults to `10x`
- Connection Node Protection – Keeps pad/via centers and T/cross junctions unchanged by default to prevent disconnections after smoothing
- Diff/Length Protection – Enabled by default for DRC differential pairs and equal-length net groups; uses concentric arcs when corners can be matched and keeps uncertain corners straight
- Width Transition (Selected) – Smooth gradient between varying trace widths (enhanced teardrops via Bezier curves, supports position adjustment); only the Selected action remains in the top menu
- DRC Rule Check – Apply optimistic routing first, then progressively reduce or revert non-compliant corners. The maximum adjustment count defaults to `60` and is configurable from `1` to `100`; copper-pour rules can be ignored, and one final check always runs after all beautify post-processing
- Automatic Copper Region Rebuild – Rebuild related regions with copper conflicts after an operation. The configurable automatic limit defaults to **30 copper regions**; above it, the extension prompts for the host's `Shift+B` command
- Undo / Snapshot – Selected operations use incremental restore and update only changed primitives; All operations use full restore to prioritize whole-board integrity; switch between auto/manual snapshot views
- Shortcuts – Defaults: `F6` for Smooth Selected, `F9` for Smooth All, and `Ctrl+Shift+Z` for Undo; includes customization, conflict detection, and runtime compatibility warnings
- Advanced Settings – Configure radius, transition parameters, DRC adjustment rounds, copper-region limit, snapshots, and shortcuts; supports persistent card ordering/folding, with debug logs disabled by default and available on demand
- Alpha Performance Acceleration – Disabled by default. When enabled, it pauses ratline/canvas calculations during beautify and restore, then tries one batch rebuild for all copper regions after restore. Each unavailable API falls back automatically; back up the project before testing

**Use Cases and Notes**

- Smooth routing is mainly intended for visual routing polish, flexible boards, high-voltage traces, high-current traces, and some RF or sharp-corner-sensitive layouts. It is usually low risk on ordinary low-speed boards, but snapshots and DRC checks are still recommended.
- Hand-made PCBs also benefit greatly from rounded routing: smoother corners are easier to draw, transfer, and etch by hand, while reducing the difficulty of producing sharp corners. Always verify clearance and connectivity afterward.
- Do not blindly apply global smoothing to high-speed digital, RF, or impedance-controlled nets. A smoother-looking shape does not automatically mean lower signal reflection. Critical nets should be checked against impedance, length, and SI requirements; transition length should be calculated for the actual frequency and structure (for example, the tapered impedance transformer idea in `Variational Theory of the Tapered Impedance Transformer`).
- Pad/via node protection is enabled by default. Same-net center connections and T/cross junctions are kept unchanged. If pad/via protection is disabled, direct connections in high-speed designs should still be reviewed for local cutouts, impedance compensation, or other project-specific requirements.
- Diff/Length Protection is enabled by default. The plugin uses concentric arcs for corners that can be matched reliably; uncertain corners are kept straight to avoid breaking length relationships just for smoother visuals. After processing, verify net lengths, equal-length rules, and DRC in EDA.
- Before exporting manufacturing files, inspect the final geometry in Gerber preview or manufacturing checks, especially around forced arcs, width transitions, complex board outlines, and copper pours.

You can enable display in the top menu via: Advanced → Extension Manager → Installed Extensions → Beautify PCB → Configure (check the option to show in top menu for convenient use)

![preview](./images/topMenuConfig.jpg)

![preview](./images/topMenu.jpg)

![preview](./images/setting.jpg)

> The settings image illustrates the layout. Current defaults and shortcuts are defined by this document and the installed extension.

**Contributing**

Forks & PRs welcome! Development environment setup as follows:

Clone repository:

```bash
git clone --recursive https://github.com/m-RNA/Easy_EDA_PCB_Beautify.git
cd Easy_EDA_PCB_Beautify
```

Already cloned? Pull submodules:

```bash
git submodule update --init --recursive
```

Note: Submodules are locked to specific compatible versions. Do not update using the `--remote` parameter, as this may cause compilation failures.

Install & Build:

```bash
npm install
npm run build
```

Build output: `.eext` extension package in the `build/dist/` directory

See [Developer Notes](./docs/DEVELOPER_NOTES.md) for verified JLC EDA API and runtime behavior.

**Structure**

```txt
src/
├── index.ts           # Entry point & menu registration
└── lib/
    ├── beautify.ts    # Corner smoothing (Beautify)
    ├── arcGeometry.ts # Corner and concentric-arc geometry
    ├── widthTransition.ts # Width transition
    ├── snapshot.ts    # Snapshot management
    ├── shortcuts.ts   # Shortcut registration
    ├── math.ts        # Math utilities
    ├── routeTopology.ts # Board topology and electrical anchor protection
    ├── drc.ts         # DRC checks & copper pour filtering
    ├── eda_utils.ts   # EDA utilities (copper pour rebuild, etc.)
    ├── logger.ts      # Logging
    └── settings.ts    # Settings read/write
iframe/
└── settings.html      # Settings interface
pro-api-sdk/           # Git submodule (JLCEDA Pro Extension API SDK)
```

**License**

This project is licensed under the Apache-2.0 License - see [LICENSE](https://www.apache.org/licenses/LICENSE-2.0.txt) for details.