Home / .NET / Graphics

:camera: A modern, cross-platform, 2D Graphics library for .NET

SixLabors.ImageSharp ImageSharp is a new, fully featured, fully managed, cross-platform, 2D graphics API. ImageSharp is a new, fully featured, fully managed, cross-platform, 2D graphics library. Designed
Information
Category: .NET / Graphics
Watchers: 182
Star: 6.7k
Fork: 816
Last update: Sep 19, 2023
Resource links
https://github.com/SixLabors/ImageSharp
Popular

SixLabors.ImageSharp
SixLabors.ImageSharp

Build Status Code coverage License: Apache 2.0 Twitter

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

ImageSharp is a new, fully featured, fully managed, cross-platform, 2D graphics library. Designed to simplify image processing, ImageSharp brings you an incredibly powerful yet beautifully simple API.

ImageSharp is designed from the ground up to be flexible and extensible. The library provides API endpoints for common image processing operations and the building blocks to allow for the development of additional operations.

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

License

Documentation

  • Detailed documentation for the ImageSharp API is available. This includes additional conceptual documentation to help you get started.
  • Our Samples Repository is also available containing buildable code samples demonstrating common activities.

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.

Installation

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

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

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

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

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]

50 Open More issues
Closed

Implement pluggable memory management

Problem

  • In some use cases the default ArrayPool behavior does not fit user needs (see #222). Users should be able to configure + reset + disable pools.
  • Some users may want to back Image<T> by memory resources other than managed memory. (Eg. native buffers).

Solution

Implement a pluggable MemoryManager, make the default pooling memory manager configurable.

Update: feature/memory-manager is the WIP branch for this refactor. It's having #431 merged. If anyone wishes to contribute, please file your PR-s against that branch. The tasks below are being updated according to the progress on that branch.

Tasks for beta-3

  • [x] Refactor all raw ArrayPool and PixelDataPool usages to use Buffer and Buffer2D instead.
  • [x] Buffer2D<T> should compose Buffer<T> (as IBuffer<T>) instead of inheriting it
  • [x] Move the responsibility of providing Buffer<T> instances to a generic MemoryManager class. Refactor all new Buffer<T> and new Buffer2D<T> instantiations to call factory method on MemoryManager instead.
  • [x] We need to cover all the encoders/decoders with proper regression tests before continuing the refactor work. (Working on this - would be filed as a separate PR)
  • [x] Extensive test coverage for ArrayPoolMemoryManager
  • [x] Allocations in DefaultPixelBlenders<TPixel> should use MemoryManager taken from the outside
  • [x] Replace the legacy PixelArea<TPixel> class with BufferArea<T> + extensions methods working on BufferArea<TPIxel> and/or IBuffer2D<TPixel> using PixelOperations<TPixel>
  • [x] Replace ~all~ most PixelAccessor<TPixel> usages with Buffer2D<T>. ~Drop the IBuffer2D<T> interface.~ - the full removal could be done later.
  • [x] MemoryManager should construct IBuffer<T> and IManagedByteBuffer instead of Buffer<T>, codecs should use IManagedByteBuffer.Array
  • [x] Based on user feedback, there also might be some strange, unexpected leaking when images are created/destroyed continously. Doing some load testing, identifying+understanding this behavior is inevitable!

Probably 1.0

  • [x] Passing custom MemoryManager to codecs

Most likely post- 1.0:

  • [ ] Passing custom MemoryManager to Mutate() and Clone() (---> #650)
  • [x] Investigate new System.Memory API-s: Memory<T> and OwnedMemory<T>. Find a way to integrate these classes into ImageSharp.Memory.
  • [x] Image.Wrap<T>(Memory<T> memory) or similar
  • [ ] Implement an MMFMemoryManager which uses Memory Mapped Files to reduce the pressure on system memory when processing large images.
help needed up-for-grabs 
opened May 25, 2017 by antonfirsov 79
Closed

Jpeg downscaling decoding

Prerequisites

  • [x] I have written a descriptive pull-request title
  • [x] I have verified that there are no overlapping pull-requests open
  • [x] I have verified that I am following the existing coding patterns and practice as demonstrated in the repository. These follow strict Stylecop rules :cop:.
  • [x] I have provided test coverage for my change (where applicable)

TODO

  • [x] API
  • [x] 1/2 scaling implementation
  • [x] 1/4 scaling implementation
  • [x] Fix resulting image size remainder artifacts
  • [x] Rollback ProfilingSandbox/Program.cs

Description

This PR implements built-in scaling of the Jpeg decoder via scaled IDCT. Currently only 8-to-8 and 8-to-1 (1/8) scalings are supported, I'll implement 1/2 and 1/4 scalings as part of this PR a bit later. Current code is rather stable in terms of internal API, 1/2 and 1/4 scaling will be based on implemented abstract class.

This code is WIP, contains development leftovers.

API

I'm proposing two new methods for the IImageDecoder interface:

/// <summary>
/// Decodes the image from specified stream to an <see cref="Image"/> with specified size.
/// </summary>
/// <typeparam name="TPixel">The pixel format.</typeparam>
/// <param name="configuration">The configuration for the image.</param>
/// <param name="stream">The <see cref="Stream"/> containing image data.</param>
/// <param name="targetSize">Target size of the output image.</param>
/// <param name="resampler">Resampler used for resizing.</param>
/// <param name="cancellationToken">The token to monitor for cancellation requests.</param>
/// <returns>The <see cref="Image"/>.</returns>
Image<TPixel> DecodeInto<TPixel>(Configuration configuration, Stream stream, Size targetSize, IResampler resampler, CancellationToken cancellationToken)
    where TPixel : unmanaged, IPixel<TPixel>;

Image DecodeInto(Configuration configuration, Stream stream, Size targetSize, IResampler resampler, CancellationToken cancellationToken);

And new method to the Image<TPixel>:

// same docs as for DecodeInto above
public static Image<TPixel> LoadInto<TPixel>(Stream stream, Size targetSize, IResampler resampler, IImageDecoder decoder)
    where TPixel : unmanaged, IPixel<TPixel>
    {}

I've certainly missed other endpoints affected by proposed new API, reason for this proposal is to start a discussion :)

Why are new methods needed? For code versatility. As ImageSharp already supports quite some image formats I'd expect this piece of code to be very popular:

using var img = Image.Load(input);
img.Mutate(ctx => ctx.Resize(thumbnailSize));
img.Save(output);

To use new Jpeg resizing API users would need to somehow identify image format first and only then call it directly parsing image stream twice. Proposed API eliminates this performance loss:

using var img = Image.LoadInto(input, thumbnailSize);
img.Save(output);

Benchmarks

Master | Method | Threads | Mean | Error | StdDev | Ratio | |----------------------------- |-------- |-----------:|------------:|----------:|------:| | SystemDrawing | 1 | 3,728.3 ms | 2,858.88 ms | 156.70 ms | 2.25 | | ImageSharp | 1 | 1,654.3 ms | 204.45 ms | 11.21 ms | 1.00 | | Magick | 1 | 4,040.4 ms | 210.98 ms | 11.56 ms | 2.44 | | MagicScaler | 1 | 888.4 ms | 165.17 ms | 9.05 ms | 0.54 | | SkiaBitmap | 1 | 2,873.0 ms | 135.61 ms | 7.43 ms | 1.74 | | SkiaBitmapDecodeToTargetSize | 1 | 888.0 ms | 108.37 ms | 5.94 ms | 0.54 | | NetVips | 1 | 805.6 ms | 163.64 ms | 8.97 ms | 0.49 | | | | | | | | | SystemDrawing | 8 | 1,246.6 ms | 565.78 ms | 31.01 ms | 2.82 | | ImageSharp | 8 | 442.8 ms | 341.56 ms | 18.72 ms | 1.00 | | Magick | 8 | 1,082.2 ms | 172.97 ms | 9.48 ms | 2.45 | | MagicScaler | 8 | 346.6 ms | 164.54 ms | 9.02 ms | 0.78 | | SkiaBitmap | 8 | 746.7 ms | 176.11 ms | 9.65 ms | 1.69 | | SkiaBitmapDecodeToTargetSize | 8 | 235.5 ms | 41.48 ms | 2.27 ms | 0.53 | | NetVips | 8 | 232.3 ms | 71.85 ms | 3.94 ms | 0.53 |

This PR | Method | Threads | Mean | Error | StdDev | Ratio | |----------------------------- |-------- |-----------:|----------:|---------:|------:| | SystemDrawing | 1 | 3,600.3 ms | 534.99 ms | 29.32 ms | 3.22 | | ImageSharp | 1 | 1,116.5 ms | 126.91 ms | 6.96 ms | 1.00 | | Magick | 1 | 4,034.3 ms | 243.95 ms | 13.37 ms | 3.61 | | MagicScaler | 1 | 890.1 ms | 20.20 ms | 1.11 ms | 0.80 | | SkiaBitmap | 1 | 2,912.9 ms | 353.28 ms | 19.36 ms | 2.61 | | SkiaBitmapDecodeToTargetSize | 1 | 890.6 ms | 81.24 ms | 4.45 ms | 0.80 | | NetVips | 1 | 803.1 ms | 99.84 ms | 5.47 ms | 0.72 | | | | | | | | | SystemDrawing | 8 | 1,396.3 ms | 471.21 ms | 25.83 ms | 4.41 | | ImageSharp | 8 | 316.8 ms | 32.03 ms | 1.76 ms | 1.00 | | Magick | 8 | 1,164.4 ms | 636.66 ms | 34.90 ms | 3.68 | | MagicScaler | 8 | 356.2 ms | 278.55 ms | 15.27 ms | 1.12 | | SkiaBitmap | 8 | 732.9 ms | 142.91 ms | 7.83 ms | 2.31 | | SkiaBitmapDecodeToTargetSize | 8 | 236.7 ms | 44.69 ms | 2.45 ms | 0.75 | | NetVips | 8 | 232.9 ms | 128.47 ms | 7.04 ms | 0.74 |

enhancement formats:jpeg 
opened Mar 26, 2022 by br3aker 74
Closed

WebP Support

There appears to be no clear statement, regarding if WebP Encoding / Decoding will be added at any point in time. The only references to "WebP" i could find, was https://github.com/JimBobSquarePants/ImageSharp/issues/11#issuecomment-257134950, which i don't know if it holds any value.

WebP support isn't listed in anywhere meaningful like #10 (Codecs) or an unchecked item in Features like Tiff support is.

help needed up-for-grabs area:formats formats:webp 
opened Mar 4, 2017 by KuroThing 68
Closed

Speed. Hot nasty bad-ass speed!

From @JimBobSquarePants on March 16, 2016 9:44

We've got a pretty good feature set for a V1 release.

Now we need to make it fast.

Things to look at:

  • Reducing array allocation ArrayPool, Slice<T>
  • Unsafe code where applicable
  • Moar SIMD
  • Algorithmic tightening
  • Reduce pixel looping
  • Other things

For benchmarking we can use BenchMarkDotNet now that the prerelease supports CoreFX

i-wanna-go-fast-ricky-bobby

Add your thoughts below.

Copied from original issue: JimBobSquarePants/ImageProcessor#347

enhancement area:performance help needed 
opened Oct 30, 2016 by JimBobSquarePants 60
Closed

.Net 5.0 RC-1 breaks ImageSharp

Prerequisites

  • [x] I have written a descriptive issue title
  • [x] I have verified that I am running the latest version of ImageSharp
  • [x] I have verified if the problem exist in both DEBUG and RELEASE mode
  • [x] I have searched open and closed issues to ensure it has not already been reported

Description

I've encountered a strange bug when mutating images after migrating mvc app from net fw48 to net5 rc1. I've swapped to async image handling. Steps I do (async action on a controller):

1) await HttpContext.Request.ReadFormAsync()
2) Image<Rgba32> img = Image.Load<Rgba32>([first image from form].OpenReadStream(), out IImageFormat imgFormat);
3) await img.SaveAsync("some path"); // saves the image correctly
4) img.Mutate(x => x.Resize(w, h, s)); // thumbnail; used Bicubic, tried Lancoz3 to check if that could be the problem
5) await img.SaveAsync("thumbnail path");

