Skip to content

📷 A cross-platform library for the processing of image files; written in C#

License

Notifications You must be signed in to change notification settings

Latency/ImageSharp

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SixLabors.ImageSharp

ImageSharp
ImageSharp

GitHub license Gitter Twitter OpenCollective OpenCollective

ImageSharp is a new, fully featured, fully managed, cross-platform, 2D graphics API.

Without the use of System.Drawing, a more flexible, less prone to memory leaks, easier to code against, solution has been developed. System-wide process-locks; ImageSharp images are thread-safe and fully supported in web environments.

Built against .Net Standard 1.1-2.0 + .NET Core 2.0 + .NET 4.5-7.1, ImageSharp can be used on almost any device, cloud, and embedded/IoT scenarios.

Questions?

Do you have questions? We are happy to help! Please join our gitter channel, or ask them on stackoverflow using the ImageSharp tag.

Packages

Name Release (NuGet) Build Status License Chat
SixLabors.ImageSharp Download imagesharp-latency MyGet Build Status License Chat

Features

  • Contains the generic Image<TPixel> class, PixelFormats, Primitives, Configuration, and other core functionality.
  • The IImageFormat interface, Jpeg, Png, Bmp, and Gif formats.
  • Transform methods like Resize, Crop, Skew, Rotate - Anything that alters the dimensions of the image.
  • Non-transform methods like Gaussian Blur, Pixelate, Edge Detection - Anything that maintains the original image dimensions.

Upcoming Developments

There's plenty there and more coming. Check out the current features!

API

Here's an example of the code required to resize an image using the default Bicubic resampler then turn the colors into their grayscale equivalent using the BT709 standard matrix.

On platforms supporting netstandard 1.3+

// Image.Load(string path) is a shortcut for our default type. Other pixel formats use Image.Load<TPixel>(string path))
using (Image<Rgba32> image = Image.Load("foo.jpg"))
{
    image.Mutate(x => x
         .Resize(image.Width / 2, image.Height / 2)
         .Grayscale());
    image.Save("bar.jpg"); // automatic encoder selected based on extension.
}

on netstandard 1.1 - 1.2

// Image.Load(Stream stream) is a shortcut for our default type. Other pixel formats use Image.Load<TPixel>(Stream stream))
using (FileStream stream = File.OpenRead("foo.jpg"))
using (FileStream output = File.OpenWrite("bar.jpg"))
using (Image<Rgba32> image = Image.Load<Rgba32>(stream))
{
    image.Mutate(x => x
         .Resize(image.Width / 2, image.Height / 2)
         .Grayscale());
    image.Save(output);
}

Setting individual pixel values can be perfomed as follows:

// Individual pixels
using (Image<Rgba32> image = new Image<Rgba32>(400, 400))
{
    image[200, 200] = Rgba32.White;
}

Rgba32 is our default PixelFormat, equivalent to System.Drawing Color. For advanced pixel format usage there are multiple PixelFormat implementations available allowing developers to implement their own color models in the same manner as Microsoft XNA Game Studio and MonoGame.

All in all this should allow image processing to be much more accessible to developers which has always been my goal from the start.

Check out our Samples Repository for more examples!

Manual build

If you prefer, you can compile ImageSharp yourself (please do and help!), you'll need:

Alternatively on Linux you can use:

To clone it locally click the "Clone in Windows" button above or run the following git commands.

git clone https://github.com/Latency/ImageSharp

How can you help?

Please... Spread the word, contribute algorithms, submit performance improvements, unit tests, no input is too little.

The ImageSharp Team

Grand High Eternal Dictator

Core Team

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

About

📷 A cross-platform library for the processing of image files; written in C#

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%