High-performance DXF/DWG to image renderer for .NET, built on ACadSharp and ImageSharp.
Transform CAD drawings into raster images for previews, CI/CD pipelines, web applications, documentation, and automated workflows — with zero AutoCAD dependency.
- 🎨 Multi-format export — PNG, BMP, JPEG, GIF, and WebP support
- 📐 Full CAD support — Render DXF and DWG files with ACadSharp
- 🖼️ Customizable output — Control width, height, background color, and quality
- 📊 Space support — Model space, paper layouts, and viewports
- 🎭 Layer filtering — Hide specific layers with
--hide-layeroption - ⚡ CLI tool — Cross-platform command-line interface for automation
- 🔧 Library API — Full .NET integration with intuitive fluent-style configuration
- 🚀 Native AOT - Publish as standalone native binaries with zero .NET runtime requirement
- 📚 Fully documented — Complete XML IntelliSense support
dotnet add package ACadSharp.Imagedotnet tool install --global ACadSharp.Image.CliUpdate to latest version:
dotnet tool update --global ACadSharp.Image.CliRender a DWG file with custom settings:
using ACadSharp.IO;
using ACadSharp.Image;
using SixLabors.ImageSharp;
// Load CAD document
var document = DwgReader.Read("part.dwg");
// Configure and export
var exporter = new ImageExporter("output.webp");
exporter.Configuration.Width = 2000;
exporter.Configuration.Height = 1400;
exporter.Configuration.BackgroundColor = Color.Parse("#ffffff");
exporter.Configuration.OutputQuality = 90;
// Optional: hide specific layers
exporter.Configuration.HiddenLayers.Add("DIMENSIONS");
exporter.Configuration.HiddenLayers.Add("ANNOTATIONS");
exporter.AddModelSpace(document);
exporter.Save("./output-directory/filename.webp", ImageExportFormat.Webp);Multi-page export:
var exporter = new ImageExporter();
exporter.AddPaperLayouts(document);
exporter.Save("./output-directory/filename.png", ImageExportFormat.Png);Basic rendering:
cad-to-image "drawing.dxf" --format webp --width 1400 --height 1400 --quality 85Custom background & dimensions:
cad-to-image "part.dwg" --format png --width 1800 --height 1200 --background "#0c0c0c"Hide multiple layers:
cad-to-image "complex.dxf" --hide-layer "DIMENSIONS" --hide-layer "ANNOTATIONS" --hide-layer "BORDER"Export paper layouts:
cad-to-image "multi-sheet.dwg" --paper-layouts --output ./sheets/Usage:
cad-to-image <input.dxf|input.dwg> [options]
Options:
-o, --output <path> Output file or directory path.
-f, --format <format> png, bmp, jpg, jpeg, gif, webp.
-w, --width <pixels> Output width in pixels. Default: 1600.
-H, --height <pixels> Output height in pixels. Default: 900.
-b, --background <color> Background color name or hex value. Default: white.
-q, --quality <1-100> Output quality for lossy formats. Default: 90.
--paper-layouts Export paper layouts instead of model space.
--hide-layer <name> Hide entities on the specified layer. Can be used multiple times.
--help, -h, -? Show this help text.
ACadSharp.Image/
├── ImageExporter.cs # Main public API
├── ImageConfiguration.cs # Fluent configuration
├── ImagePage.cs # Page representation
├── RenderedImagePage.cs # Rendered output
└── Rendering/
├── ImagePageRenderer.cs # Page-level rendering
├── EntityRenderDispatcher.cs # Entity routing & dispatch
├── ImageRenderContext.cs # Coordinate transforms
└── ImageStyleResolver.cs # Color & line weight resolution
The library follows a clean architecture pattern:
- ImageExporter - Public API for adding CAD content
- ImagePage - Represents individual renderable pages
- Rendering pipeline - Transforms CAD entities to pixel coordinates and draws them
- Configuration - Fluent, extensible settings for customization
Control visibility of specific layers programmatically:
var exporter = new ImageExporter();
// Hide multiple layers (case-insensitive)
exporter.Configuration.HiddenLayers.Add("0");
exporter.Configuration.HiddenLayers.Add("DEFPOINTS");
exporter.Configuration.HiddenLayers.Add("ANNO_TEXT");
exporter.AddModelSpace(document);Override default line weight values:
exporter.Configuration.LineWeightValues[LineWeightType.W25] = 0.30;
exporter.Configuration.LineWeightScale = 1.5f; // Scale all weightsCustomize text rendering:
exporter.Configuration.FontFamilyName = "Consolas";
exporter.Configuration.ArcPrecision = 512; // Higher = smoother arcs- .NET 6.0 SDK or later
- Any IDE with C# support (VS 2022, VS Code, Rider)
# Clone and build
git clone https://github.com/slaveoftime/ACadSharp.Image.git
cd ACadSharp.Image
dotnet restore
dotnet build
# Run tests
dotnet testdotnet run --project ./ACadSharp.Image.Cli/ACadSharp.Image.Cli.csproj -- "./Samples/6-57-1119.dxf" --width 300 --height 200 --hide-layer OPTIONAL_DIMENSIONS
dotnet run --project ./ACadSharp.Image.Cli/ACadSharp.Image.Cli.csproj -- "./Samples/HSK80AHCP16190M_BMG.dwg" --format webp --width 1200 --height 760
dotnet run --project ./ACadSharp.Image.Cli/ACadSharp.Image.Cli.csproj -- "./Samples/Subaru Logo Vector Free Wrap.dxf" --format webp --width 1200 --height 760 --background "#72b5f2"dotnet pack ./ACadSharp.Image/ACadSharp.Image.csproj -c Release
dotnet pack ./ACadSharp.Image.Cli/ACadSharp.Image.Cli.csproj -c Release
dotnet tool install -g --add-source ./ACadSharp.Image.Cli/bin/Release ACadSharp.Image.CliZero-dependency standalone executables:
# Windows x64
dotnet publish ./ACadSharp.Image.Cli/ -c Release -r win-x64 --self-contained -p:PublishAot=true
# Linux x64
dotnet publish ./ACadSharp.Image.Cli/ -c Release -r linux-x64 --self-contained -p:PublishAot=true
# macOS ARM64
dotnet publish ./ACadSharp.Image.Cli/ -c Release -r osx-arm64 --self-contained -p:PublishAot=trueContributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is released under the MIT License.
If you find this project helpful, please consider giving it a ⭐️ on GitHub! It helps others discover the project.
Questions or issues? Open an issue or start a Discussion.