// also tried alternative
5) await using FileStream stream = System.IO.File.Create("some path");
6) await img.SaveAsync(stream, imgFormat);

Extremely frustrating is that this is happening only on production, not on my local machine. I've tried to use another sampler and use latest dev build of ImageSharp, neither helped. In each and every case the first half of an image is mutated correctly, while the other is either blank or filled with artifacts. I'm clueless about how should I move forward, the only option so far would be to go back to sync processing of images which I'd very much like to avoid. Attaching some test images:

Saved thumbnail 1:

a8f3fce0-c6ec-4e4b-a304-ae381301f9ef_thumbnail (1)

Saved non-mutated image 1:

a8f3fce0-c6ec-4e4b-a304-ae381301f9ef

Saved thumbnail 2:

803238f6-8248-4df7-ac73-a0f36840295a_thumbnail

Saved non-mutated image 2:

803238f6-8248-4df7-ac73-a0f36840295a

Saved thumbnail 3:

bc54f22d-1ae8-4135-ad38-3f3e761767f4_thumbnail

Saved non-mutated image 3:

bc54f22d-1ae8-4135-ad38-3f3e761767f4

System Configuration

  • dev: windows 10 20206_rsprerelease, net5 rc1
  • production: windows server 2016 datacenter 10.0.14393, net5 rc1

