This is an old revision of the document!


PHP's gd library is missing or unable to create PNG images

Map Viewer

The map viewer is the tool designed to view and interpret map information.

Main Window

The main window is where the most important information regarding the viewer state is located. On the left you have the toolbar related to the viewer state as a whole, on the right you have a list of loaded maps and tools to manage them.

Toolbar


Each toolbar button is described below: 1) Load map erasing the current stack, load maps using the current stack, replace maps and load saved viewer state.
2) Save viewer state (save transformations, map stack, background color and movie maker settings.
3) Save current visualization (including legend if visible) as a bitmap image).
4) Reload current selected map.
5) Open movie maker (allow users to make *.mp4 movies from a series of maps in a easy way).
6) Create map groups (grouping maps allow users to apply calculate expressions on top of a custom stack).
7) Toggle map legend (and if image is currently in category mod, toggle categories visualization).
8) Zoom map extents to view window (render the map using the entire screen space available).
9) Zoom in (zoom in over hovered cell).
10) Zoom out (zoom out over hovered cell).
11) Zoom to selection rectangle (selected rectangle will cover entire screen space available).
12) Pan (allow users to movement the current visualization area).
13) Previous view (if user is making many visualization steps, you can go back to last step using this button).
14) Background color (change application background color).
15) Quit.

Palette

Allow users to select which color represents each cell in visualization area.
Cells are first extracted from the map in their original values (in any range) and then re-sampled using the histogram curve.
After that, their values fall in the [0, 255] range, which are mapped to palette colors.



Changing colors individually

Each color can be changed individually, by clicking on its square. You can also check color index value by hovering your cursor over the color square.


Generated palette

You can also create a palette using a linear interpolation between two color values (gradient). All you have to do is click the gradient button and set your range.

After that, you can click the interpolate button and the new palette view be generated.

Saving your work

Keep in mind that palettes are not saved until the user chooses to do so. If you made any mistake, you can just hit “cancel” and try again. If you hit Ok, the palette will be changed locally, but will reset if you restart the application. Saved palettes are stored on the disk, so every time you reopen the map viewer, you will still have them.

Histogram

The histogram window is responsible for assigning transformations from image original values (in any range) to palette range [0, 255]. The histogram curve will adjust any value smaller than the “From:” limit to 0, and any value greater than the “To:” limit to 255. Any other values will be mapped using the histogram curve to the “Y” coordinate on the color palette on the left.

Transformations

  • The default transformation doesn't map any values, leaving cell values “as is”.
  • Linear transformation will map linearly any values between the “from” and “to” ranges.
  • Equalize will construct a curve based on Equalization