Support for Graphics class and every related class, struct and enum

.gitignore

@@ -3,3 +3,5 @@ bin/
 obj/
 /_packages
 GeneXus.Drawing-DotNet.sln.DotSettings.user
+/Test/Common/res/images/.out
+.DS_Store

README.md

@@ -38,6 +38,8 @@ This repository is organized as follows:
 Root
 ├─ src                           : source code
 │  ├─ Common
+│  │  ├─ Drawing2D               : elements for GeneXus.Drawing.Drawing2D
+│  │  │  └─ ...
 │  │  ├─ Imaging                 : elements for GeneXus.Drawing.Imaging
 │  │  │  └─ ...
 │  │  ├─ Interop                 : elements for GeneXus.Drawing.Interop
@@ -46,10 +48,12 @@ Root
 │  │  │  └─ ...
 │  │  └─ ...                     : elements for GeneXus.Drawing
 │  │ 
-│  └─ PackageREADME.md
+│  └─ PackageREADME.md           : package readme file
 │
 ├─ test                          : unit tests
 │  ├─ Common
+│  │  ├─ Drawing2D               : unit-tests for GeneXus.Drawing.Drawing2D
+│  │  │  └─ ...
 │  │  ├─ Text                    : unit-tests for GeneXus.Drawing.Text
 │  │  │  └─ ...
 │  │  └─ ...                     : unit-tests for GeneXus.Drawing
@@ -75,28 +79,71 @@ This section describes each module (namespace) specifiying which elements are pa
 ### GeneXus.Drawing.Common
 Basic graphics funcionalities based on `System.Drawing`.
 
-| Name                 | Type     | Description
-|----------------------|----------|--------------
-| `Bitmap`             | Class    | Represents an image defined by pixels.
-| `Color`              | Class    | Defines colors used for drawing.
-| `Font`               | Class    | Defines a format for text, including font family, size, and style.
-| `Icon`               | Class    | Represents an icon image.
-| `Image`              | Class    | Represents an image in a specific format.
-| `Svg` <sup>(1)</sup> | Class    | Represents Scalable Vector Graphics.
-| `Point`              | Struct   | Defines an x and y coordinate in a 2D plane.
-| `PointF`             | Struct   | Defines a floating-point x and y coordinate in a 2D plane.
-| `Rectangle`          | Struct   | Defines an x, y, width, and height of a rectangle.
-| `RectangleF`         | Struct   | Defines a floating-point x, y, width, and height of a rectangle.
-| `Size`               | Struct   | Defines the width and height of a rectangular area.
-| `SizeF`              | Struct   | Defines the width and height of a rectangular area with floating-point values.
-| `FontSlant`          | Enum     | Specifies the slant of a font.
-| `FontStyle`          | Enum     | Specifies the style of a font.
-| `GraphicsUnit`       | Enum     | Specifies the unit of measure for drawing operations.
-| `KnownColor`         | Enum     | Defines predefined colors.
-| `RotateFlipType`     | Enum     | Specifies how an image is rotated or flipped.
+| Name                    | Type     | Description
+|-------------------------|----------|--------------
+| `Bitmap`                | Class    | Represents an image defined by pixels.
+| `Brush`                 | Class    | Abstract class for brushes used to fill graphics shapes.
+| `Color`                 | Class    | Defines colors used for drawing.
+| `ColorConverter`        | Class    | Converts colors from one data type to another
+| `ColorTranslator`       | Class    | Translates colors to and from HTML, OLE and Win32 representations.
+| `Font`                  | Class    | Defines a format for text, including font family, size, and style.
+| `Graphics`              | Class    | Provides methods for drawing on a drawing surface.
+| `Icon`                  | Class    | Represents an icon image.
+| `Image`                 | Class    | Represents an image in a specific format.
+| `Pen`                   | Class    | Defines an object used to draw lines and curves.
+| `Region`                | Class    | Defines the area of a drawing surface.
+| `SolidBrush`            | Class    | Defines a brush of a single color.
+| `StringFormat`          | Class    | Defines text layout information, display manipulation and font features.
+| `Svg` <sup>(1)</sup>    | Class    | Represents Scalable Vector Graphics.
+| `TextureBrush`          | Class    | Defines a brush that uses an image to fill shapes.
+| `Point`                 | Struct   | Defines an x and y coordinate in a 2D plane.
+| `PointF`                | Struct   | Defines a floating-point x and y coordinate in a 2D plane.
+| `Rectangle`             | Struct   | Defines an x, y, width, and height of a rectangle.
+| `RectangleF`            | Struct   | Defines a floating-point x, y, width, and height of a rectangle.
+| `Size`                  | Struct   | Defines the width and height of a rectangular area.
+| `SizeF`                 | Struct   | Defines the width and height of a rectangular area with floating-point values.
+| `CopyPixelOperation`    | Enum     | Specifies the type of pixel copying operation.
+| `FontSlant`             | Enum     | Specifies the slant of a font.
+| `FontStyle`             | Enum     | Specifies the style of a font.
+| `GraphicsUnit`          | Enum     | Specifies the unit of measure for drawing operations.
+| `KnownColor`            | Enum     | Defines predefined colors.
+| `RotateFlipType`        | Enum     | Specifies how an image is rotated or flipped.
+| `StringAlignment`       | Enum     | Specifies the alignment of text within a string.
+| `StringDigitSubstitute` | Enum     | Specifies how digits are substituted in a string.
+| `StringFormatFlags`     | Enum     | Specifies formatting options for strings.
+| `StringTrimming`        | Enum     | Specifies how text is trimmed when it does not fit.
 
 <small><sup>(1)</sup> New element (does not belogs to `System.Drawing` library).</small>
 
