Table of content

• NeronGPS.conf file location
• Tile server configuration
• Menus and buttons configuration
• Buttons display configuration
• Tile caches configuration
• Map display configuration
• Location cursor configuration
• Tile servers list
• Traces configuration
• draw lists
• Color coding

The file is localized in the /home/root/packages/<number>/Settings/NeronGPS folder.

For tile server configuration, please read the add map servers to NeronGPS.conf page

This section is listing the menu options and the buttons displayed on the map. Menu and buttons are associated with predefined actions. The actions list is the following:

• auto_center: enable the auto-center mode (only visible when auto-center is disabled)
• cache: open the cache management form
• clock: open the time management form
• display_always_on: enable/disable the display power saving mode
• display_trailer: enable/disable the display of the trailer trace
• journey: open the journey management form
• magnification: open the magnification form
• record: enable/disable trace recording
• server: open the tile server selection form
• start_batch: start tile batch loading (only visible when a cache has been set-up using the cache management form)
• stop_batch: stop tile batch loading (only visible when a batch loading is in progress)
• traces: open the traces management form
• user_log: open the user log form
• zoom: open the zoom level form
• zoom_minus: zoom in the map
• zoom_plus: zoom out the map

For each action, one of the following option can be selected:

• main/<position>: display the action in the main menu, the <position> value being used to order the list
• more/<position>: display the action in the 'Other...' sub-menu, the <position> value being used to order the list
• button/<x>/<y>/<draw list>: display a button triggering the action
  • (<x>, <y>) is the position of the button on screen, starting from top or left for positive values, bottom or right for negative values
  • <draw list> is a list of basic shapes to be displayed to draw the button, as described at chapter draw lists.

2 states actions (display_always_on, record and display_trailer) can only be displayed in menus.

This section is configuring the button display parameters:

• buttonenabledcolor: drawing color, in RRGGBBAA format
• buttondisabledcolor: drawing color when the button is disabled
• buttonthickness: thickness off drawed lines in pixels
• buttonbackgroundcolor: fill color (used by ell2 and seg2), in RRGGBBAA format
• buttonpressedcolor: fill color (used by ell2 and seg2) when the button is pressed
• buttonwidth: width of buttons in pixels
• buttonheight: height of buttons in pixels

This section is configuring tile caches:

• cachedir: folder containing caches managed by the cache form
• tempcachedir: folder containing temporary tiles, loaded when the user browse the map

This section contains the default map configuration:

• defaultlatitude: the default latitude of the center of the map
• defaultlongitude: the default longitude of the center of the map
• defaultserver: the default tile server
• defaultzoom: the default zoom level
• displayalwayson: is the display always on option activated by default
• magnification: the default macnification level
• nomagnification: the ',' separated list of tile servers or composers on which the magnification need to be disabled (e.g. for arial, or composers that already magnificate)

This section configure the cursor pointing on the current GPS location:

• fixbordercolor: drawing color, in RRGGBBAA format, when GPS is fixed
• fixfillcolor: fill color (for ell2 and seg2) when GPS is fixed
• lostbordercolor: drawing color when GPS fix is lost
• lostfillcolor: fill color (for ell2 and seg2) when GPS fix is lost
• shape: the list of basic shapes composing the cursor, as described at chapter draw lists

For tile server configuration, please read the add map servers to NeronGPS.conf page

This section configure the traces:

• autorecord: when set to true, will ask to start recording a trace at application start up
• tracedir: folder to store recorded traces
• tracepoint: the spacing between points when displaying a trace. For faster drawing, not all points are displayed. The value is the square of the effective value in pixels. For example, 400 means a point every 20 pixels.
• tracethickness: the thickness of the drawed line, in pixels
• tracetransparency: the level of transparency when drawing the trace, between 0 and 255. 0 is fully transparent (nothing displayed), 255 is opaque.
• trailcolor: the color of the trace representing the current journey
• trailpoint: spacing between points for the current journey
• trailthickness: thickness in pixels for the current journey

Draw lists are composed of basic elements, separated by a '/' characters. Possible basic elements are the following:

• line(<x1>,<y1>,<x2>,<y2>): draw a line from (<x1>,<y1>) to (<x2>,<y2>
• ell1(<x1>,<y1>,<x2>,<y2>): draw an ellipse whithin the rectangle defined by the 2 points
• ell2(<x1>,<y1>,<x2>,<y2>): draw an ellipse whithin the rectangle defined by the 2 points, and fill the ellipse
• seg1(<x1>,<y1>,<x2>,<y2>,<x3>,<y3>,...): draw multiple lines defined by the list of points
• seg2(<x1>,<y1>,<x2>,<y2>,<x3>,<y3>,...): draw multiple lines defined by the list of points, and fill the drawn polygon

Coordinates are expected to stay in a range of 0 to 100, or the drawing will go outside the expected drawing area. 0 value correspond to the top or left side of the drawing area, 100 to the bottom or right. Floating point values are not accepted.

Color are coded with an RRGGBBAA format:

• RR: red value between 0 and 255, in hexadecimal
• GG: green value between 0 and 255, in hexadecimal
• BB: blue value between 0 and 255, in hexadecimal
• AA: transparency level between 0 (fully transparent) and 255 (solid), in hexadecimal