ImageSharp version:

  • tried 1.1, then 1.0.2 alpha 7
area:build upstream-issue 
opened Sep 16, 2020 by lofcz 58
Closed

.NET Core 2.0.6 Method not found: 'System.Span`1<!!1> System.MemoryExtensions.NonPortableCast(System.Span`1<!!0>)'.

Description

Using an ASP.NET Core 2.0.6 app, I'm getting a thumbnailphoto (bytes array) from our AD and using Image.Load(thumbnailPhoto) to load it in a variable. This produces the error:

"ClassName": "System.MissingMethodException",
    "Message": "Method not found: 'System.Span`1<!!1> System.MemoryExtensions.NonPortableCast(System.Span`1<!!0>)'.",
    "Data": null,
    "InnerException": null,
    "HelpURL": null,
    "StackTraceString": "   at SixLabors.ImageSharp.Memory.ArrayPoolMemoryManager.Buffer`1.get_Span()\r\n   at SixLabors.ImageSharp.Image.<>c__DisplayClass0_0.<InternalDetectFormat>b__0(IImageFormatDetector x)\r\n   at System.Linq.Enumerable.SelectEnumerableIterator`2.MoveNext()\r\n   at System.Linq.Enumerable.TryGetLast[TSource](IEnumerable`1 source, Func`2 predicate, Boolean& found)\r\n   at SixLabors.ImageSharp.Image.InternalDetectFormat(Stream stream, Configuration config)\r\n   at SixLabors.ImageSharp.Image.DiscoverDecoder(Stream stream, Configuration config, IImageFormat& format)\r\n   at SixLabors.ImageSharp.Image.Decode[TPixel](Stream stream, Configuration config)\r\n   at SixLabors.ImageSharp.Image.WithSeekableStream[T](Configuration config, Stream stream, Func`2 action)\r\n   at SixLabors.ImageSharp.Image.Load[TPixel](Configuration config, Stream stream, IImageFormat& format)\r\n   at SixLabors.ImageSharp.Image.Load[TPixel](Configuration config, Byte[] data)\r\n   at SharePointApi.Controllers.AdController.CreateImageThumbnailWithImageSharp(Byte[] thumbnailPhoto, Int32 width, Int32 height) in F:\\dev\\SharePointApi\\SharePointApi\\Controllers\\AdController.cs:line 174\r\n   at SharePointApi.Controllers.AdController.<GetUsersInAdGroup>d__2.MoveNext() in F:\\dev\\SharePointApi\\SharePointApi\\Controllers\\AdController.cs:line 103",
    "RemoteStackTraceString": null,
    "RemoteStackIndex": 0,
    "ExceptionMethod": null,
    "HResult": -2146233069,
    "Source": "SixLabors.ImageSharp",
    "WatsonBuckets": null,
    "MMClassName": null,
    "MMMemberName": null,
    "MMSignature": null
}

