Egami

<h1><img src="https://cloud.githubusercontent.com/assets/5456665/22825566/32aee512-efb8-11e6-989c-184dc53dc29e.png" height=24px width=auto/> Egami</h1>

A Light Weight Image Processing Library

Implements various base image processing algorithms, ranging from image enhancement and filtering to feature extraction; specially suitable for small projects.

How to Use?

1. Download Egami.jar, and integrate it in your project's build path.
2. Here is a simple demonstration-

	public static void main(String[] args) {
		String desktop =  System.getenv("SystemDrive") + System.getenv("HOMEPATH") + "\\Desktop\\";
		String inputImageFilePath = desktop + "in.png";
		String outputImageFilePath = desktop + "out.png";
		
		// Reading input image. 
		// Matrix is the class that contains the whole image object.
		// Here we are sending the image file path and image type for
		// loading the image.
		System.out.println("Reading...");
		Matrix matrix = new Matrix(inputImageFilePath, Matrix.BLACK_WHITE);
		
		// Here we are running a filter on the input image. The filter
		// will detect edge of the input image.
		System.out.println("Filtering...");
		matrix = ConvolutionRunner.applyMask(matrix, ConvolutionRunner.getEdgeFilter(), true);
		
		// Writing output image on the disk.
		System.out.println("Writing...");
		matrix.write(outputImageFilePath);
	}

You will find some simple implementations in the test section. You will also get a nice insight of the project from- AlphabetRecognizer and DeepGenderRecognizer, which are built with Egami.

Demonstration

There are many things, can be done by Egami-

<div align="center"> <img src="https://cloud.githubusercontent.com/assets/5456665/16388430/f57759c8-3cba-11e6-96e6-2561859d2235.png" height="120" width=auto title="Histogram Equalization"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16388431/f5a5a58a-3cba-11e6-8efb-8e45b9a4641f.png" height="120" width=auto title="Local Binary Pattern"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16388428/f53ec8e2-3cba-11e6-99c7-074139d6e38d.png" height="120" width=auto title="Quantization"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16490226/84cae202-3efa-11e6-91d6-f3035eea2457.png" height="120" width=auto title="Rotated by 60 deg"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16490227/84cd7e90-3efa-11e6-9335-e1c9fc0a32c3.png" height="120" width=auto title="Skew by 30 deg"/> </div>

Color-Space Conversions-

<div align="center"> <img src="https://cloud.githubusercontent.com/assets/5456665/16493934/40edf506-3f09-11e6-971c-5579501b1856.jpg" height="100" width=auto title="Actual Image"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16493940/410bf3d0-3f09-11e6-976a-66a48a5148a2.png" height="100" width=auto title="Y Transformation"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16493939/4107a7a8-3f09-11e6-972b-3b51a6727cf1.png" height="100" width=auto title="Cb Transformation"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16493937/40f7fed4-3f09-11e6-86f0-f492df1febef.png" height="100" width=auto title="Value Transformation"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16493938/40f92048-3f09-11e6-970c-13ebdb582c1b.png" height="100" width=auto title="Saturation Transformation"/> <img src="https://cloud.githubusercontent.com/assets/5456665/16493936/40f4a8ce-3f09-11e6-8d28-df37884d9b6d.png" height="100" width=auto title="Lightness Transformation"/> </div>

Segmentation-

<div align="center"> <img src="https://cloud.githubusercontent.com/assets/5456665/18299435/a2a02df0-74e2-11e6-9dc1-dcfdc87906a3.jpg" height="130" width=auto title="Actual Image"/> <img src="https://cloud.githubusercontent.com/assets/5456665/18299437/a2a59f2e-74e2-11e6-9b5b-b6ce0174feee.png" height="130" width=auto title="K-Means Cluster"/> <img src="https://cloud.githubusercontent.com/assets/5456665/18299436/a2a50a32-74e2-11e6-9374-6a84ad9368cb.png" height="130" width=auto title="Mean Shift Cluster"/> </div>

Releases

• <a href="https://github.com/MinhasKamal/Egami/blob/release/Egami-V0.1.jar?raw=true">Version 0.1</a> - Release Date: 10 Oct 2016

License

<a rel="license" href="https://opensource.org/licenses/MIT"><img alt="MIT License" src="https://cloud.githubusercontent.com/assets/5456665/18950087/fbe0681a-865f-11e6-9552-e59d038d5913.png" width="60em" height=auto/></a><br/><a href="https://github.com/MinhasKamal/Egami">Egami</a> is licensed under <a rel="license" href="https://opensource.org/licenses/MIT">MIT License</a>.