Quick Start

The following quick start sections help you in getting started with the DsImaging library:

• Create and Save an Image

• Load and Modify an Image

Create and Save an Image

This quick start covers how to create an image and draw string on it in a specified font using a .NET Core or .NET Standard application. Follow the steps below to get started:

1. Create an instance of GcBitmap class

2. Draw and fill a rectangle

3. Save the image

Step 1: Create an instance of GcBitmap class

1. Create a new application (.NET Core Console App\Windows Forms App) and add the references.

2. Include the following namespaces

   1. using GrapeCity.Documents.Imaging;

3. Create a new image using an instance of GcBitmap class, through code.

   //Create GcBitmap
   var bmp = new GcBitmap(1024, 1024, true, 96, 96);
   //Create a graphics for drawing
   GcBitmapGraphics g = bmp.CreateGraphics();

Step 2: Draw and fill a rectangle

Add the following code to draw a rectangle using the RectangleF class, and then add text to it using the DrawString method of GcBitmapGraphics class.

//Add a radial gradient
RadialGradientBrush r= new RadialGradientBrush(Color.Beige, 
        Color.RosyBrown, new PointF(0.5f, 0.5f), true);

//Draw a rectangle
var rc = new RectangleF(0, 0, bmp.Width, bmp.Height);

//Fill the rectangle using specified brush
g.FillRectangle(rc, r);

// Create a text format for the "Hello World!" string:
TextFormat tf = new TextFormat();
            
//Pick a font size, color and style
tf.FontSize = 80;
tf.FontStyle = FontStyle.BoldItalic;
tf.ForeColor = Color.Chocolate;

//Draw the string (text)
g.DrawString("Hello World!", tf, rc, TextAlignment.Center, 
        ParagraphAlignment.Center, false);

Step 3: Save the image

Save the image using SaveAsJpeg method of the GcBitmap class.

//Save bitmap as JPEG image
bmp.SaveAsJpeg("HelloWorld.jpg");

Load and Modify an Image

This quick start covers how to load an existing image, modify and save it using a .NET Core or .NET Standard application. Follow the steps below to get started:

1. Load an existing image

2. Modify the image

3. Save the image

Step 1: Load an existing image

1. Create a new application (.NET Core Console App\Windows Forms App) and add the references.

2. Include the following namespace

   1. using GrapeCity.Documents.Imaging;

3. Load an existing image using Load method of the GcBitmap class.

   //Create GcBitmap
   var bmp = new GcBitmap();
   var fs = new FileStream(Path.Combine("puffins-small.jpg"), FileMode.Open, FileAccess.ReadWrite);
   //Load image
   bmp.Load(fs);

Step 2: Modify the image

1. Add the following code that to add a text using the DrawString method of GcBitmapGraphics class to draw string.

   //Create a graphics for drawing
   GcBitmapGraphics g = bmp.CreateGraphics();
   
   // Create a text format for the string:
   TextFormat tf = new TextFormat();
   
   // Pick a font size, color and style
   tf.FontSize = 10;
   tf.ForeColor = Color.Red;
   tf.FontStyle = FontStyle.BoldItalic;
   
   //Draw the string (text)
   g.DrawString("Penguins", tf, new PointF(10, 10));

Step 3: Save the image

Save the image using SaveAsJpeg method of the GcBitmap class.

//Save bitmap
bmp.SaveAsJpeg("NewImage.jpg");