Aspose.Drawing.Common 24.11.0

Cross-Platform 2D Graphics Library for .NET

Aspose.Drawing vs. Aspose.Drawing.Common

Aspose.Drawing

• A cross-platform 2D graphics library for .NET that serves as a direct replacement for System.Drawing.Common. It allows seamless migration without requiring any code changes.
• If you're interested in seamless migration from System.Drawing.Common., use Aspose.Drawing.

Aspose.Drawing.Common

• Uses the Aspose.Drawing namespace and allows side-by-side use with System.Drawing.Common. Ideal for projects that need a gradual migration while maintaining compatibility.
• If you need side-by-side compatibility with System.Drawing.Common, use Aspose.Drawing.Common.

Aspose.Drawing for .NET is a high-performance, cross-platform 2D graphics API designed for .NET developers. It offers seamless migration from System.Drawing.Common and provides extensive drawing features for lines, shapes, arcs, polygons, and text. Supporting a wide range of platforms, including Windows, Linux, macOS, Azure, and Blazor WebAssembly, Aspose.Drawing ensures consistent rendering results without relying on third-party libraries. With its support for bitmap creation, vector graphics, transformations, text rendering, and anti-aliasing, it is ideal for developers seeking high-quality, multi-platform drawing capabilities in C#.

Aspose.Drawing.Common library allows developers to draw bitmap images, geometric shapes, and apply graphic transformations. It does not depend on any third-party native libraries, ensuring consistent rendering results across all supported platforms​. Aspose.Drawing.Common is known for its cross-platform compatibility, allowing it to be used on various platforms such as Windows, MacOS, Linux, Azure, ASP.NET Core, Blazor WebAssembly, and .NET MAUI applications on Android and iOS​.

The Aspose.Drawing.Common package uses the Aspose.Drawing namespace, which allows it to be used side-by-side with System.Drawing.Common without conflicts. This makes it a suitable option for projects that need gradual transition from System.Drawing.Common while maintaining compatibility.

System.Drawing.Common Replacement

Cross-Platform Graphics Library

Aspose.Drawing for .NET provides a contemporary cross-platform graphic drawing library that offers advanced features and functionality.

Consistent Rendering

Ensures consistent rendering results across all supported platforms without the need for third-party libraries.

Seamless Migration

Seamlessly replace System.Drawing.Common by updating project references from System to Aspose.

System.Drawing.Common Alternative

Full Compatibility

Fully compatible with .NET Core 3.1, .NET 6, .NET 7, and Xamarin, supporting cross-platform development for Windows, Linux, Android, and Blazor WebAssembly.

Extensive 2D Drawing Features

Supports drawing lines, shapes, splines, arcs, polygons, and text with anti-aliasing, strikeout, and underline rendering options.

High-Quality Rendering

Provides high-quality text rendering with anti-aliasing and hinting, making fonts look smooth on any display.

Cross-Platform 2D Graphics Library

Supported Platforms

Aspose.Drawing works across platforms such as Windows, macOS, Linux, Azure, and Blazor WebAssembly, ensuring consistent performance.

Installation via NuGet

Installable through the NuGet package manager for Visual Studio for easy integration.

Rendering Capabilities

Offers consistent results in rendering vector graphics and raster images across all platforms.

Cross-Platform Drawing API for C# (.NET)

Geometric Drawing API

Draw lines, shapes, rectangles, polygons, arcs, and Bezier curves with a cross-platform C# API.

Transformations Support

Apply different transformations to 2D objects and save results as raster or vector images.

Multi-Platform Consistency

Ensure consistent drawing quality across Windows, Linux, Azure, ASP.NET, and more.

Create Bitmap from Scratch or Load from File Using C#

New Bitmap Creation

Create a new image from scratch using Aspose.Drawing with support for drawing arcs, curves, and lines.

Load Existing Images

Load and edit images from file and save them back to disk using the API.

Drawing Tools

Utilize pens and brushes to create a variety of shapes and images.

Working with Vector Graphics in C#

Draw Arc

Draw arcs by specifying starting points, angles, and dimensions on a bitmap.

Draw Bezier Spline

Draw Bezier curves using control points to define the curve direction.

Draw Lines and Shapes

Create and manipulate lines, rectangles, ellipses, and polygons using the Graphics and Pen objects.

Working with Pens

Set Pen Width

Define the width of lines when drawing with pens.

Set Pen Color

Customize pen colors for drawing lines and shapes on a bitmap.

Join Lines

Join multiple lines to create complex paths and shapes.

Using Aspose.Drawing in .NET 6

Cross-Platform Support

Fully supports .NET 6 for cross-platform graphics rendering, with consistent performance across Windows, Linux, and macOS.

Azure Function Compatibility

Use Aspose.Drawing in serverless Azure Functions for graphics manipulation.

Blazor WebAssembly Integration

Integrates seamlessly with Blazor WebAssembly for client-side rendering and drawing.

Working with Brushes

Solid Brushes

Fill shapes with solid colors using the SolidBrush class.

Gradient Brushes

Use linear and path gradient brushes to create complex color patterns.

Texture Brushes

Apply textures to shapes for enhanced graphical effects.

Working with Image Rendering

Antialiasing for Images

Enable antialiasing to smooth edges and enhance image quality during rendering.

Clipping Path

Use the SetClip method to define clip paths for rendering parts of an image.

