GUI Editor for MapCss
OVERVIEW:
GEM is a GUI app for creating and editing QA/QC centric mapCss paintstyles for use in JOSM and other platforms.
GEM allows the user to add, edit and filter editors by OSM username, and to assign each or all uniqe color and shape highlights for both ways and nodes on the OSM map.
The user can also hide or show editors within their list at any time to more easily distinguish areas aof work.
GEM also features a time search feature, which will only highlight uploads made by the selected editors during the time frame selected.
GEM uses a custom mapcss format, and curently only supports importing/exporting of that particular format. A sample MapCss file in the correct format can be found in the root directory of the repo.
Any new paint style created from scratch will automatically be set in the GEM format when exported.
GUI Editor for MapCss (GEM) Instructions
INSTALLATION:
-
Drag the zip file into your desired folder.
-
Extract the GEM app by double clicking the zip file. The GEM app icon should appear.
-
While holding the control button, right click on the app file and press “open”. Note: This will allow you to bypass the Gatekeeper “Unknown Author” warning and open the app. You will only need to do this the first time you open the app.
CREATE NEW PAINT STYLE
-
To create a new map paint style, begin by entering your team title in the “Team Name” text field near the top.
-
Under editor settings, type in the name and User ID of the first editor you wish to add.
-
Choose a line and node highlight color for this editor and press the “add” button to move them to the table of editors on the right.
-
Repeat this process for each editor on your team.
EDITING USER INFO
-
Select the editors name and press “Edit”. Note: This will bring the editors name and settings back into the editor setting menu.
-
Make whatever changes are needed and press “Update” to complete the changes.
EXPORTING
-
When you have added all of your editors and are ready to export, press the “Export” button. Note: This will open a save file dialog in which you can choose where to save your new mapcss file. Your file will be named “QAQC_(YOUR TEAM NAME HERE).mapcss by default, but this can be changed in the save file dialog.
-
Press “save” and your new mapcss file will be ready to load in the folder you have chosen.
-
In JOSM, open the preferences menu. Select “Map Settings” which is the third option down n the left hand toolbar.
-
Select “Map Paint Styles” which is the second option from the left in the top menubar.
-
Press the “+” button in the upper right to add a new paint style.
-
On the resulting popup window, press the file finder button on the far right. Note: This will open a file picker dialog you can use to navigate to the folder where you saved your new mapcss file.
-
Select your new style and press “Open”.
8.Close out of the JOSM preferences menus.
You should see your new paint style in the paint style window in JOSM
EDITING THE PAINTSTYLE
-
press the “Import” button and navigate to the folder where you mapcss file is saved.
-
Select the file and press “open”. This will import all of your team and editor settings into the GUI for editing.
-
When you have finished making changes, press the “export” button.
NOTE: If you replace/overwrite the same mapcss file you previously loaded into JOSM, then any changes you made to the paint style will be reflected immediately when you click back onto the JOSM window. This may sometimes take a few seconds, however there is no need to reload the paint style from the file.