SharpSharp

The typical use case for this high-speed .NET Core library is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP, and AVIF images of varying dimensions.

This is a .NET Core port of the Lovell Fuller's lovely high-performance Node.js image processor sharp / sharp github.

Sharp uses the low-level image processor libvips / libvips github.

This port makes use of Kleis Auke Wolthuizen's libvips .NET binding NetVips / NetVips github.

You will need to provide the appropriate NetVips.Native package for your platform.

I haven't implemented everything, just the pieces I've needed so far. Maybe at some point I'll add-to and/or refactor it.

Install

Install-Package SharpSharp -Version 0.6.0-alpha11
Install-Package NetVips.Native -Version 8.11.3.1

Examples

Resize and save to various formats with default values

using SharpSharp;

ImagePipeline
	.FromFile("input.jpg")
	.Resize(800)
	.ToFile("output.avif");

ImagePipeline
	.FromFile("input.jpg")
	.Resize(800)
	.ToFile("output.gif");

ImagePipeline
	.FromFile("input.jpg")
	.Resize(800)
	.ToFile("output.heif");

ImagePipeline
	.FromFile("input.jpg")
	.Resize(800)
	.ToFile("output.jpeg");

ImagePipeline
	.FromFile("input.jpg")
	.Resize(800)
	.ToFile("output.png");

ImagePipeline
	.FromFile("input.jpg")
	.Resize(800)
	.ToFile("output.tiff");

ImagePipeline
	.FromFile("input.jpg")
	.Resize(800)
	.ToFile("output.webp");

Result file sizes (in bytes)

829,183 input.jpg

 24,131 output.avif
367,885 output.gif
 24,131 output.heif
 81,728 output.jpeg
 83,042 output.png
 83,042 output.tiff
 54,776 output.webp

Result images

INPUT 2725x2225 (From sharp's test images, image credit
AVIF
GIF
HEIF
JPEG
PNG -- TODO: Unclear why chrome won't display
TIFF -- TODO: Unclear why chrome won't display
WEBP

Input from URL

using SharpSharp;

(await ImagePipeline.FromUriAsync("https://www.fillmurray.com/300/300"))
	.Resize(150)
	.Webp()
	.ToFile("murray.webp");

Benchmarks

Sharp's benchmark (sharp's benchmark)

Task

Decompress a 2725x2225 JPEG image, resize to 720x588 using Lanczos 3 resampling (where available), then compress to JPEG at a "quality" setting of 80.

Contenders

FreeImage-dotnet-core v4.3.6
Magick.NET-Q8-AnyCPU v7.22.2.2
SixLabors.ImageSharp v1.0.2
SkiaSharp v2.80.2
SharpSharp v0.6.0-alpha10

Environment 1

BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19041.685 (2004/?/20H1) Intel Core i7-2600K CPU 3.40GHz (Sandy Bridge), 1 CPU, 8 logical and 4 physical cores .NET Core SDK=5.0.101 [Host] : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT Job-YJAIQO : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT

Runtime=.NET Core 5.0

Results 1

Method	Op/s	Gen 0	Gen 1	Gen 2	Allocated
'SharpSharp Buffer to Buffer'	23.395	272.7273	272.7273	272.7273	80.35 KB
'SharpSharp File to File'	20.591	-	-	-	15.04 KB
'SkiaSharp Buffer to Buffer'	9.766	200.0000	-	-	1025.37 KB
'SkiaSharp File to File'	9.295	200.0000	-	-	964.03 KB
'ImageSharp Buffer to Buffer'	5.373	-	-	-	368.17 KB
'ImageSharp File to File'	5.237	-	-	-	53.55 KB
'FreeImage Buffer to Buffer'	4.709	1000.0000	1000.0000	1000.0000	189.62 KB
'FreeImage File to File'	4.400	1000.0000	1000.0000	1000.0000	12.68 KB
'ImageMagick File to File'	2.489	-	-	-	17.24 KB
'ImageMagick Buffer to Buffer'	2.486	-	-	-	342.49 KB

Environment 2

BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19041.685 (2004/?/20H1) Intel Core i7-7820HQ CPU 2.90GHz (Kaby Lake), 1 CPU, 8 logical and 4 physical cores .NET Core SDK=5.0.101 [Host] : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT Job-CGFPLG : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT

Runtime=.NET Core 5.0

Results 2

Method	Op/s	Gen 0	Gen 1	Gen 2	Allocated
'SharpSharp Buffer to Buffer'	29.899	285.7143	285.7143	285.7143	80.35 KB
'SharpSharp File to File'	24.118	-	-	-	14.98 KB
'SkiaSharp Buffer to Buffer'	12.896	142.8571	-	-	1023.77 KB
'SkiaSharp File to File'	12.287	142.8571	-	-	965.14 KB
'ImageSharp Buffer to Buffer'	9.236	-	-	-	368.17 KB
'ImageSharp File to File'	8.869	-	-	-	53.55 KB
'FreeImage Buffer to Buffer'	6.595	1000.0000	1000.0000	1000.0000	189.62 KB
'FreeImage File to File'	6.092	1000.0000	1000.0000	1000.0000	12.93 KB
'ImageMagick Buffer to Buffer'	3.623	-	-	-	342.49 KB
'ImageMagick File to File'	3.520	-	-	-	17.24 KB

