sixlabors - SixLabors.ImageSharp 1.0.0-unstable0605

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

PM> Install-Package SixLabors.ImageSharp -Version 1.0.0-unstable0605 -Source https://www.myget.org/F/sixlabors/api/v3/index.json

Copy to clipboard

> nuget.exe install SixLabors.ImageSharp -Version 1.0.0-unstable0605 -Source https://www.myget.org/F/sixlabors/api/v3/index.json

Copy to clipboard

> dotnet add package SixLabors.ImageSharp --version 1.0.0-unstable0605 --source https://www.myget.org/F/sixlabors/api/v3/index.json

Copy to clipboard
<PackageReference Include="SixLabors.ImageSharp" Version="1.0.0-unstable0605" />
Copy to clipboard
source https://www.myget.org/F/sixlabors/api/v3/index.json

nuget SixLabors.ImageSharp  ~> 1.0.0-unstable0605
Copy to clipboard

> choco install SixLabors.ImageSharp --version 1.0.0-unstable0605 --source https://www.myget.org/F/sixlabors/api/v2

Copy to clipboard
Import-Module PowerShellGet
Register-PSRepository -Name "sixlabors" -SourceLocation "https://www.myget.org/F/sixlabors/api/v2"
Install-Module -Name "SixLabors.ImageSharp" -RequiredVersion "1.0.0-unstable0605" -Repository "sixlabors" -AllowPreRelease
Copy to clipboard

SixLabors.ImageSharp
SixLabors.ImageSharp

Build Status Code coverage GitHub license Gitter Twitter OpenCollective OpenCollective

Designed to democratize image processing, ImageSharp brings you an incredibly powerful yet beautifully simple API.

Compared to System.Drawing we have been able to develop something much more flexible, easier to code against, and much, much less prone to memory leaks. Gone are system-wide process-locks; ImageSharp images are thread-safe and fully supported in web environments.

Built against .NET Standard 1.3, ImageSharp can be used in device, cloud, and embedded/IoT scenarios.

Documentation

For all SixLabors projects, including ImageSharp: https://sixlabors.github.io/docs/

Installation

Install stable releases via Nuget; development releases are available via MyGet.

Package Name Release (NuGet) Nightly (MyGet)
SixLabors.ImageSharp NuGet MyGet

Packages

The ImageSharp library is made up of multiple packages:

  • SixLabors.ImageSharp
    • 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

Questions?

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.

API

Our API is designed to be simple to consume. 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+

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.PixelFormats;

// Image.Load(string path) is a shortcut for our default type. 
// Other pixel formats use Image.Load<TPixel>(string path))
using (Image 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.
}

Setting individual pixel values can be performed as follows:

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;

// Individual pixels
using (var 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.

For more examples check out:

Manual build

If you prefer, you can compile ImageSharp yourself (please do and help!)

Alternatively, you can work from command line and/or with a lightweight editor on both Linux/Unix and Windows:

To clone ImageSharp locally, click the "Clone in [YOUR_OS]" button above or run the following git commands:

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

If working with Windows please ensure that you have enabled log file paths in git (run as Administrator).

git config --system core.longpaths true

Submodules

This repository contains git submodules. To add the submodules to the project, navigate to the repository root and type:

git submodule update --init --recursive

How can you help?

Please... Spread the word, contribute algorithms, submit performance improvements, unit tests, no input is too little. Make sure to read our Contribution Guide before opening a PR.

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]

  • .NETFramework 4.7.2
    • Microsoft.Net.Compilers.Toolset (>= 3.3.1)
    • System.Buffers (>= 4.5.0)
    • System.Memory (>= 4.5.3)
    • System.Numerics.Vectors (>= 4.5.0)
  • .NETStandard 1.3
    • Microsoft.Net.Compilers.Toolset (>= 3.3.1)
    • NETStandard.Library (>= 1.6.1)
    • System.Buffers (>= 4.5.0)
    • System.IO.Compression (>= 4.3.0)
    • System.IO.UnmanagedMemoryStream (>= 4.3.0)
    • System.Memory (>= 4.5.3)
    • System.Numerics.Vectors (>= 4.5.0)
    • System.Threading.Tasks.Parallel (>= 4.3.0)
    • System.ValueTuple (>= 4.5.0)
  • .NETCoreApp 2.1
    • Microsoft.Net.Compilers.Toolset (>= 3.3.1)
    • System.Runtime.CompilerServices.Unsafe (>= 4.7.0)
  • .NETCoreApp 3.1
    • Microsoft.Net.Compilers.Toolset (>= 3.3.1)
  • .NETStandard 2.0
    • Microsoft.Net.Compilers.Toolset (>= 3.3.1)
    • System.Buffers (>= 4.5.0)
    • System.Memory (>= 4.5.3)
    • System.Numerics.Vectors (>= 4.5.0)
  • .NETStandard 2.1
    • Microsoft.Net.Compilers.Toolset (>= 3.3.1)
    • System.Buffers (>= 4.5.0)
    • System.Memory (>= 4.5.3)
    • System.Numerics.Vectors (>= 4.5.0)
  • .NETCoreApp 2.1: 2.1.0.0
  • .NETCoreApp 3.1: 3.1.0.0
  • .NETFramework 4.7.2: 4.7.2.0
  • .NETStandard 1.3: 1.3.0.0
  • .NETStandard 2.0: 2.0.0.0
  • .NETStandard 2.1: 2.1.0.0

Owners

Six Labors

Authors

Six Labors and contributors

Project URL

https://github.com/SixLabors/ImageSharp

License

Apache-2.0

Tags

Image Resize Crop Gif Jpg Jpeg Bitmap Png Core

Info

22 total downloads
1 downloads for version 1.0.0-unstable0605
Download (3.25 MB)
Found on the current feed only

Package history

Version Size Last updated Downloads Mirrored?
1.0.0-unstable0605 3.25 MB Tue, 28 Jan 2020 10:57:50 GMT 1
1.0.0-unstable0598 3.25 MB Mon, 27 Jan 2020 22:18:57 GMT 1
1.0.0-unstable0591 3.24 MB Mon, 27 Jan 2020 01:22:15 GMT 0
1.0.0-unstable0576 3.24 MB Sun, 26 Jan 2020 02:25:38 GMT 0
1.0.0-unstable0572 3.24 MB Sun, 26 Jan 2020 02:06:43 GMT 0
1.0.0-unstable0567 3.24 MB Sat, 25 Jan 2020 09:07:21 GMT 1
1.0.0-unstable0542 3.24 MB Mon, 20 Jan 2020 10:41:46 GMT 15
1.0.0-unstable0001 3.16 MB Sat, 18 Jan 2020 03:13:10 GMT 4