+### GeneXus.Drawing.Drawing2D
+Advanced 2D graphics functionalities based on `System.Drawing.Drawing2D` for complex vector graphics and rendering tasks.
+
+| Name                  | Type     | Description
+|-----------------------|----------|--------------
+| `Blend`               | Class    | Defines a blend of colors along a gradient.
+| `ColorBlend`          | Class    | Defines a blend of colors for a gradient.
+| `GraphicsPath`        | Class    | Represents a series of connected lines and curves.
+| `HatchBrush`          | Class    | Defines a brush with a hatching pattern.
+| `PathGradientBrush`   | Class    | Defines a brush that fills an area with a gradient of colors.
+| `LinearGradientBrush` | Class    | Defines a brush that fills an area with a linear gradient of colors.
+| `Matrix`              | Struct   | Defines a transformation matrix for graphics operations.
+| `PathData`            | Struct   | Contains data associated with a GraphicsPath object.
+| `CombineMode`         | Enum     | Specifies how two graphics objects are combined.
+| `CompositingQuality`  | Enum     | Specifies the quality of compositing operations.
+| `CoordinateSpace`     | Enum     | Specifies the coordinate space for transformations.
+| `DashCap`             | Enum     | Specifies the cap style for dashed lines.
+| `FillMode`            | Enum     | Specifies the fill mode for filling shapes.
+| `InterpolationMode`   | Enum     | Specifies the interpolation mode for scaling and resizing.
+| `LineCap`             | Enum     | Specifies the shape of the end of a line.
+| `LineJoin`            | Enum     | Specifies the shape used to join two connected lines.
+| `MatrixOrder`         | Enum     | Specifies the order of matrix transformations.
+| `PenAlignment`        | Enum     | Specifies the alignment of a pen's stroke.
+| `PenType`             | Enum     | Specifies the type of pen used for drawing.
+| `PixelOffsetMode`     | Enum     | Specifies how to offset pixels when drawing.
+| `SmoothingMode`       | Enum     | Specifies the level of smoothing applied to graphics.
+| `WarpMode`            | Enum     | Specifies how text is warped.
+| `WrapMode`            | Enum     | Specifies how text wraps within its container.
+
 ### GeneXus.Drawing.Imaging
 Advanced image processing based on `System.Drawing.Imaging` to support sophisticated image manipulation and format handling.
 
@@ -114,9 +161,11 @@ Advanced typographic features based on `System.Drawing.Text` for managing and re
 | Name                      | Type     | Description
 |---------------------------|----------|--------------
 | `FontCollection`          | Class    | Represents a collection of fonts.
-| `InstalledFontCollection` | Class | Represents a collection of installed fonts.
-| `PrivateFontCollection`   | Class | Represents a collection of private fonts.
-| `GenericFontFamilies`     | Enum | Specifies generic font families.
+| `InstalledFontCollection` | Class    | Represents a collection of installed fonts.
+| `PrivateFontCollection`   | Class    | Represents a collection of private fonts.
+| `GenericFontFamilies`     | Enum     | Specifies generic font families.
+| `HotkeyPrefix`            | Enum     | Specifies how hotkey prefixes are rendered.
+| `TextRenderingHint`       | Enum     | Specifies the level of text rendering quality.
 
 ### GeneXus.Drawing.Interop
 Advanced interoperability utilities based on `System.Drawing.Interop` that includes definitions used in font management and graphics rendering.

