how-to-fit-graphics-to-frames.md

title	description	type	page_title	slug	position	tags	res_type
How to Fit Graphics to Frames	Learn how to fit graphics and images in specific frames using PdfProcessing.	how-to	How to Fit Graphics	how-to-fit-graphics-to-frames	0	pdf, image, graphic, frame	kb

Product Version	Product	Author
2021.1.118	RadPdfProcessing	Martin Velikov

Description

How to fit images to frames (predefined shapes, or in our case a square with a side length of 90) or vice versa.

Solution

This functionality could be achieved by using the FixedContentEditor API. Below are demonstrated the following four different scenarios:

• Fit Content Proportionally
• Fit Content To Frame (or Stretch fit)
• Fill Frame Proportionally (or Center fit)
• Fit Frame to Content

The following example demonstrates how to fit the image in a square without changing the image sides aspect ratio.

[C#] Fit Content Proportionally

{{region kb-how-to-fit-graphics-to-frames1}}

double squareSide = 90;

FixedContentEditor editor = new FixedContentEditor(document.Pages.AddPage());
editor.DrawText("Fit Content Proportionally");
editor.Position.Translate(0, 20);
using (Stream sampleImage = File.OpenRead("image.jpg"))
{
    Block block = new Block();
    block.InsertImage(sampleImage);
    Size imageSize = block.Measure();
    using (editor.SavePosition())
    {
        double largestSide = imageSize.Width > imageSize.Height ? imageSize.Width : imageSize.Height;
        double scaleFactor = squareSide / largestSide;
        editor.Position.Scale(scaleFactor, scaleFactor);
        editor.DrawBlock(block);
    }
}

{{endregion}}

The following example demonstrates how to stretch the image in a square (the image aspect ratio is changed).

[C#] Fit Content To Frame

{{region kb-how-to-fit-graphics-to-frames2}}

double squareSide = 90;

FixedContentEditor editor = new FixedContentEditor(document.Pages.AddPage());
editor.DrawText("Fit Content To Frame");
editor.Position.Translate(0, 20);
using (Stream sampleImage = File.OpenRead("image.jpg"))
{
    Block block = new Block();
    block.InsertImage(sampleImage, squareSide, squareSide);
    editor.DrawBlock(block);
}

{{endregion}}

The following example demonstrates how to crop the image in order to fill a square without changing the image aspect ratio.

[C#] Fill Frame Proportionally

{{region kb-how-to-fit-graphics-to-frames3}}

double squareSide = 90;

RadFixedPage page = document.Pages.AddPage();
FixedContentEditor editor = new FixedContentEditor(page);
editor.DrawText("Fill Frame Proportionally");
editor.Position.Translate(0, 20);
using (Stream sampleImage = File.OpenRead("image.jpg"))
{
    Block block = new Block();
    block.InsertImage(sampleImage);
    Size imageSize = block.Measure();
    using (editor.SavePosition())
    {
        double smallestSide = imageSize.Width < imageSize.Height ? imageSize.Width : imageSize.Height;
        double scaleFactor = squareSide / smallestSide;
        editor.Position.Scale(scaleFactor, scaleFactor);
        editor.DrawBlock(block);
        Image image = page.Content[page.Content.Count - 1] as Image;

        Point clippingOffset = editor.Position.Matrix.Transform(new Point());

        if (imageSize.Width == smallestSide)
        {
            clippingOffset.Offset(0, imageSize.Height * scaleFactor / 2 - squareSide / 2);
        }
        else
        {
            clippingOffset.Offset(imageSize.Width * scaleFactor / 2 - squareSide / 2, 0);
        }

        image.Clipping = new Clipping()
        {
            Clip = new RectangleGeometry(new Rect(clippingOffset.X, clippingOffset.Y, squareSide, squareSide)),
        };
    }
}

{{endregion}}

In the last scenario, we are finding the smallest side of the image and use it to calculate the factor which we are using to scale the position. After that, we are calculating the offset that we are going to use to create an image Clipping with the desired size.

The following example demonstrates how to insert an image in its original size.

[C#] Fit Frame to Content

{{region kb-how-to-fit-graphics-to-frames4}}

FixedContentEditor editor = new FixedContentEditor(document.Pages.AddPage());
editor.DrawText("Fit Frame To Content");
editor.Position.Translate(0, 20);
using (Stream sampleImage = File.OpenRead("image.jpg"))
{
    Block block = new Block();
    block.InsertImage(sampleImage);
    Size imageSize = block.Measure();
    editor.DrawBlock(block);
}

{{endregion}}