Alpha Blending

Blend images with backgrounds using alpha channels for transparency.

Working with Coordinate System Transformations

Global Transformation

Apply global transformations like rotation and translation to the entire graphic object.

Matrix Transformation

Use matrix transformations to rotate, scale, and skew individual shapes within an image.

Units of Measure

Customize units of measure (pixels, points, inches) for precise image rendering.

Working with Text and Fonts

Draw Text

Use the DrawString method to render text on images with different fonts and styles.

Text Formatting

Format text alignment, line spacing, and font properties for precise rendering.

Text Hinting

Apply text hinting to enhance readability and ensure smooth font edges.

Supported File Formats

System Requirements

Operating Systems

Aspose.Drawing for .NET supports 32-bit and 64-bit systems, including:

• Microsoft Windows (XP, Vista, 7, 8, 10) and Server (2003, 2008, 2012, 2016, 2019)
• Windows Azure, Linux, Mac OS X

Supported Frameworks

• .NET Framework 2.0
• .NET Core 2.0 or later

Development Environments

• Microsoft Visual Studio 2012, 2013, 2015, 2017, 2019

Get Started

1. Install via NuGet

• Open Microsoft Visual Studio and the NuGet package manager.
• Search for “Aspose.Drawing” or “Aspose.Drawing.Common.”
• Click Install to download and reference it in your project.

2. Install or Update via Package Manager Console

• Open Visual Studio and go to Tools > Library Package Manager > Package Manager Console.
• Type Install-Package Aspose.Drawing to install the latest version.
• To update, use Update-Package Aspose.Drawing. You can add -prerelease to get hotfixes.

3. Referencing the Library

• In Solution Explorer, right-click References and select Add Reference.
• If manually installed, browse for Aspose.Drawing.dll and click OK to add it.

4. Uninstalling Aspose.Drawing

• Open Control Panel > Add/Remove Programs.
• Select Aspose.Drawing for .NET and click Remove to uninstall.

Draw an Arc in C#

This example shows how to create a bitmap, draw an arc, and save the image in C# using Aspose.Drawing for .NET.

// Create a bitmap object
using (var bitmap = new Bitmap(1000, 800))
{
    // Initialize a Graphics object with the bitmap
    using (var graphics = Graphics.FromImage(bitmap))
    {
        // Define a pen with color and width
        using (var pen = new Pen(Color.Blue, 2))
        {
            // Draw an arc on the bitmap
            graphics.DrawArc(pen, new Rectangle(0, 0, 700, 700), 0, 180);

            // Save the image as PNG
            bitmap.Save("output_arc.png");
        }
    }
}

Draw Text with Anti-Aliasing in C#

Demonstrates how to render anti-aliased text inside a clipped ellipse area using Aspose.Drawing for .NET.

// Create a bitmap object
using (var bitmap = new Bitmap(1000, 800))
{
    // Initialize a Graphics object with anti-aliasing
    using (var graphics = Graphics.FromImage(bitmap))
    {
        graphics.TextRenderingHint = TextRenderingHint.AntiAliasGridFit;

        // Create a GraphicsPath representing an ellipse
        var path = new GraphicsPath();
        path.AddEllipse(new Rectangle(200, 200, 400, 200));

        // Clip the text inside the ellipse
        graphics.SetClip(path);

        // Define font, brush, and format for the text
        var font = new Font("Arial", 20);
        var brush = new SolidBrush(Color.Black);
        var format = new StringFormat { Alignment = StringAlignment.Center };

        // Draw the string within the clipped ellipse
        graphics.DrawString("Hello World!", font, brush, new RectangleF(200, 200, 400, 200), format);

        // Save the image
        bitmap.Save("output_text.png");
    }
}

Create a Bezier Spline in C#

This snippet demonstrates drawing a Bezier spline using the DrawBezier method in Aspose.Drawing for .NET.

// Create a bitmap object
using (var bitmap = new Bitmap(1000, 800))
{
    // Initialize a Graphics object
    using (var graphics = Graphics.FromImage(bitmap))
    {
        // Define a pen for drawing
        using (var pen = new Pen(Color.Blue, 2))
        {
            // Define control points for Bezier curve
            Point pt1 = new Point(100, 100);
            Point pt2 = new Point(200, 10);
            Point pt3 = new Point(350, 400);
            Point pt4 = new Point(500, 300);

            // Draw the Bezier curve
            graphics.DrawBezier(pen, pt1, pt2, pt3, pt4);

            // Save the image
            bitmap.Save("output_bezier.png");
        }
    }
}

Cross-Platform 2D Graphics Library | System.Drawing.Common Replacement | Cross-Platform Drawing API | Geometric Drawing API | 2D Drawing in C# | Create Bitmap in C# | Aspose.Drawing for .NET | Working with Vector Graphics | Using Pens in C# | Drawing with Brushes | Image Rendering | Coordinate System Transformations | Text and Fonts in C# | Aspose.Drawing in .NET 6 | Aspose.Drawing in Azure | Blazor WebAssembly | Bitmap Image Creation | Rendering Vector Graphics | NuGet Package | Graphics API for .NET | Pen and Brush Usage | Text Rendering in C# | Drawing Arc in C# | Bezier Spline in C# | Text with Anti-Aliasing | Image Rendering with Clipping | Create Bitmap from Scratch | High-Quality Text Rendering | Azure Function Compatibility