It is working however in a .NET Framework 4.5.2 app using the SixLabors.ImageSharp version 1.0.0-beta0002 and SixLabors.Core version 1.0.0-beta0004

Steps to Reproduce

  1. Get a byte array of the thumbnail from AD, saved in the variable: byte[] thumbnailPhoto
  2. Saving the Image in a variable with: using (var image = Image.Load(thumbnailPhoto))
  3. Entering the catch wiht the exception above

System Configuration

  • ImageSharp version: tested both 1.0.0-beta0003 and 1.0.0-dev000956
  • Other ImageSharp packages and versions:
  • Environment (Operating system, version and so on): Windows 10 Enterprise
  • .NET Framework version: Microsoft.NetCore.App: 2.0.6 and Microsoft.AspNetCore.All: 2.0.6
  • Additional information:
opened Mar 28, 2018 by ngoov 56
Open

Bump actions/checkout from 3 to 4

Bumps actions/checkout from 3 to 4.

Release notes

Sourced from actions/checkout's releases.

v4.0.0

What's Changed

New Contributors

Full Changelog: https://github.com/actions/checkout/compare/v3...v4.0.0

v3.6.0

What's Changed

New Contributors

Full Changelog: https://github.com/actions/checkout/compare/v3.5.3...v3.6.0

v3.5.3

What's Changed

New Contributors

Full Changelog: https://github.com/actions/checkout/compare/v3...v3.5.3

v3.5.2

What's Changed

Full Changelog: https://github.com/actions/checkout/compare/v3.5.1...v3.5.2

v3.5.1

What's Changed

New Contributors

... (truncated)

Changelog

Sourced from actions/checkout's changelog.

Changelog

v4.0.0

v3.6.0

v3.5.3

v3.5.2

v3.5.1

v3.5.0

v3.4.0

v3.3.0

v3.2.0

v3.1.0

v3.0.2

v3.0.1

... (truncated)

Commits

Dependabot compatibility score

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

  • @dependabot rebase will rebase this PR
  • @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
  • @dependabot merge will merge this PR after your CI passes on it
  • @dependabot squash and merge will squash and merge this PR after your CI passes on it
  • @dependabot cancel merge will cancel a previously requested merge and block automerging
  • @dependabot reopen will reopen this PR if it is closed
  • @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
  • @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
  • @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
  • @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
  • @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
dependencies 
opened Sep 11, 2023 by dependabot[bot] 0
Open

transparency issues with some .webp images

Prerequisites

  • [X] I have written a descriptive issue title
  • [X] I have verified that I am running the latest version of ImageSharp
  • [X] I have verified if the problem exist in both DEBUG and RELEASE mode
  • [X] I have searched open and closed issues to ensure it has not already been reported

ImageSharp version

3.0.2

Other ImageSharp packages and versions

/

Environment (Operating system, version and so on)

ubuntu 20.04, win 11, ryzen

.NET Framework version

7.0

Description

Most images work fine, but some will replace part of the transparent background with white background (but not all of it, a small rectangle around the image stays transparent).

Here are the results as viewed in an image viewer. Original: image

Result: image

Steps to Reproduce


var img = Image.Load("d:\\bugged_image.webp");
var encoder = new WebpEncoder()
{
    TransparentColorMode = WebpTransparentColorMode.Preserve
};
img.Mutate(t => t.Resize(img.Width/2, img.Height/2));
img.Save("d:\\bugged_image_result.webp");

Images

bugged_image.zip

needs triage 
opened Sep 10, 2023 by Lovrenc 0
Open

[webp]animated webp image became static after processing

Prerequisites

  • [X] I have written a descriptive issue title
  • [X] I have verified that I am running the latest version of ImageSharp
  • [X] I have verified if the problem exist in both DEBUG and RELEASE mode
  • [X] I have searched open and closed issues to ensure it has not already been reported

ImageSharp version

3.0.1

Other ImageSharp packages and versions

SixLabors.ImageSharp.Drawing(1.0.0)

Environment (Operating system, version and so on)

Win10 22H2

.NET Framework version