Environment 3

BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19041.685 (2004/?/20H1) Intel Core i7-6700 CPU 3.40GHz (Skylake), 1 CPU, 8 logical and 4 physical cores .NET Core SDK=5.0.101 [Host] : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT Job-QTWRYZ : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT

Runtime=.NET Core 5.0

Results 3

Method	Op/s	Gen 0	Gen 1	Gen 2	Allocated
'SharpSharp Buffer to Buffer'	30.968	312.5000	312.5000	312.5000	80.36 KB
'SharpSharp File to File'	28.186	-	-	-	14.98 KB
'SkiaSharp File to File'	14.951	166.6667	-	-	964.02 KB
'SkiaSharp Buffer to Buffer'	13.485	125.0000	-	-	1023.77 KB
'ImageSharp Buffer to Buffer'	9.100	-	-	-	368.17 KB
'ImageSharp File to File'	8.841	-	-	-	53.55 KB
'FreeImage Buffer to Buffer'	6.907	1000.0000	1000.0000	1000.0000	189.62 KB
'FreeImage File to File'	6.435	1000.0000	1000.0000	1000.0000	12.63 KB
'ImageMagick File to File'	3.646	-	-	-	17.24 KB
'ImageMagick Buffer to Buffer'	3.642	-	-	-	342.49 KB

Format benchmark

Task

Decompress a 2725x2225 JPEG image, resize to 720x588 and save to various formats with default settings..

Environment 1

BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19041.685 (2004/?/20H1) Intel Core i7-2600K CPU 3.40GHz (Sandy Bridge), 1 CPU, 8 logical and 4 physical cores .NET Core SDK=5.0.101 [Host] : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT Job-YJAIQO : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT

Runtime=.NET Core 5.0

Results 1 (AVIF and HEIF pending)

Method	Op/s	Gen 0	Gen 1	Gen 2	Allocated
GIF	183.194	-	-	-	11354 B
TIFF	20.660	-	-	-	15720 B
JPEG	20.410	-	-	-	15352 B
PNG	8.204	-	-	-	19062 B
WEBP	5.866	-	-	-	15920 B
HEIF	0.4461	-	-	-	13.95 KB
AVIF	0.4276	-	-	-	14 KB

Environment 2

BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19041.685 (2004/?/20H1) Intel Core i7-7820HQ CPU 2.90GHz (Kaby Lake), 1 CPU, 8 logical and 4 physical cores .NET Core SDK=5.0.101 [Host] : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT Job-QMWACN : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT

Runtime=.NET Core 5.0

Results 2

Method	Op/s	Gen 0	Gen 1	Gen 2	Allocated
GIF	182.3506	-	-	-	11.09 KB
TIFF	24.9918	-	-	-	15.34 KB
JPEG	24.6381	-	-	-	14.98 KB
PNG	8.8674	-	-	-	18.8 KB
WEBP	7.0807	-	-	-	15.82 KB
AVIF	0.6922	-	-	-	13.95 KB
HEIF	0.6887	-	-	-	13.95 KB

Environment 3

BenchmarkDotNet=v0.12.1, OS=Windows 10.0.19041.685 (2004/?/20H1) Intel Core i7-6700 CPU 3.40GHz (Skylake), 1 CPU, 8 logical and 4 physical cores .NET Core SDK=5.0.101 [Host] : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT Job-MYZDAX : .NET Core 5.0.1 (CoreCLR 5.0.120.57516, CoreFX 5.0.120.57516), X64 RyuJIT

Runtime=.NET Core 5.0

Results 3

Method	Op/s	Gen 0	Gen 1	Gen 2	Allocated
GIF	322.0173	-	-	-	11.09 KB
TIFF	29.9507	-	-	-	15.34 KB
JPEG	28.9455	-	-	-	14.98 KB
PNG	11.3418	-	-	-	18.8 KB
WEBP	8.7249	-	-	-	15.6 KB
AVIF	0.8318	-	-	-	15.15 KB
HEIF	0.8312	-	-	-	13.95 KB

Name		Name	Last commit message	Last commit date
Latest commit History 83 Commits
.github		.github
SharpSharp.Benchmarks		SharpSharp.Benchmarks
SharpSharp.Tests		SharpSharp.Tests
SharpSharp		SharpSharp
docs		docs
.gitignore		.gitignore
LICENSE		LICENSE
NuGet.config		NuGet.config
README.md		README.md
SharpSharp.sln		SharpSharp.sln
SharpSharp.sln.DotSettings		SharpSharp.sln.DotSettings

License

randyridge/sharpsharp

Folders and files

Latest commit

History

Repository files navigation

SharpSharp

Install

Examples

Resize and save to various formats with default values

Result file sizes (in bytes)

Result images

Input from URL

Benchmarks

Sharp's benchmark (sharp's benchmark)

Task

Contenders

Environment 1

Results 1

Environment 2

Results 2

Environment 3

Results 3

Format benchmark

Task

Environment 1

Results 1 (AVIF and HEIF pending)

Environment 2

Results 2

Environment 3

Results 3

About

Resources

License

Stars

Watchers

Forks

Languages