Playing With Images in ASP.NET Using C#

Playing with Images

Hello friends, in this article we are going to learn a few things related to images and the file upload control. I have divided this article into 3 sections. This article is for complete beginners who are working with the File Upload control and images and want to know about the following points:

1. Finding the height and width of an Image.
2. Appending a time stamp with the image name while saving it.
3. Adding a watermark on an image while uploading it. 

First before looking at the code, this is how my sample page looks:

Image of my Sample Application

Explanation

1. Finding the height and width of an image

Sometimes in our application we can allow our users to upload their images. And sometimes we want them to upload an image of a specific dimension. For example - 450x900. Hence the following is the code for finding the height and width.

Code to check the height and width of an image

Default.aspx page code

The following is the code for the Default.aspx page:

<%@ Page Title="Home Page" Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>

<asp:Content ID="HeaderContent" runat="server" ContentPlaceHolderID="HeadContent">
</asp:Content>
<asp:Content ID="BodyContent" runat="server" ContentPlaceHolderID="MainContent">
    <h2>
        Welcome to ASP.NET!
    </h2>
    <p>
        Please Select an Image file: &nbsp;&nbsp;
        <asp:FileUpload ID="FUP_WatermarkImage" runat="server" />
    </p>
    <p>
        <asp:Button ID="btnUpload" runat="server" Text="Upload Image" onclick="btnUpload_Click" />
    </p>
    <p>
        <asp:Image ID="imgUploadedImage" runat="server" Width="250" Height="250" BorderColor="Black" BorderStyle="Solid" BorderWidth="1" />
    </p>
</asp:Content> 

Note: Please note that in the ASP.Net Image control I have kept the width and height as 250 for both. So in my code I am going to check whether the image height and width exceeds 250*250 dimension. If it does then I'll show an error message to the user and won't allow him to upload that image.

    protected void btnUpload_Click(object sender, EventArgs e)
    {
        if (Fupload_WatermarkImage.HasFile)
        {
            string FileType = Path.GetExtension(Fupload_WatermarkImage.PostedFile.FileName).ToLower().Trim(); 
            // Checking the format of the uploaded file.
            if (FileType != ".jpg" && FileType != ".png" && FileType != ".gif" && FileType != ".bmp")
            {
                string alert = "alert('File Format Not Supported. Only .jpg, .png, .bmp and .gif file formats are allowed.');";
                ScriptManager.RegisterStartupScript(this, GetType(), "JScript", alert, true);
            }
            else
            {
                // Getting the stream of the selected image and assign it to the Image Object.
                 System.Drawing.Image UploadedImage = System.Drawing.Image.FromStream(Fupload_WatermarkImage.PostedFile.InputStream); 
                // Checking if the Width or height is greater than 250px
                if (UploadedImage.PhysicalDimension.Width > 250 || UploadedImage.PhysicalDimension.Height > 250)
                 {
                    string alert = "alert('Image size should be exactly 250*250 dimension. Your Current Image width is " + UploadedImage.PhysicalDimension.Width + " and height is " + UploadedImage.PhysicalDimension.Height + ".');";
                    ScriptManager.RegisterStartupScript(this, GetType(), "JScript", alert, true);
                 }
                else
                 {
                    // SOME CODE COMES HERE...
                 }
            }
        }
    }
 

User tries to upload image with a dimension of more than 250 pixels

Image indicating the width of the uploaded image

The following image shows indicating the width of the uploaded image:

Image indicating the height of the uploaded image

The following image shows indicating the height of the uploaded image:

Error message shown to the user

The following image shows the error message shown to the user:

2. Appending a time stamp with the image name while saving it

Sometimes a user might add an image with the same name twice. So in that case if you want to differentiate between the images then you can attach the current time stamp with the image name. The following is the code for doing that.

// Getting the file name of the selected image
string FileName = Path.GetFileNameWithoutExtension(Fupload_WatermarkImage.PostedFile.FileName); 
// Getting the file extension of the selected image
string FileExtension = Path.GetExtension(Fupload_WatermarkImage.PostedFile.FileName); 
// Creating a complete relative path for storing the image. And also attaching the datetime stamp with the image name.
string path = "Watermarked Images/" + FileName + DateTime.Now.ToString("yyyy-MM-dd HHmmtt") + FileExtension;                   
// Saving the Image.
Fupload_WatermarkImage.SaveAs(Server.MapPath(path));                   
// Assigning the uploaded image url to the Image control.
imgUploadedImage.ImageUrl = path;