.NET 6

Description

mathiasbynens.be/demo/animated-webp-supported.webp cannot load animated webp images or save one correctly. Maybe the method I used is wrong. Really appreciate for your work~

Steps to Reproduce

1.download the example image 2.load with code

           using (var imgStream = new MemoryStream())
           {
               await Request.Body.CopyToAsync(imgStream);
               if (imgStream == null || imgStream.Length == 0)
               {
                   return Fail("image can not be null");
               }
              var  buffer = new byte[imgStream.Length];
               imgStream.Position = 0;
               await imgStream.ReadAsync(buffer, 0, buffer.Length);
               //using(Image img=Image.Load(file))  //At first i wrote this line which turned out img.Frames.Count=1
               using (Image img = Image.Load(new DecoderOptions { MaxFrames = 100 }, file))//this way turned out img.Frames.Count=12
               {
                           var filePath= AppContext.BaseDirectory + Guid.NewGuid().ToString() + ".webp";
                           await img.SaveAsync(filePath);
               }
           }

Images

68747470733a2f2f6d61746869617362796e656e732e62652f64656d6f2f616e696d617465642d776562702d737570706f727465642e77656270.zip

needs triage 
opened Aug 29, 2023 by marshafan 0
Open

JPEG. SixLabors.ImageSharp.InvalidImageContentException: 'Input stream does not have enough bytes to parse declared contents of the D7 marker.'

Prerequisites

  • [X] I have written a descriptive issue title
  • [X] I have verified that I am running the latest version of ImageSharp
  • [X] I have verified if the problem exist in both DEBUG and RELEASE mode
  • [X] I have searched open and closed issues to ensure it has not already been reported

ImageSharp version

2.1.1

Other ImageSharp packages and versions

2.1.5

Environment (Operating system, version and so on)

win7, win11

.NET Framework version

4.8

Description

Hello!

I found out by experience that since 2.1.1 on one JPEG file, taken from scanner SixLabors.ImageSharp.Image.Load(PATH_TO_JPEG) throw this:

SixLabors.ImageSharp.InvalidImageContentException: 'Input stream does not have enough bytes to parse declared contents of the D7 marker.'

Steps to Reproduce

using (var image = SixLabors.ImageSharp.Image.Load("C:\\temp\\Scan762.jpg"))

Images

Scan762

needs triage 
opened Aug 23, 2023 by spec1er 2
Open

Expose non-nullable configuration to remove AOT limiting null check

Prerequisites

  • [x] I have written a descriptive pull-request title
  • [x] I have verified that there are no overlapping pull-requests open
  • [x] I have verified that I am following the existing coding patterns and practice as demonstrated in the repository. These follow strict Stylecop rules :cop:.
  • [x] I have provided test coverage for my change (where applicable)

Description

Fixes #2486

As discussed in the linked issue AdvancedImageExtensions.GetConfiguration() causes the AOT compiler to include all image unused formats due to the null check and assignment of Configuration.Default.

Since that null check is unavoidable without an API change, I decided to make it by making IConfigurationProvider public and exposing the property directly.

While developers should be careful to not edit the configuration singleton, I do not consider accessing the configuration an advanced scenario since we already provide means to construct and pass custom configuration to our types.

area:aot breaking 
opened Aug 17, 2023 by JimBobSquarePants 0
Open

APNG support

Prerequisites

  • [x] I have written a descriptive pull-request title
  • [x] I have verified that there are no overlapping pull-requests open
  • [x] I have verified that I am following the existing coding patterns and practice as demonstrated in the repository. These follow strict Stylecop rules :cop:.
  • [x] I have provided test coverage for my change (where applicable)

Description

Implement APNG decoding and encoding based on PNG

opened Aug 12, 2023 by Poker-sang 4

v3.0.2(Aug 29, 2023)

What's Changed

  • Handle EOF in Jpeg bit reader when data is bad to prevent DOS attack. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2516

Full Changelog: https://github.com/SixLabors/ImageSharp/compare/v3.0.1...v3.0.2

v2.1.6(Aug 30, 2023)

What's Changed

  • Backport - Handle EOF in Jpeg bit reader when data is bad to prevent DOS attack. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2524

Full Changelog: https://github.com/SixLabors/ImageSharp/compare/v2.1.5...v2.1.6

v2.1.5(Aug 14, 2023)

What's Changed

  • Backport #2501 by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2509

Full Changelog: https://github.com/SixLabors/ImageSharp/compare/v2.1.4...v2.1.5

v2.1.4(Mar 28, 2023)

What's Changed

  • Backport WebP fix to 2.1 by @antonfirsov in https://github.com/SixLabors/ImageSharp/pull/2420

Full Changelog: https://github.com/SixLabors/ImageSharp/compare/v2.1.3...v2.1.4

v3.0.1(Mar 28, 2023)