src/Common/Bitmap.cs

@@ -53,8 +53,12 @@ public Bitmap(float width, float height)
 	/// Initializes a new instance of the <see cref='Bitmap'/> class with the specified size 
 	/// and with the resolution of the specified <see cref='Graphics'/> object.
 	/// </summary>
-	//public Bitmap(int width, int height, object g) // TODO: Implement Graphics
-	//	: this(width, height) => throw new NotImplementedException();
+	public Bitmap(int width, int height, Graphics g)
+		: this(width, height)
+	{
+		HorizontalResolution = g.DpiX;
+		VerticalResolution = g.DpiY;
+	}
 
 	/// <summary>
 	/// Initializes a new instance of the <see cref='Bitmap'/> class with the specified size and format.
@@ -119,13 +123,20 @@ public Bitmap(Image original, Size size)
 	/// Creates a copy of the section of this <see cref='Bitmap'/> defined 
 	/// by <see cref='Rectangle'/> structure and with a specified PixelFormat enumeration.
 	/// </summary>
-	public object Clone(Rectangle rect, PixelFormat format)
+	public object Clone(RectangleF rect, PixelFormat format)
 	{
 		var bitmap = new Bitmap(rect.Width, rect.Height);
 		var portion = SKRectI.Truncate(rect.m_rect);
 		return m_bitmap.ExtractSubset(bitmap.m_bitmap, portion) ? bitmap : Clone();
 	}
 
+	/// <summary>
+	/// Creates a copy of the section of this <see cref='Bitmap'/> defined 
+	/// by <see cref='Rectangle'/> structure and with a specified PixelFormat enumeration.
+	/// </summary>
+	public object Clone(Rectangle rect, PixelFormat format)
+		=> Clone(new RectangleF(rect.m_rect), format);
+
 	#endregion
 
 
@@ -253,7 +264,7 @@ protected override void RotateFlip(int degrees, float scaleX, float scaleY)
 	/// </summary>
 	public void SetPixel(int x, int y, Color color)
 	{
-		var c = new SKColor((byte)color.R, (byte)color.G, (byte)color.B, (byte)color.A);
+		var c = new SKColor(color.R, color.G, color.B, color.A);
 		m_bitmap.SetPixel(x, y, c);
 	}
 

src/Common/Brush.cs