if (!String.IsNullOrEmpty(imgUploadedImage.ImageUrl))
{

        // Showing a notification of success after uploading.
           string alert = "alert('Image uploaded successfully');";
         ScriptManager.RegisterStartupScript(this, GetType(), "JScript", alert, true);
}

Note: You can easily understand the code, since I have added appropriate comments with each line of my code. The line of code marked in yellow is where I am attaching my current time stamp with the image name.

Selected an image with the height and width less than 250 pixels

The following is the image which shows how exactly the image is saved.

Code Debugged

The following is the debugged code:

The current time is attached with the image name. So the next time, even if I upload the an image with the same name, I can still upload it since the timestamp differentiates it.

Final Output - Image being displayed in the Image Control

The following shows the final output; the image being displayed in the Image Control:

Image uploaded in the folder

The following shows the image uploaded to the folder:

3. Watermarking the Image

Sometimes when we add images from our application, we do not want anyone else to copy it or use it in their application. Hence the watermark is the option which helps to protect our images from getting copied or used by other users. The following is the code written to add a watermark on the image before saving it in the folder.

Code for watermarking: The content marked in yellow actually writes / watermarks the image.

// Create an Image Object and fill it with the stream of the selected image.
System.Drawing.Image image = System.Drawing.Image.FromStream(Fupload_WatermarkImage.PostedFile.InputStream);                   

// Get the height and width of an image.
int width = image.Width;
int height = image.Height;

// Creating the Bitmap Object and assigning the width and height of the image.
// It internally creates a graphical image with the same dimension.
System.Drawing.Bitmap bmp = new System.Drawing.Bitmap(width, height);                   

// Creating a Graphics Object from the Bitmap Object.
System.Drawing.Graphics graphics1 = System.Drawing.Graphics.FromImage((System.Drawing.Image)bmp);                   

// Assigning few properties to the Graphics Object, to maintain the quality of the image.
graphics1.InterpolationMode = System.Drawing.Drawing2D.InterpolationMode.High;
graphics1.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.HighQuality;
graphics1.Clear(System.Drawing.Color.Transparent);
graphics1.DrawImage(image, 0, 0, width, height); 

// Create the Font and the Brush Object and assign appropriate parameters inorder to add watermark to the image.
System.Drawing.Font font = new System.Drawing.Font("Arial", 20);
System.Drawing.SolidBrush brush = new System.Drawing.SolidBrush(System.Drawing.Color.Aqua); 

// Drawstring actually writes / watermarks the image with the specified content.
// Parameters contain :- Watermark Content, font style, brush used, x and y position for the string to be written
graphics1.DrawString("C Sharp Corner", font, brush, 25F, 115F);                     

// Create the image object from the bitmap and then use it to save the watermarked image in the folder.
System.Drawing.Image newImage = (System.Drawing.Image)bmp;

// Getting the file name of the selected image
string FileName = Path.GetFileNameWithoutExtension(Fupload_WatermarkImage.PostedFile.FileName);

// Getting the file extension of the selected image
string FileExtension = Path.GetExtension(Fupload_WatermarkImage.PostedFile.FileName);

// Creating a complete relative path for storing the image. And also attaching the datetime stamp with the image name.
string path = "Watermarked Images/" + FileName + DateTime.Now.ToString("yyyy-MM-dd HHmmtt") + FileExtension;

// Saving the Watermarked Image in the specified folder
newImage.Save(Server.MapPath(path));

// Assigning the uploaded image url to the Image control.
imgUploadedImage.ImageUrl = path;

// Disposing the Graphics Object and other resources from the memory.
graphics1.Dispose(); 
if (!String.IsNullOrEmpty(imgUploadedImage.ImageUrl))
{

    // Showing a notification of success after uploading.
     string alert = "alert('Image uploaded successfully');";
     ScriptManager.RegisterStartupScript(this, GetType(), "JScript", alert, true);

}

Note - For understanding the code, I have added appropriate comments with the code. The content marked in Yellow is the code for adding the watermark.

Final Output of the above Code: The Watermark appears on the image in Cyan (Blue) color. The text is "C# Corner"

Image saved in the folder with watermark

The folowing shows the image saved in the folder with the watermark:

So this was a simple application where we played with images while uploading them to the folder. Hope you liked it and this article helped you... Don't forget to leave your comments. It always encourages me to move ahead.

If you want to check the entire code, then please find/download the attached code file available with this article.