# Saving Images with .NET MAUI ImageEditor

`RadImageEditor` control gives you the option to save the currently edited image using the `SaveAsync` method. The `SaveAsync` method has the following overloads:

* `SaveAsync(Stream outputStream, ImageFormat imageFormat, double imageQuality)`

Saves the currently edited image to the specified stream, encoding it with the given format and quality.

* `SaveAsync(Stream outputStream, ImageFormat imageFormat, double imageQuality, Size maximumSize)`

Saves the currently edited image to the specified stream, encoding it with the given format, quality and size.

* `SaveAsync(Stream outputStream, ImageFormat imageFormat, double imageQuality, double scaleFactor)`

Saves the currently edited image to the specified stream, encoding it with the given format, quality and scale.

where:

* `outputStream`(`Stream`)—Specifies the output stream to save the image to.
* `imageFormat`(`ImageFormat`)—Specifies the image format to encode the image to. The available options from ImageFormat enumeration are JPEG, PNG, GIF and BMP. Currently, **Tif** is not supported.
* `imageQuality`(`double`)—Specifies the image quality to save the image to. The range is between 1 and 0, where the value of 1 specifies the maximum possible quality, resulting in minimum compression and the value of 0 specifies the minimum possible quality, resulting in maximum compression.
* `maximumSize`(`Size`)—Specifies the maximum size to save the image to. If the original image size is larger than the maximum size, the `SaveAsync` will save the image in the submitted maximum Size but the aspect ratio will be kept.
* `scaleFactor`(`double`)—Specifies a scale factor, which can be used to reduce the size of the final image. For example when setting values below 1 downscale the image before saving, which reducing the final image size and values above 1 upscale the image before saving, which increasing the final image size.

> note The saved image contains all currently applied changes in the ImageEditor.

**Example for Saving Images**

Here is how the `RadImageEditor` is defined:

```XAML
<Grid RowDefinitions="Auto,*">
    <HorizontalStackLayout Spacing="5"
                           HorizontalOptions="Center"
                           VerticalOptions="Center">
        <Button Text="Original Size" Clicked="OnSaveOriginalClicked"/>
        <Button Text="Specific Size" Clicked="OnSaveMaxSizeClicked"/>
        <Button Text="Downscaled" Clicked="OnSaveDownscaledClicked"/>
    </HorizontalStackLayout>
    <telerik:RadImageEditor x:Name="imageEditor" 
                            Grid.Row="1"
                            Source="https://raw.githubusercontent.com/telerik/maui-samples/main/Samples/ControlsSamples/Resources/Images/borderconfigurationavatar.png" />
</Grid>
```

* This example shows how to save image with the original size:

```C#
private async void OnSaveOriginalClicked(object sender, EventArgs e)
{
    var folderPath = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
    var filePath = Path.Combine(folderPath, "image.jpg");
    using (var fileStream = File.Create(filePath))
    {
        await this.imageEditor.SaveAsync(fileStream, ImageFormat.Jpeg, 0.9);
    }

    await Application.Current.Windows[0].Page.DisplayAlert("", "The Image is saved with original size", "OK");
}
```

![Toolbar Visual Structure](https://www.telerik.com/maui-ui/documentation/assets/e35628c1a42fae0da8da181b16a0db8d/imageeditor-saving-originalsize.png "Visual elements of Toolbar")

* This example shows how to save image with the specific size:

```C#
private async void OnSaveMaxSizeClicked(object sender, EventArgs e)
{
    var folderPath = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
    var filePath = Path.Combine(folderPath, "image.jpg");
    var maxsize = new Size(400, 500);
    using (var fileStream = File.Create(filePath))
    {
        await this.imageEditor.SaveAsync(fileStream, ImageFormat.Jpeg, 0.9, maxsize);
    }

    await Application.Current.Windows[0].Page.DisplayAlert("", "The Image is saved with Size 400:500", "OK");
}

```

* This example shows how to save image with downscale size:

```C#
private async void OnSaveDownscaledClicked(object sender, EventArgs e)
{
    var folderPath = Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData);
    var filePath = Path.Combine(folderPath, "image.jpg");
    using (var fileStream = File.Create(filePath))
    {
        await this.imageEditor.SaveAsync(fileStream, ImageFormat.Jpeg, 0.9, 0.5);
    }

    await Application.Current.Windows[0].Page.DisplayAlert("", "The Image is downscaled to 50%", "OK");
}
```

> important For the ImageEditor Save Image example refer to the [SDKBrowser Demo Application](https://www.telerik.com/maui-ui/documentation/demos-and-sample-apps/sdkbrowser-app).

## See Also

* [Zooming Image](https://www.telerik.com/maui-ui/documentation/controls/imageeditor/zooming-image)
* [Loading Image](https://www.telerik.com/maui-ui/documentation/controls/imageeditor/loading-image)