What's Changed

  • ISSUE #2385 - Implementing try get pattern to TryFindFormatByFileExtension(string extension, [NotNullWhen(true)] out IImageFormat? format) by @Ollie-Ave in https://github.com/SixLabors/ImageSharp/pull/2386
  • Remove mac specific skips by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2384
  • Add Arm intrinsics to JpegColorConverter RGB by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2397
  • Add arm64 intrinsics for cmyk converter by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2400
  • Low-hanging fruit codegen optimizations by @gfoidl in https://github.com/SixLabors/ImageSharp/pull/2401
  • Webp: Dont use using statement for encodedAlphaData by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2412
  • Fixed wrong division hack by @gfoidl in https://github.com/SixLabors/ImageSharp/pull/2413
  • Port GrayscalConverter to Arm by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2409
  • Fix RgbScalar by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2416

New Contributors

  • @Ollie-Ave made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2386

Full Changelog: https://github.com/SixLabors/ImageSharp/compare/v3.0.0...v3.0.1

v3.0.0(Mar 1, 2023)

What's Changed

  • Use .NET 6 only by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2098
  • Convolution: Border wrapping modes by @ynse01 in https://github.com/SixLabors/ImageSharp/pull/2060
  • Use ReadOnlySpan static data compiler optimization in more places by @turbedi in https://github.com/SixLabors/ImageSharp/pull/2101
  • Add support for decoding jpeg's with arithmetic coding by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2073
  • Replace Array.Clear(array, 0, array.Length) calls with Array.Clear(array) by @turbedi in https://github.com/SixLabors/ImageSharp/pull/2103
  • Preserve color profile when encoding bitmaps by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2108
  • Preserve color profile when encoding webp images by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2109
  • Preserve color profile when encoding PNG images by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2110
  • Add support for decoding webp images with animations by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/1985
  • Jpeg compressed tiff: jpeg decoder should handle the conversion from YCbCr to RGB by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2124
  • Deduce color space as YCbCr if component id's are 1, 2, 3 by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2135
  • Bump actions/checkout from 2 to 3 by @dependabot in https://github.com/SixLabors/ImageSharp/pull/2145
  • Bump actions/setup-dotnet from 1 to 2 by @dependabot in https://github.com/SixLabors/ImageSharp/pull/2143
  • Bump actions/cache from 2 to 3 by @dependabot in https://github.com/SixLabors/ImageSharp/pull/2142
  • Bump actions/upload-artifact from 2 to 3 by @dependabot in https://github.com/SixLabors/ImageSharp/pull/2146
  • Bump codecov/codecov-action from 1 to 3 by @dependabot in https://github.com/SixLabors/ImageSharp/pull/2144
  • Skip invalid markers during jpeg decoding by @br3aker in https://github.com/SixLabors/ImageSharp/pull/2147
  • Tiff: Performance improvements for Fax4 decompression by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2134
  • Fix regression in TIF image loading by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2150
  • Used inline SIMD vectors if they are constants by @gfoidl in https://github.com/SixLabors/ImageSharp/pull/2122
  • Print environment info on tests start by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2175
  • Update License by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2176
  • Jpeg downscaling decoding by @br3aker in https://github.com/SixLabors/ImageSharp/pull/2076
  • Add support for decoding tiff images with CieLab color space by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2127
  • Assembly Trimming Support by @ds5678 in https://github.com/SixLabors/ImageSharp/pull/2160
  • Jpeg color space deduction fix by @br3aker in https://github.com/SixLabors/ImageSharp/pull/2177
  • Add support for decoding tiff with webp compressed data by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2128
  • Fix issue when writing lossy webp with alpha data by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2173
  • Fix run-length encode compression implementation mistake in tga encoder by @l1nxy in https://github.com/SixLabors/ImageSharp/pull/2172
  • TGA Encoder/Decoder Improvements by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2197
  • Tiff: Make sure 1 Bit compression is only used with 1 bit pixel type by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2201
  • Refactor EnumUtils and make it AOT-friendly. by @teo-tsirpanis in https://github.com/SixLabors/ImageSharp/pull/2200
  • Jpeg encoder complete rewrite by @br3aker in https://github.com/SixLabors/ImageSharp/pull/2120
  • Fix IPTC tags written on jpg files that contains non-English characters can't be correctly displayed on external apps #2212 by @lmerino-ep in https://github.com/SixLabors/ImageSharp/pull/2213
  • Identify transparency for indexed PNG correctly by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2215
  • Introduce Shared General Decoder Options plus Specialization by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2180
  • Add option to encode 2-bit Bitmap's by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2220
  • Fix AdaptiveThresholdProcessor throws IndexOutOfRangeException by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2221
  • Relaxed bmp dimensions validation by @smorokin in https://github.com/SixLabors/ImageSharp/pull/2192
  • Remove obsolete code by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2189
  • Implement Median Blur processor by @ynse01 in https://github.com/SixLabors/ImageSharp/pull/2219
  • Make TestFile Image threadsafe. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2225
  • PNG filter improvements by @saucecontrol in https://github.com/SixLabors/ImageSharp/pull/2226
  • Use File-Scoped Namespaces and Global Implicit Usings by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2229
  • Fix for issue #2117 by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2230
  • Use System.Half for HalfTypeHelper by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2233
  • [Chore] Remove InlineningOption from ThrowHelpers by @blouflashdb in https://github.com/SixLabors/ImageSharp/pull/2234
  • Implement AutoLevel processor - Attempt 2 by @ynse01 in https://github.com/SixLabors/ImageSharp/pull/2235
  • Add TryGetLinearlySeparableComponents and tests by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2224
  • Extend row operation interfaces with buffer length method by @ynse01 in https://github.com/SixLabors/ImageSharp/pull/2241
  • Webp: Ignore unknown chunks, fixes #2243 by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2245
  • Fix position handling in BufferedReadStream by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2249
  • Bump actions/setup-dotnet from 2 to 3 by @dependabot in https://github.com/SixLabors/ImageSharp/pull/2252
  • Tiff: Make sure bits per pixel is set to 1 for bilevel compression by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2256
  • Fix issue decoding lossy webp with alpha channel by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2258
  • Add support for decoding tiff images with old jpeg compression by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2266
  • Add support for decoding tiff images with cmyk pixel data by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2268
  • Ensure seekable streams can be read multiple times. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2267
  • Normalize and cleanup encoders by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2269
  • Add support for decoding tiled tiff images by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2290
  • Fix various Gif Decoder/Encoder behaviors. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2289
  • Fix small deviation to the spec when encoding tiff images by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2298
  • Fix decoder cancellation tests by @antonfirsov in https://github.com/SixLabors/ImageSharp/pull/2301
  • Improve Decoder/Encoder symmetry by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2276
  • Enable Nullable by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2282
  • Correct IccProfile comment by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2306
  • Fix GitHub shields by @MarkCiliaVincenti in https://github.com/SixLabors/ImageSharp/pull/2311
  • Add byteLength to WrapMemory by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2313
  • Remove some nullable disable comments by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2312
  • Remove ImageFormat out params and return on Metadata by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2317
  • Removed #nullable disabled by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2319
  • Add DrawImage(Image, Point, Rectangle) method to the DrawImage processor by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2322
  • Allow zero DPI and only throw at EOF when not enough data by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2324
  • Remove nullable disable from zlib by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2325
  • Remove nullable disable from Memory.Allocators by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2327
  • Remove #nullable disable from ExifProfile by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2320
  • Remove nullable disable from ColorSpace and Color by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2326
  • Normalize parameter documentation across all extension methods by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2329
  • Add test images for 2334 by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2335
  • Remove nullable disable from pixelimplementations by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2337
  • Remove nullable disable from Processing.Processors by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2338
  • Added L16 support to tiff encoder by @ptasev in https://github.com/SixLabors/ImageSharp/pull/2339
  • Add BuildJet ARM64 runners. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2341
  • Restrict trigger for ARM to PRs containing labels only by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2343
  • Remove Nullable disable from MetaData.Profiles by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2330
  • Add ARM Intrinsics for PNG filters by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2344
  • Actually call arm methods, if arm is supported by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2349
  • Remove nullable disable from Formats.BMP by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2345
  • remove nullable disable from format gif by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2346
  • remove nullable disable from Format Pbm by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2347
  • Remove nullable disable from format tga by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2348
  • Remove nullable disable from ChunkedMemoryStream by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2352
  • Fix mode score calculation for SSE2/AVX2 version by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2355
  • Allow setting configuration property by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2357
  • Disable preEnumerateTheories for running tests by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2360
  • Add ARM version of calculating mode scores by @brianpopow in https://github.com/SixLabors/ImageSharp/pull/2356
  • Attempt to workaround SDK build changes by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2362
  • Enable Avx2 optimizations on Porter-Duff operations. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2359
  • Remove nullable disable from various files by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2353
  • Replace MyGet with Feedz as our nightly package repository. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2367
  • Use compile time constants over method for all MMShuffle operations. by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2365
  • #2231 First steps for removing nullable disable in webp by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2364
  • Fix and normalize Vector4 UnPremultiply by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2369
  • Rewrite ColorMatrix by @stefannikolei in https://github.com/SixLabors/ImageSharp/pull/2371
  • Automatically push the build to NuGet on a tagged release by @JimBobSquarePants in https://github.com/SixLabors/ImageSharp/pull/2373
  • Support frames metadata for Identify by @IldarKhayrutdinov in https://github.com/SixLabors/ImageSharp/pull/2363

