back Gallery

imageprocessor
Total download count:
101088


Readonly

imageprocessor

Connect to feedNightly builds for the ImageProcessor library.

ImageProcessorCore

ImageProcessorCore is a new cross-platform 2D graphics API designed to allow the processing of images without the use of System.Drawing. It's still in early stages but progress has been pretty quick.

Build status ![Gitter](https://badges.gitter.im/Join Chat.svg)

For the older ImageFactory based API that uses System.Drawing please check out the Framework branch.


ImageProcessor Needs Your Help

ImageProcessor is the work of a very, very, small number of developers who struggle balancing time to contribute to the project with family time and work commitments. If the project is to survive we need more contribution from the community at large. There are several issues, most notably #264 and #347 that we cannot possibly solve on our own.

We, and we believe many others in the community at large want a first-class 2D imaging library with a simple API that is not simply a wrapper round an existing library. We want it to have a low contribution bar which we believe can only happen if the library is written in C#. We want it to be written to cover as many use cases as possible. We want to write the same code once and have it work on any platform supporting .NET Core.

With your help we can make all that a reality.

If you can donate any time to improve on the project, be it helping with documentation, tests or contributing code please do.

Thankyou for reading this

Installation

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.

Manual build

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

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

git clone https://github.com/JimBobSquarePants/ImageProcessor

###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: TrueColor, Grayscale, Indexed. Write: True color, Indexed just now)
  • Gif (Includes animated)
  • Tiff
  • Quantizers (IQuantizer with alpha channel support + thresholding)
  • Octree
  • Xiaolin Wu
  • Palette
  • Basic color structs with implicit operators. Vector backed. #260
  • Color - Float based, premultiplied alpha, No limit to r, g, b, a values allowing for a fuller color range.
  • 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, Performance improvements?)
  • Box
  • Bicubic
  • Lanczos3
  • Lanczos5
  • Lanczos8
  • MitchelNetravali
  • Nearest Neighbour
  • Robidoux
  • Robidoux Sharp
  • Robidoux Soft
  • Spline
  • Triangle
  • Welch
  • Cropping
  • Rectangular Crop
  • Elliptical Crop
  • Entropy Crop
  • Rotation/Skew
  • Flip (90, 270, FlipType etc)
  • Rotate by angle and center point.
  • Skew by x/y angles and center point.
  • ColorMatrix operations (Uses Matrix4x4)
  • BlackWhite
  • Greyscale BT709
  • Greyscale BT601
  • Hue
  • Saturation
  • Lomograph
  • Polaroid
  • Kodachrome
  • Sepia
  • Achromatomaly
  • Achromatopsia
  • Deuteranomaly
  • Deuteranopia
  • Protanomaly
  • Protanopia
  • Tritanomaly
  • Tritanopia
  • Edge Detection
  • Kayyali
  • Kirsch
  • Laplacian3X3
  • Laplacian5X5
  • LaplacianOfGaussian
  • Prewitt
  • RobertsCross
  • Scharr
  • Sobel
  • Blurring/Sharpening
  • Gaussian blur
  • Gaussian sharpening
  • Box Blur
  • Filters
  • Alpha
  • Contrast
  • Invert
  • BackgroundColor
  • Brightness
  • Pixelate
  • Blend
  • Mask
  • Vignette
  • Glow
  • Threshold
  • Effects
  • Path brush (Need help) #264
  • Pattern brush (Need help) #264
  • Elliptical brush (Need help) #264
  • Gradient brush (vignette? Need help) #264
  • Metadata
  • EXIF (In progress but there's a lot of quirks in parsing EXIF. #78)
  • Other stuff I haven't thought of.

###What might never happen

  • Font support (Depends on new System.Text stuff) I don't know where to start coding this so if you have any pointers please chip in.

###API Changes

With this version the API will change dramatically. 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 proces locks with Images and processors thread safe usable in parallel processing utilizing all the availables cores.

Image methods are also fluent which allow chaining much like the ImageFactory class in the Framework version.

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

using (FileStream stream = File.OpenRead("foo.jpg"))
using (FileStream output = File.OpenWrite("bar.jpg"))
using (Image image = new Image(stream))
{
    image.Resize(image.Width / 2, image.Height / 2)
         .Greyscale()
         .Save(output);
}

It will also be possible to pass collections of processors as params to manipulate images. For example here I am applying a Gaussian blur with a sigma of 5 to an image, then detecting the edges using a Sobel operator working in greyscale mode.

using (FileStream stream = File.OpenRead("foo.jpg"))
using (FileStream output = File.OpenWrite("bar.jpg"))
using (Image image = new Image(stream))
{
    List<IImageProcessor> processors = new List<IImageProcessor>()
    {
        new GuassianBlur(5),
        new Sobel { Greyscale = true }
    };

    foreach (IImageProcessor processor in processors){

        image.Process(processor)
             .Save(output);
    }
}

Individual processors can be initialised and apply processing against images. This allows nesting which will allow the powerful combination of processing methods:

new Brightness(50).Apply(sourceImage, targetImage, sourceImage.Bounds);

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

###How can you help?

Please... Spread the word, contribute algorithms, submit performance improvements, unit tests. Help me set up CI for nightly releases.

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.

###The ImageProcessor Team

Grand High Eternal Dictator

Core Team

Read more...