# ImageInline

`ImageInline` is an inline-level flow content element intended to contain an image object.

## Supported Image Extensions

With WordsProcessing, you can work with images from the following file formats:

* JPG
* JPEG
* PNG
* BMP
* TIFF
* TIF
* GIF
* ICON
* WMF
* EMF
* BIN
* SVG (Starting with 2024 Q3)

## Inserting an ImageInline

**Example 1** demonstrates how to create an `ImageInline` and add it to a [Paragraph](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/model/paragraph):

**Example 1: Create an ImageInline from PNG bytes and append it to a paragraph**

```C#
ImageInline imageInline = new ImageInline(document);

byte[] data = File.ReadAllBytes("logo.png");
imageInline.Image.ImageSource = new ImageSource(data, "png");

paragraph.Inlines.Add(imageInline);
```

> tip The parent `Paragraph` must belong to the same document that is passed to the constructor of the `ImageInline`.

You can add an image at a specific index in the `Inlines` collection of a paragraph using the `Insert()` method. The following example shows how to add an `ImageInline` at the beginning of a paragraph:

**Example 2: Insert an ImageInline created from PNG bytes at the beginning of a paragraph**

```C#
ImageInline imageInline = new ImageInline(document);

byte[] data = File.ReadAllBytes("logo.png");
imageInline.Image.ImageSource = new ImageSource(data, "png");

paragraph.Inlines.Insert(0, imageInline);
```

You can also use the `AddImageInline()` method of the `Inlines` collection of a paragraph. The method creates a new `ImageInline`, adds it to the paragraph, and returns it.

**Example 3: Create and add an inline image with the AddImageInline method**

```C#
ImageInline imageInline = paragraph.Inlines.AddImageInline();
```

You can also insert an `ImageInline` element in a `RadFlowDocument` with [RadFlowDocumentEditor](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/editing/radflowdocumenteditor).

**Example 4: Insert an inline PNG image from a stream with RadFlowDocumentEditor**

```C#
RadFlowDocumentEditor editor = new RadFlowDocumentEditor(document);

using (Stream stream = File.OpenRead("Telerik_logo.png"))
{
    editor.InsertImageInline(stream, "png", new Size(118, 28));
}
```

## Modifying an ImageInline

The `ImageInline` element exposes the following properties:

* `Image`: Represents the image object that is contained in the `ImageInline`. It is a read-only composite object that contains the properties listed below:

  * `ImageSource`: Specifies the image source that is visualized in the image object.
  * `Name`: Represents the name of the image.
  * `Width`: The width of the image.
  * `Height`: The height of the image.
  * `Size`: The size of the image. Can also be set to `Size.Empty`.
  * `IsHorizontallyFlipped`: Specifies whether the image is horizontally flipped.
  * `IsVerticallyFlipped`: Specifies whether the image is vertically flipped.
  * `RotationAngle`: Specifies the rotation angle of the image.
  * `LockAspectRatio`: Determines whether the aspect ratio between the width and the height of the image is preserved.
  * `Link`: Specifies the link that opens when the image is clicked. The property is of type `string`. This property works with the DOCX format only.

## Working with Image Size

This section explains the behavior of the `Size` property of the `Image` object in an `ImageInline` and how the image sizes are exported to the supported formats.

> important When using the .NET Standard version of the RadWordsProcessing packages, to export to PDF format documents containing images different than Jpeg and Jpeg2000 or `ImageQuality` different than High, you must set the `JpegImageConverter` property inside the `FixedExtensibilityManager`. For more information, refer to the `FixedExtensibilityManager` in the [PdfProcessing Cross-Platform Support](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/cross-platform/overview) article.

* **Insert image without specifying its size**
  * Model: Size is `Size.Empty`.
  * Export to DOCX: Size is decoded.
  * Export to RTF: Size is decoded.
  * Export to HTML: Width and height attributes are not exported.
  * Export to PDF: Size is decoded.

* **Insert image and set its size to Size.Empty**
  * Model: Size is `Size.Empty`.
  * Export to DOCX: Size is (1,1).
  * Export to RTF: Size is (1,1).
  * Export to HTML: Width and height attributes are not exported.
  * Export to PDF: Size is (1,1).

* **Insert image without specifying its size and obtain its size later (through the property getter)**
  * Model: Size is decoded.

## See Also

* [ImageInline API Reference](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Flow.Model.Shapes.ImageInline.html)
* [Document Model](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/model/model)
* [FloatingImage](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/model/floatingimage)
* [Paragraph](https://www.telerik.com/document-processing-libraries/documentation/libraries/radwordsprocessing/model/paragraph)
* [Converting WMF Images to PNG in RTF Documents with RadWordsProcessing](https://www.telerik.com/document-processing-libraries/documentation/knowledge-base/convert-wmf-to-png-radwordsprocessing)
* [Converting WEBP Images to PNG in HTML Documents Using Telerik WordsProcessing](https://www.telerik.com/document-processing-libraries/documentation/knowledge-base/convert-webp-to-png-radwordsprocessing)