An application for applying filters on images. The application is built using a web stack framework such as WebGL, Javascript, HTML5. Imagery is a desktop application, powered by an set of NodeJS frameworks: Electron, React, and Redux.
- Install NodeJS version v4+ LTS.
- Install node-gyp:
npm install -g node-gyp. Please see https://www.npmjs.com/package/node-gyp for installing dependencies. - Then run the following commands
cd imagery/
npm install
npm run package # builds and packages the application on the your platform
Coming soon.
- Start up the application by opening the binary file. e.g Imagery.exe (Windows)
- Maximize the window.
- Open a image file: File > Open (See supported formats in Features section)
- Sidebar should be populated. Apply a filter by checkbox.
- Click on the down arrow icon to expand the filter.
- Change the settings.
- Open another image file. (A new image will appear on top of current)
- Select the image titlebar and drag it to available room.
- Change the image selection, by selecting on the image. (Sidebar settings are image context sensitive)
Image processing and the UI share the same process. Some filters such as Histogram Local Equalization may cause unresponsiveness. In Phase 2, there will be a redesign of the current architecture so image processing happens in a background process.
Supported image formats: PGM ASCII (P2)
Development is ongoing to support various formats. Currently only PGM ASCII is supported. You can convert any image to PGM ASCII with instructions bellow.
- Download and install Imagemagick. http://www.imagemagick.org/script/binary-releases.php
- Run command
convert image.png image.pgm - Download and compile the program "pgmb_to_pgma.cpp" for your platform. e.g.
g++ pgmb_to_pgma.cpp -o pgmb_to_pgma.exehttp://people.sc.fsu.edu/~jburkardt/cpp_src/pgmb_to_pgma/pgmb_to_pgma.html - Execute the program e.g.
pgmb_topgma.exe image.pgm image.pgma
Development status is inactive.
To add new filters, see app/components/filters for examples.
The application is built ontop of the Electron-React boiler plate. Please see https://github.com/chentsulin/electron-react-boilerplate for running a development environment.