NAME

ms2view -- mapsoft2 viewer for geodata and raster maps

SYNOPSIS

ms2view [<options>] <input files>

GENERAL OPTIONS

-h, --help

Show help message.

--pod

Show help message as POD template.

-v, --verbose

Be verbose.

OPTIONS FOR READING GEODATA

--in_fmt <arg>

Geodata input format (json, gu, gpx, kml, kmz, ozi, zip).

--gu_enc <arg>

Garmin Utils format charset (default KOI8-R).

--ozi_enc <arg>

OziExplorer format charset (default Windows-1251).

OPTIONS FOR DRAWING TRACKS

--trk_draw_mode <arg>

Track drawing mode (normal, speed, height, default - normal).

--trk_draw_transp <arg>

Use transparent color (0..1, default - 0.5).

--trk_draw_dots <arg>

Draw dots (for normal drawing mode), default: 1.

--trk_draw_width <arg>

Track width factor, default: 3px.

--trk_draw_smin <arg>

Min value for speed mode [km/h].

--trk_draw_smax <arg>

Max value for speed mode [km/h].

--trk_draw_hmin <arg>

Min value for height mode [m].

--trk_draw_hmax <arg>

Max value for height mode [m].

--trk_draw_grad <arg>

Color gradient (for speed or height modes), default: BCGYRM.

OPTIONS FOR DRAWING WAYPOINTS

--wpt_text_font <arg>

Waypoint font (default: "serif").

--wpt_text_size <arg>

Waypoint font size, pixels (default: 10).

--wpt_text_pad <arg>

Waypoint text padding, pixels (default: 2).

--wpt_draw_size <arg>

Waypoint dot radius, pixels (default: 3).

--wpt_line_width <arg>

Waypoint line width, (default: 1).

--wpt_stick_len <arg>

Length of waypoint flag stick (default: 10).

--wpt_color <arg>

Waypoint color (default: 0xFF000000).

--wpt_bgcolor <arg>

Waypoint background color (default: 0xFFFFFFFF).

--wpt_adj <arg>

Adjust waypoint flag positions to prevent mutual collisions (default: 1).

--wpt_adj_brd <arg>

Adjust waypoint flag positions to prevent boundary collisions (default: 0).

--wpt_skip_far <arg>

Skip points if their labels can not be placed close enough (default: 10*wpt_stick_len).

OPTIONS FOR DRAWING MAPS

--map_smooth <arg>

Smooth map drawing, interpolation for small scales, averaging for large ones, (0|1, default - 0).

--map_clip_brd <arg>

Clip map to its border (default 1).

--map_draw_refs <arg>

Draw map reference points (ARGB color, default 0).

--map_draw_brd <arg>

Draw map border (ARGB color, default 0).

--map_fade <arg>

Color to fade the map (default is 0, no fading).

--map_min_sc <arg>

Min scale (<map pixels>/<image pixels>) (default is 0.1).

--map_max_sc <arg>

Max scale (<map pixels>/<image pixels>) (default is 10).

--map_def_col <arg>

Color to paint the map outside min_sc/max_sc (default is 0x80FF0000).

OPTIONS FOR DRAWING SRTM DATA

--srtm_dir <arg>

Set srtm data folder, default - $HOME/.srtm_data

--srtm_use_overlay <arg>

Use overlay (0|1, default 1).

--srtm_interp <arg>

Interpolation (nearest, linear, cubic. Default: linear).

--srtm_draw_mode <arg>

SRTM surface drawing mode (slopes, heights, shades, default - shades).

--srtm_hmin <arg>

Min height [m] for heights and shades modes (default - 0).

--srtm_hmax <arg>

Max height [m] for heights and shades modes (default - 5000).

--srtm_smin <arg>

Min slope [deg] for slopes mode (default - 35).

--srtm_smax <arg>

Max slope [deg] for slopes mode (default - 50).

--srtm_bgcolor <arg>

Color to draw no-data and out-of-scale areas (default 0x60FF0000).

--srtm_surf <arg>

draw SRTM color surface (default 1).

--srtm_cnt <arg>

Draw contours (0|1, default - 1).

--srtm_cnt_step <arg>
Contour step [m], default 50.
--srtm_cnt_vtol <arg>
altitude tolerance for smoothing contours [m], default 5
--srtm_cnt_smult <arg>
Step multiplier for thick contours, default - 5.
--srtm_cnt_col <arg>
Contour color, default - 0xFF000000.
--srtm_cnt_w <arg>
Contour line width, default - 0.25.
--srtm_cnt_wmult <arg>
Width multiplier for thick contours, default - 2.
--srtm_cnt_crv <arg>
Size of round corners on contours, in linewidth units, default - 20.
--srtm_holes <arg>
Draw contours around data holes (1|0, default - 0).
--srtm_holes_col <arg>
Color of hole contours, default - 0xFF000000.
--srtm_holes_w <arg>
Linewidth of hole contours, default - 1.
--srtm_peaks <arg>
Draw summits (0|1, default - 0).
--srtm_peaks_col <arg>
Summit's color, default - 0xFF000000.
--srtm_peaks_w <arg>
Summit point size, default - 3.
--srtm_peaks_dh <arg>
DH parameter for peak finder [m], default - 20.
--srtm_peaks_ps <arg>
PS parameter fr peak finder [pts], default - 1000.
--srtm_peaks_text <arg>
Draw peak text (0|1, default - 1).
--srtm_peaks_text_size <arg>
Peak text size, default - 10.
--srtm_peaks_text_font <arg>
Peak text font, default - serif.

OTHER OPTIONS

--vmap <arg>

Open vector map

--vmap_config <arg>

Rasterisation config-file instead of default raster.txt

CUSTOMIZING VIEWER INTERFACE WITH CSS STYLES

Structure of ms2view window is simple: a viewer, a main menu, a statusbar, tables with waypoints, tracks, and maps, a few dialogs, etc. Appearence of these elements is controlled by GTK3 theme. One can customize it using CSS styles. Styles are read from two places: /usr/share/mapsoft2/mapsoft2.css -- system-wide file. By default it contains a few definitions, mostly for making interface elements smaller. Some tips about viewer structure can be also find there. $HOME/.mapsoft2/mapsoft2.css -- user-specific file.

Additional information about writing css styles can be found in GTK3 documentation or GTK theme sources:

CUSTOMIZING HOTKEYS

Menu hotkeys can be changed in $HOME/.mapsoft2/mapsoft2.acc file. The file is read each time the program is started and written when it exits. A default hotkey mapping with all lines commented is written in the first run.

VIEWER PROJECTION

Mapsoft2 viewer uses the following algorithm to set viewer projection and view area:

In the beginning a web mercator projection is set, it is considered as "temporary" projection. Position and zoom is set to cover the whole world, it is considered as "temporary" view.
When new maps are loaded, if projection temporary, then it is replaced by projection of the first map and become non-temporary. If view is temporary, then the map is shown (view remains temporary). If viewer projection was non-temporary, then no projection change or zooming/scrolling is done.
When new tracks or points are loaded, projection does not change. Zoom and position of the viewer window is adjusted to have all loaded data on the screen. The view become non-temporary.

AUTHOR

Vladislav Zavjalov <slazav@altlinux.org>

SEE ALSO