SVG support - luberda-molinet/FFImageLoading GitHub Wiki
SVG files are now working and support every FFImageLoading's feature. It uses SkiaSharp for rendering. If SVG file isn't loading, try to optimise file first using this: https://jakearchibald.github.io/svgomg/ (or cmd only https://github.com/svg/svgo and add it to your pre-build scripts)
Important SkiaSharp issue: https://github.com/xamarin/xamarin-macios/issues/5265
FFImageLoading now supports loading data as data:
urls or plain SVG.
data:image/svg+xml;base64,[BASE64ENCODEDSVGFILE]
<SVG>NOT_ENCODED_SVGFILECONTENT</SVG>
data:image/svg+xml,<SVG>[NOT_ENCODED_SVGFILECONTENT</SVG>
Read more here:
It's very easy, just add Xamarin.FFImageLoading.Svg.Forms
nuget and use SvgCachedImage
instead CachedImage
. To avoid linking issues (type not found exceptions), please reference SvgCachedImage
in platform specific project:
public partial class AppDelegate : global::Xamarin.Forms.Platform.iOS.FormsApplicationDelegate
{
public override bool FinishedLaunching(UIApplication app, NSDictionary options)
{
global::Xamarin.Forms.Forms.Init();
CachedImageRenderer.Init();
var ignore = typeof(SvgCachedImage);
LoadApplication(new App());
return base.FinishedLaunching(app, options);
}
}
<?xml version="1.0" encoding="UTF-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" x:Class="FFImageLoading.Forms.Sample.SvgSamplePage"
xmlns:ffimageloadingsvg="clr-namespace:FFImageLoading.Svg.Forms;assembly=FFImageLoading.Svg.Forms">
<ContentPage.Content>
<ffimageloadingsvg:SvgCachedImage WidthRequest="200" HeightRequest="200" Source="sample.svg"/>
<!-- SECOND APPROACH (PCL EmbeddedResource): -->
<ffimageloadingsvg:SvgCachedImage WidthRequest="200" HeightRequest="200" Source="resource://FFImageLoading.Forms.Sample.Resources.sample.svg"/>
</ContentPage.Content>
</ContentPage>
When loading from embedded resources, you can specify different assembly with following format: resource://FFImageLoading.Forms.Sample.Resources.sample.svg?assembly=[ASSEMBLY FULL NAME]
https://stackoverflow.com/questions/658446/how-do-i-find-the-fully-qualified-name-of-an-assembly
More advanced scenarios: use a custom SvgImageSource
which enables SVG support. Please notice, that it has optional parameters for controlling renderered SVG size (automatic by default) IMPORTANT: Your projects also must reference System.Xml.Linq
.
From code:
source = SvgImageSource.FromFile("image.svg")
source = SvgImageSource.FromUri("http://example.com/image.svg")
// etc...
Or use a provided converter (eg. when using XAML):
Source="{Binding SvgFileName, Converter={StaticResource SvgImageSourceConverter}}"
Add Xamarin.FFImageLoading.Svg
nuget package to platform project.
Use ImageService
with svg data resolver for displaying svg images. See below in the Android section for details.
On Xamarin UWP, in Release mode with .NET Native compilation activated, the function SvgImageSource::FromResource() will not work for auto-detecting the calling assembly. You need to pass the assembly containing the resources as a parameter.
GetCallingAssembly() does not work because System.Reflection is altered by the Native compilation.
// example of solution: using System.Reflection; // [...] if (Runtime.IsUWP()) { // this fixes the bug that GetCallingAssembly() throws an exception in Release mode for UWP Assembly sourceAssembly = typeof(CurrentClassNameWithResourcesInSameAssembly).GetTypeInfo().Assembly; return SvgImageSource.FromResource(resourcePath, sourceAssembly); }
When loading images you have to configure custom data resolver which enables SVG support:
ImageService.Instance
.LoadFile("image.svg")
.LoadingPlaceholder("placeholder.svg")
.WithCustomDataResolver(new SvgDataResolver(200, 0, true))
.WithCustomLoadingPlaceholderDataResolver(new SvgDataResolver(200, 0, true))
.Into(imageView);
In xaml markup it's just simple ImageView:
<ImageView
android:id="@+id/image_view"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
You can also load svg image from string:
var svgString = @"<svg><rect width=""30"" height=""30"" style=""fill:blue"" /></svg>";
ImageService.Instance
.LoadString(svgString)
.LoadingPlaceholder(placeHolderPath)
.WithCustomDataResolver(new SvgDataResolver(64, 0, true))
.WithCustomLoadingPlaceholderDataResolver(new SvgDataResolver(64, 0, true))
.Into(imageView);
or from URL:
ImageService.Instance
.LoadUrl("https://images/image.svg")
.WithCustomDataResolver(new SvgDataResolver(64, 0, true))
.Into(imageView);
Converting svg string into UIImage:
var svgString = @"<svg><rect width=""30"" height=""30"" style=""fill:blue"" /></svg>";
UIImage img = await ImageService.Instance
.LoadString(svgString)
.WithCustomDataResolver(new SvgDataResolver(64, 0, true))
.AsUIImageAsync();
- You can replace svg string by using
Dictionary<string, string>
replacement map. - You can use Regex.Replace, just set dictionary item key to:
regex:[your regex expression here]
Specify / bind ReplaceStringMap
parameter of SvgCachedImage
object OR provide optional replaceStringMap
parameter in SvgImageSource
methods.
Provide replaceStringMap
parameter in SvgDataResolver
constructor.
Before creating a ReplaceStringMap, always check the SVG for how the structure is. For example they might use the "fill=" attribute or the CSS style "style="fill: rgb(0, 0, 0);" in it. The replace the latter, please see the code below as an exampe. Setting the ReplaceStringMap property automatically refreshes the image if you want to change colors dynamically.
var dict = new Dictionary<string, string>();
dict.Add("fill: rgb(0, 0, 0);", GetRGBFill(myXamarinColor));
var icon = new SvgCachedImage
{
ReplaceStringMap = dict,
Source = source,
};
And a small helper to do the replacement:
public static string GetRGBFill(Xamarin.Forms.Color color)
{
var red = (int)(color.R * 255);
var green = (int)(color.G * 255);
var blue = (int)(color.B * 255);
var rgbFill = $"fill: rgb({red},{green},{blue});";
return rgbFill;
}