Skip to content

User manual

Martin Števko edited this page Sep 23, 2020 · 6 revisions

Welcome to the user manual where you can find how to properly use an app interface and all of its functionalities.

Open new image

You have 2 options to open new image:

  • select File -> Open new,
  • bouble click on the canvas.

This will open a dialog window. If you have image already opened opening a dialog window will be preceded by a warning message if you are sure.

Application layout

Under the image are color filter buttons. Each button applies a filter on image:

  • first button is "no filter" for removing applied filters,
  • second button applies red filter, which means only red color is shown while green and blue are set to zero,
  • third applies green filter, which means only green color is shown while red and blue are set to zero,
  • fourth applies blue filter, which means only blue color is shown while red and green are set to zero.

On the right side there are image enhancers. You can set saturation, brightness and clarity by track bar or directly by setting new value. Under the "Change color" header you can select two colors and click to "Change" which will change its values in RGB format for each pixel in the image.

Application also provides some buttons to enhance image:

  • invert color - sets each pixel to its opposite, which means setting it to (255-R), (255-G), (255-B) value,
  • graystyle filter - converts each pixel to the graystyle according to the pixel brightness,
  • flip horizontal - flips image by axis X,
  • flip vertical - flips image by axis Y.

Be careful - saturation, brightness and clarity edit and color inverter respects color filters, so if you have some color filter applied only this particular color is changed.

Application menu

Click on the menu button will show particular category of menu and second click (anywhere) will hide it again. For menu functionality description read description to particular category.

File

Open new

Opens new image as described at the top.

Save

Saves image with its original name and directory. This option overrides original image! This button is disabled when no image is opened.

Save as

Opens dialog window where you can choose new directory and also file name. This button is disabled when no image is opened.

Edit

Undo

Undo your last action. This button is disabled when no image is opened.

Redo

Redo your last undone action.

Export LUT

Exports LUT file according to changes you have made to currently opened image. LUT file is saved into the main application directory. For detailed LUT file format description read below. This button is disabled when no image is opened.

Apply LUT file

Applies choosen LUT file to the image. For detailed LUT file format description read below. This button is disabled when no image is opened.

Help

User manual

Opens this manual in your default web browser.

Documantation

Opens documentation for programmers in your default browser.

Report issue

Opens GitHub website for this application, where you can submit new issue choosing one of issue templates.

LUT file

LUT files also known as CUBE files with suffix .CUBE are some kind of color maps. They are enhancers which someone prepared and you can apply it just by a few clicks. Important idea about LUT files is, that they map "each" color to some other "better" color, where better means color which looks better on that kind of image. For example by LUT files you can remove smog from image (it means new colors are purer), convert image to black and white (new colors are on black and white scale), convert image to "70's colors", etc. Of course you can not map each color, so you define color scale size (for example 32) and map only each combination of 32 color shades equally spread out across one color spectra. This mapping uses RGB color format, so you map each combination of 32 shades of red, 32 shades of green and finally 32 shades of blue.

Format in application

First row contains keyword TITLE, space and LUT file title without spaces.

Second row contains keyword LUT_3D_SIZE, space and size of the cube.

Third row is empty.

Forth and every other of LUT_3D_SIZE^3 rows contains exactly one new color in RGB format with spaces as delimeters.

Example

TITLE Example_LUT
LUT_3D_SIZE 2

0 0 0
255 0 0
0 255 0
255 255 0
0 0 255
255 0 255
0 255 255
255 255 255

Requirements

  • minimal display width: 1600px
  • minimal display height: 560px
  • optimal display resolution: 16:9

Clone this wiki locally