ImageSharp is a new cross-platform 2D graphics API designed to allow the processing of images without the use of System.Drawing
.
ImageSharp is still in early stages (alpha) but progress has been pretty quick. As such, please do not use on production environments until the library reaches release candidate status. Pre-release downloads are available from the MyGet package repository.
![Gitter](https://badges.gitter.im/Join Chat.svg)
At present the code is pre-release but when ready it will be available on Nuget.
Pre-release downloads
We already have a MyGet package repository - for bleeding-edge / development NuGet releases.
If you prefer, you can compile ImageSharp yourself (please do and help!), you'll need:
- Visual Studio 2015 with Update 3 (or above)
- The .NET Core 1.0 SDK Installer - Non VSCode link.
To clone it locally click the "Clone in Windows" button above or run the following git commands.
git clone https://github.com/JimBobSquarePants/ImageSharp
###What works so far/ What is planned?
- Encoding/decoding of image formats (plugable).
- Jpeg (Includes Subsampling. Progressive writing required)
- Bmp (Read: 32bit, 24bit, 16 bit. Write: 32bit, 24bit just now)
- Png (Read: Rgb, Rgba, Grayscale, Grayscale + alpha, Palette. Write: Rgb, Rgba, Grayscale, Grayscale + alpha, Palette) Needs interlaced decoding
- Gif (Includes animated)
- Tiff
- Metadata
- EXIF Read/Write (Jpeg just now)
- Quantizers (IQuantizer with alpha channel support + thresholding)
- Octree
- Xiaolin Wu
- Palette
- Basic color structs with implicit operators.
- Color - 32bit color in RGBA order.
- BGRA32
- CIE Lab
- CIE XYZ
- CMYK
- HSV
- HSL
- YCbCr
- Basic shape primitives (Vector backed)
- Rectangle (Doesn't contain all System.Drawing methods)
- Size
- Point
- Ellipse
- Resampling algorithms. (Optional gamma correction, resize modes, Performance improvements?)
- Box
- Bicubic
- Lanczos2
- Lanczos3
- Lanczos5
- Lanczos8
- MitchelNetravali
- Nearest Neighbour
- Robidoux
- Robidoux Sharp
- Spline
- Triangle
- Welch
- Padding
- Pad
- ResizeMode.Pad
- ResizeMode.BoxPad
- Cropping
- Rectangular Crop
- Elliptical Crop
- Entropy Crop
- ResizeMode.Crop
- Rotation/Skew
- Flip (90, 270, FlipType etc)
- Rotate by angle and center point (Expandable canvas).
- Skew by x/y angles and center point (Expandable canvas).
- ColorMatrix operations (Uses Matrix4x4)
- BlackWhite
- Grayscale BT709
- Grayscale BT601
- Hue
- Saturation
- Lomograph
- Polaroid
- Kodachrome
- Sepia
- Achromatomaly
- Achromatopsia
- Deuteranomaly
- Deuteranopia
- Protanomaly
- Protanopia
- Tritanomaly
- Tritanopia
- Edge Detection
- Kayyali
- Kirsch
- Laplacian3X3
- Laplacian5X5
- LaplacianOfGaussian
- Prewitt
- RobertsCross
- Robinson
- Scharr
- Sobel
- Blurring/Sharpening
- Gaussian blur
- Gaussian sharpening
- Box Blur
- Filters
- Alpha
- Contrast
- Invert
- BackgroundColor
- Brightness
- Pixelate
- Blend
- Mask
- Oil Painting
- Vignette
- Glow
- Threshold
- Drawing
- Path brush (Need help)
- Pattern brush (Need help)
- Elliptical brush (Need help)
- Gradient brush (vignette? Need help)
- Other stuff I haven't thought of.
- Font support. I don't know where to start coding this so if you have any pointers please chip in.
Without the constraints of System.Drawing
I 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. Images and processors are thread safe usable in parallel processing utilizing all the availables cores.
Many Image
methods are also fluent.
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.
using (FileStream stream = File.OpenRead("foo.jpg"))
using (FileStream output = File.OpenWrite("bar.jpg"))
{
Image image = new Image(stream);
image.Resize(image.Width / 2, image.Height / 2)
.Grayscale()
.Save(output);
}
Individual processors can be initialised and apply processing against images. This allows nesting which brings the potential for powerful combinations of processing methods:
new BrightnessProcessor(50).Apply(sourceImage, sourceImage.Bounds);
Setting individual pixel values is perfomed as follows:
Image image = new Image(400, 400);
using (PixelAccessor<Color, uint> pixels = image.Lock())
{
pixels[200, 200] = Color.White;
}
For advanced usage the Image<TColor, TPacked>
class is 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.
Please... Spread the word, contribute algorithms, submit performance improvements, unit tests.
Performance is a biggie, if you know anything about the new vector types and can apply some fancy new stuff with that it would be awesome.
There's a lot of developers out there who could write this stuff a lot better and faster than I and I would love to see what we collectively can come up with so please, if you can help in any way it would be most welcome and benificial for all.
Grand High Eternal Dictator
Core Team