SixLabors.ImageSharp

[![Build Status](https://img.shields.io/github/actions/workflow/status/SixLabors/ImageSharp/build-and-test.yml?branch=main)](https://github.com/SixLabors/ImageSharp/actions) [![Code coverage](https://codecov.io/gh/SixLabors/ImageSharp/branch/main/graph/badge.svg)](https://codecov.io/gh/SixLabors/ImageSharp) [![License: Six Labors Split](https://img.shields.io/badge/license-Six%20Labors%20Split-%23e30183)](https://github.com/SixLabors/ImageSharp/blob/main/LICENSE) [![Twitter](https://img.shields.io/twitter/url/http/shields.io.svg?style=flat&logo=twitter)](https://twitter.com/intent/tweet?hashtags=imagesharp,dotnet,oss&text=ImageSharp.+A+new+cross-platform+2D+graphics+API+in+C%23&url=https%3a%2f%2fgithub.com%2fSixLabors%2fImageSharp&via=sixlabors)

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 8, ImageSharp can be used in device, cloud, and embedded/IoT scenarios.

License

ImageSharp is licensed under the Six Labors Split License, Version 1.0

Support Six Labors

Support the efforts of the development of the Six Labors projects.

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

Do you have questions? Please join our Discussions Forum. Do not open issues for questions.
For feature ideas please join our Discussions Forum and we'll be happy to discuss.
Please read our Contribution Guide before opening issues or pull requests!

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 (Feedz.io)
`SixLabors.ImageSharp`

Manual build

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

Using Visual Studio 2022
- Make sure you have the latest version installed
- Make sure you have the .NET 8 SDK installed

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

Visual Studio Code with C# Extension
.NET Core

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

Then set the following config to ensure blame commands ignore mass reformatting commits.

git config blame.ignoreRevsFile .git-blame-ignore-revs

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

git config --system core.longpaths true

This repository uses Git Large File Storage. Please follow the linked instructions to ensure you have it set up in your environment.

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.

Useful tools for development and links to specifications can be found in our wikipage: Useful-tools-and-links.

The ImageSharp Team

Special thanks to [JetBrains](https://www.jetbrains.com/?from=ImageSharp) for supporting us with open-source licenses for their IDEs.