SharpCutSvg 1.2.0

SharpCut

SharpCut is a modern, precise C# library for generating and manipulating 2D vector shapes for laser cutting, CNC, and more. It supports compound shapes, edge merging, geometric utilities, and clean SVG export.

📦 Available on NuGet

✨ Features

• Define axis-aligned rectangles and custom shapes
• Compose compound shapes with automatic edge overlap removal
• Build clean, deduplicated closed paths
• Export compact SVG output with one path per shape
• Control stroke width, color, units
• Automatically size SVG documents to fit content
• Fully typed with nullable reference types enabled
• No dependencies – works cross-platform with .NET 8+

📦 Example Usage

Basic Shape to SVG

using SharpCut;
using SharpCut.Models;

// Define a simple rectangle
Rectangle rectangle = new Rectangle(0, 0, 100, 50);

// Create document, add the shape, resize and export
SvgDocument svg = new SvgDocument();
svg.Add(rectangle, copy: true);
svg.ResizeToFitContent(margin: 5, offsetContent: true);

string content = svg.Export();

Compound Shape with Finger Joints

using SharpCut;
using SharpCut.Models;
using SharpCut.Builders;

// Base panel
Rectangle panelBase = new Rectangle(x: 5, y: 5, width: 160, height: 50);

// Small vertical finger joint shape
Rectangle cut = new Rectangle(width: 3, height: 25);

// Distribute tabs evenly along the bottom of the base panel
List<Rectangle> placedCuts = cut.PlaceCopiesOnPoints(
    points: panelBase.GetEdge(Side.Bottom).GetDistributedPoints(2),
    origin: Origin.BottomCenter
);

// Build compound shape and clean overlapping edges
CompoundShape compoundShape = new CompoundShape(panelBase, placedCuts);

// Export to SVG
SvgDocument svg = new SvgDocument(strokeWidth: 0.1f, unit: "mm");
svg.Add(compoundShape, copy: true);
svg.ResizeToFitContent(margin: 5, offsetContent: true);

string exportedSvg = svg.Export();

🧱 Structure

• SharpCut.Models – geometry: Point, Edge, Rectangle, Shape, CompoundShape, Origin, Side
• SharpCut.Builders – logic: ShapeBuilder for deduplicating edges
• SharpCut – output: SvgDocument for exporting shapes as SVG

🧪 Testing

SharpCut uses MSTest with comprehensive coverage:

• EdgeTests
• PointTests
• RectangleTests
• ShapeTests
• ShapeBuilderTests
• SvgDocumentTests

Run tests via:

dotnet test

🛠 Requirements

• .NET 8
• No external dependencies

📄 License

MIT License (You can do whatever you want with the code, please feel free to contribute if you have any improvement suggestions)