New Contributors

  • @dependabot made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2145
  • @gfoidl made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2122
  • @ds5678 made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2160
  • @l1nxy made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2172
  • @teo-tsirpanis made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2200
  • @lmerino-ep made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2213
  • @smorokin made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2192
  • @blouflashdb made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2234
  • @MarkCiliaVincenti made their first contribution in https://github.com/SixLabors/ImageSharp/pull/2311

Full Changelog: https://github.com/SixLabors/ImageSharp/compare/v2.1.1...v3.0.0

Contents

    SixLabors :camera: A modern, cross-platform, 2D Graphics library for .NET
    DiligentGraphics A modern cross-platform low-level graphics library and rendering framework
    viniciusfbb Skia4Delphi is a cross-platform 2D graphics API for Delphi platforms based on Google's Skia Graphics Library. It provides a comprehensive 2D API that can be used across mobile, server and desktop models to render images.
    dotnet ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.
    sindresorhus Check if the built-in Mac camera is on
    bkaradzic Cross-platform, graphics API agnostic, "Bring Your Own Engine/Framework" style rendering library.
    dotnet Samples for ML.NET, an open source and cross-platform machine learning framework for .NET.
    sandrios Easy integration of camera for image and video capturing with Image Picker.
    xoofx A cross-platform abstract/virtual filesystem framework with many built-ins filesystems for .NET
    sindresorhus Check if the built-in Mac camera is on
    sindresorhus Check if the built-in Mac camera is on
    MethanePowered 🎲 Modern 3D graphics made simple with cross-platform C++17 meta-API on top of DirectX 12 & Metal
    tensorflow TensorFlow Graphics: Differentiable Graphics Layers for TensorFlow
    spritejs Spritejs - A cross platform high-performance graphics system.
    dotnet ML.NET is an open source and cross-platform machine learning framework for .NET.
    atulmish Expansible Unit Conversion Library for .Net Core and .Net Framework
    CameraKit Library for Android Camera 1 and 2 APIs. Massively increase stability and reliability of photo and video capture on all Android devices.
    CameraKit Library for Android Camera 1 and 2 APIs. Massively increase stability and reliability of photo and video capture on all Android devices.
    CameraKit Library for Android Camera 1 and 2 APIs. Massively increase stability and reliability of photo and video capture on all Android devices.
    MiniProfiler A simple but effective mini-profiler for ASP.NET (and Core) websites
    kevalpatel2106 This library is to take picture using camera without camera preview.
    Share this repo

    Related Repos


    Graphics
    230
    Burnt-in barcode metadata camera
    keijiro Bibcam - Burnt-in barcode metadata camera Bibcam is a proof-of-concept project where I tried the idea of "burnt-in barcode metadata" carrying camera t
     
    Graphics
    85
    A fully-dynamic voxel-based global illumination system for Unity.
    ninlilizi Please note that this fork has been discontinued in favour of my own GI solution, Nigiri. https://github.com/ninlilizi/Nigiri NKLI Features. 2D, Singl
     
    Graphics
    1.4k
    Tutorials for making 3D-looking maps with Blender and QGIS
    JoeWDavies Tutorials for making 3D-looking maps with Blender and QGIS
     
    Graphics
    226
    Visualize 3D hyperbolic honeycombs and sphere packings.
    neozhaoliang Visualize 3D hyperbolic honeycombs and sphere packings.
     
    Graphics
    2k
    Node graph editor framework focused on data processing using Unity UIElements and C# 4.6
    alelievr Node graph editor framework focused on data processing using Unity UIElements and C# 4.6
     
    Graphics
    3.8k
    ScottPlot is a free and open-source plotting library for .NET that makes it easy to intera...
    ScottPlot ScottPlot is a free and open-source plotting library for .NET that makes it easy to interactively display large datasets.
     
    Graphics
    115
    AssetRipper is a GUI Application to work with engine assets, asset bundles, and serialized...
    ds5678 AssetRipper is a tool for extracting assets from serialized files (CAB-*, *.assets, *.sharedAssets, etc.) and assets bundles (*.unity3d, *.bundle, etc.) and converting them into the native Unity engine format.
     
    Graphics
    3.1k
    Silk.NET is your one-stop-shop for high-speed .NET multimedia, graphics, and compute; prov...
    dotnet The high-speed OpenGL, OpenCL, OpenAL, OpenXR, GLFW, SDL, Vulkan, Assimp, and DirectX bindings library your mother warned you about.
     
    Graphics
    22
    This asset allows users to view raycasts as the user fires them.
    nomnomab This asset allows users to view raycasts as the user fires them.
     
    Graphics
    3.3k
    Simple, flexible, interactive & powerful charts, maps and gauges for .Net, LiveCharts2 can...
    beto-rodriguez Simple, flexible, interactive & powerful charts, maps and gauges for .Net, LiveCharts2 can now practically run everywhere WPF, WinForms, Xamarin, Avalonia, WinUI, UWP.
     
    Graphics
    14
    Reverse engineered includes to allow for shader development in sbox
    ogniK5377 This is a extremely minimal shader setup to create shaders in s&box. Currently this is not an OFFICIAL way to setup shaders but it works.
     
    Graphics
    38
    A Unity Editor extension for customizing inspector layout with attributes.
    gasgiant A Unity Editor extension for customizing inspector layout with attributes.
     
    Graphics
    15
    F# .NET global tool to grap the first frame of a GIF as a PNG
    khalidabuhakmeh This is a .NET global tool designed to grab the first frame of all GIFs in a given directory. Grabbing the first frame is useful for creating a splash image for websites that don't auto-play animated GIFs. This was also an attempt to learn some F# and build something I would use.
     
    Graphics
    24
    Screenshots a Shader Graph in multiple sections, stitches them together and saves the resu...
    Cyanilux Screenshots a Shader Graph in multiple sections, stitches them together and saves the result as a PNG.
     
    Graphics
    13
    Tools for calibrating cameras and video projectors based on OpenCV.
    cecarlsen A set of tools to make camera and video projector calibration slightly easier in Unity. This is useful for AR/XR and projection mapping setups. It contains two packages: TrackingTools and TrackingTools.KinectAzure.