@@ -0,0 +1,192 @@
+using System;
+using SkiaSharp;
+
+namespace GeneXus.Drawing;
+
+public abstract class Brush : IDisposable, ICloneable
+{
+	internal readonly SKPaint m_paint;
+
+	internal Brush(SKPaint paint)
+	{
+		m_paint = paint ?? throw new ArgumentNullException(nameof(paint));
+		m_paint.Style = SKPaintStyle.Fill;
+	}
+
+	/// <summary>
+	///  Cleans up resources for this <see cref='Brush'/>.
+	/// </summary>
+	~Brush() => Dispose(false);
+
+
+	#region IDisposable
+
+	/// <summary>
+	///  Cleans up resources for this <see cref='Brush'/>.
+	/// </summary>
+	public void Dispose()
+	{
+		GC.SuppressFinalize(this);
+		Dispose(true);
+	}
+
+	protected virtual void Dispose(bool disposing) => m_paint.Dispose();
+
+	#endregion
+
+
+	#region IClonable
+
+	/// <summary>
+	///  Creates an exact copy of this <see cref='Pen'/>.
+	/// </summary>
+	public abstract object Clone();
+
+	#endregion
+
+
+	#region Operators
+
+	/// <summary>
+	///  Creates a <see cref='SKPaint'/> with the coordinates of the specified <see cref='Brush'/>.
+	/// </summary>
+	public static explicit operator SKPaint(Brush brush) => brush.m_paint;
+
+	#endregion
+
+
+	#region Utilities
+
+	protected static Drawing2D.Blend GetBlendTriangularShape(float focus, float scale)
+	{
+		if (focus < 0 || focus > 1)
+			throw new ArgumentException("Invalid focus value", nameof(focus));
+		if (scale < 0 || scale > 1)
+			throw new ArgumentException("Invalid scale value", nameof(scale));
+
+		int count = focus == 0 || focus == 1 ? 2 : 3;
+		Drawing2D.Blend blend = new(count);
+
+		if (focus == 0)
+		{
+			blend.Positions[0] = 0;
+			blend.Factors[1] = scale;
+			blend.Positions[1] = 1;
+			blend.Factors[1] = 0;
+		}
+		else if (focus == 1)
+		{
+			blend.Positions[0] = 0;
+			blend.Factors[1] = 0;
+			blend.Positions[1] = 1;
+			blend.Factors[1] = scale;
+		}
+		else
+		{
+			blend.Positions[0] = 0;
+			blend.Factors[0] = 0;
+			blend.Positions[1] = focus;
+			blend.Factors[1] = scale;
+			blend.Positions[2] = 1;
+			blend.Factors[2] = 0;
+		}
+		return blend;
+	}
+
+	protected static Drawing2D.Blend GetSigmaBellShape(float focus, float scale = 1.0f)
+	{
+		if (focus < 0 || focus > 1)
+			throw new ArgumentException("Invalid focus value", nameof(focus));
+		if (scale < 0 || scale > 1)
+			throw new ArgumentException("Invalid scale value", nameof(scale));
+
+		int count = focus == 0 || focus == 1 ? 256 : 511;
+		Drawing2D.Blend m_blend = new(count);
+
+		// TODO: clear preset colors
+
+		float fallOffLenght = 2.0f;
+		if (focus == 0)
+		{
+			m_blend.Positions[0] = focus;
+			m_blend.Factors[0] = scale;
+
+			SigmaBellBlend(ref m_blend, focus, scale, 1 / fallOffLenght, 1f / 2, 1f / 255, 1, count - 1, true);
+
+			m_blend.Positions[count - 1] = 1f;
+			m_blend.Factors[count - 1] = 0f;
+		}
+		else if (focus == 1)
+		{
+			m_blend.Positions[0] = 0f;
+			m_blend.Factors[0] = 0f;
+
+			SigmaBellBlend(ref m_blend, focus, scale, 1 / fallOffLenght, 1f / 2, 1f / 255, 1, count - 1, false);
+
+			m_blend.Positions[count - 1] = focus;
+			m_blend.Factors[count - 1] = scale;
+		}
+		else
+		{
+			int middle = count / 2;
+
+			// left part of the sigma bell
+			m_blend.Positions[0] = 0f;
+			m_blend.Factors[0] = 0f;
+
+			SigmaBellBlend(ref m_blend, focus, scale, focus / (2 * fallOffLenght), focus / 2, focus / 255, 1, middle, false);
+
+			// middle part of the sigma bell
+			m_blend.Positions[middle] = focus;
+			m_blend.Factors[middle] = scale;
+
+			// right part of the sigma bell
+			SigmaBellBlend(ref m_blend, focus, scale, (1 - focus) / (2 * fallOffLenght), (1 + focus) / 2, (1 - focus) / 255, middle + 1, count - 1, true);
+
+			m_blend.Positions[count - 1] = 1f;
+			m_blend.Factors[count - 1] = 0f;
+		}
+		return m_blend;
+
+		static void SigmaBellBlend(ref Drawing2D.Blend blend, float focus, float scale, float sigma, float mean, float delta, int startIndex, int endIndex, bool invert)
+		{
+			float sg = invert ? -1 : 1;
+			float x0 = invert ? 1f : 0f;
+
+			float cb = (1 + sg * Erf(x0, sigma, mean)) / 2;
+			float ct = (1 + sg * Erf(focus, sigma, mean)) / 2;
+			float ch = ct - cb;
+
+			float offset = invert ? focus : 0;
+			float pos = delta + offset;
+
+			for (int index = startIndex; index < endIndex; index++, pos += delta)
+			{
+				blend.Positions[index] = pos;
+				blend.Factors[index] = scale / ch * ((1 + sg * Erf(pos, sigma, mean)) / 2 - cb);
+			}
+		}
+
+		static float Erf(float x, float sigma, float mean, int terms = 6)
+		{
+			/*
+			* Error function (Erf) for Gaussian distribution by Maclaurin series:
+			* erf (z) = (2 / sqrt (pi)) * infinite sum of [(pow (-1, n) * pow (z, 2n+1))/(n! * (2n+1))]
+			*/
+			float constant = 2 / (float)Math.Sqrt(Math.PI);
+			float z = (x - mean) / (sigma * (float)Math.Sqrt(2));
+
+			float series = z;
+			for (int n = 1, fact = 1; n < terms; n++, fact *= n)
+			{
+				int sign = (int)Math.Pow(-1, n);
+				int step = 2 * n + 1;
+				series += sign * (float)Math.Pow(z, step) / (fact * step);
+			}
+
+			return constant * series;
+		}
+	}
+
+	#endregion
+}