Migration Notes Leave feedback

Cross-platform compatibility is improved by removing the dependency on System.Drawing.Common.

GroupDocs.Redaction now provides better support for Linux and other Supported Operating Systems.

Version 26.9 removes System.Drawing types from the public API. Color, point, size, rectangle, and font values used by redactions now come from GroupDocs.Redaction.Options.Drawing.

Code that still passes System.Drawing.Color, System.Drawing.Point, System.Drawing.Size, System.Drawing.Rectangle, or System.Drawing.Font will no longer compile. Replace these arguments with the corresponding types from GroupDocs.Redaction.Options.Drawing:

using GroupDocs.Redaction.Options.Drawing;

redactor.Apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions(Color.Black)));

redactor.Apply(new ImageAreaRedaction(
    new Point(516, 311),
    new RegionReplacementOptions(Color.Blue, new Size(170, 35))));

Color still exposes named colors (Color.Black, Color.Blue, and the other well-known names), Color.FromName, and Color.FromArgb.

Earlier 26.x builds kept the System.Drawing members and added temporary aliases that used the GroupDocs types. In 26.9 those aliases are obsolete. Use the original member names; they now use GroupDocs.Redaction.Options.Drawing:

IImageFormatInstance.EditArea accepts GroupDocs.Redaction.Options.Drawing.Point only. TextFragment accepts GroupDocs.Redaction.Options.Drawing.Rectangle only. Map coordinates from an OCR engine into that rectangle before you create a fragment.

Packages for .NET 6, .NET 8, and .NET 10 no longer depend on System.Drawing.Common. Image-area redaction and PDF rasterization on those frameworks do not require GDI+ or libgdiplus. The .NET Framework 4.6.2 build still uses the Windows GDI+ stack.

For more code examples and specific use cases please refer to our Developer Guide documentation or GitHub samples and showcases.