Difference between revisions of "Custom color schemes"

From Wazeopedia
m (Example custom color schemes)
(Blanked the page)
Line 1: Line 1:
<!--if the section parameter is defined, do not place the visible banner, only as the code block for the top of a section-->{{GlobalMark/visible}}
####    This page has been curated  ####
####    to be included in the new    ####
####    Wazeopedia - GLOBAL Wiki.  ####
####    Please do not make any      ####
####    edits on this page without  ####
####    PRIOR CONSENSUS in the Wiki  ####
####    Updates and Discussions      ####
####    forum thread for this page.  ####
####    If a specific forum thread  ####
####    for this page doesn't exist  ####
####    please start one.            ####
####        www.waze.com/forum/      ####
####        viewforum.php?f=276      ####
{{Hatnote|For the Waze app built in color schemes, please see the [http://support.google.com/waze/answer/6146281?hl{{=}}en Waze Help Center].}}
{{ForumLink|Color schemes thread|11873}}
The Waze client is capable of displaying the map using various color schemes. Several color schemes are available in the client by default; users are also able to create their own custom color schemes or install custom color schemes created by others.
== Default color schemes ==
Thirteen daytime color schemes are available in the Waze 3.x client:
* Default
* Green peace
* Minimalism
* Vitamin C
* The blues
* Mochaccino
* Snow day
* Twilight
* Tutti-frutti
* Rosebud
* Electrolytes
* Map editors
* Green fields
There are just two daytime color schemes are available in the Waze 4.0 client:
* Default
* Map editors
The daytime color scheme can be changed in Settings - Display Settings - Map Color Scheme.
Waze also includes one night color scheme. This is activated by choosing "Night" mode in the Settings menu, or by leaving "Auto" enabled and using Waze at night.
== Custom color schemes ==
A user can also create custom color schemes using a text editor.
=== Creating custom color schemes ===
Each color scheme is defined by a '''schema file'''. The schema file contains the color and size information for each road type and certain other features, such as Places, water features, map labels, and so forth.
It should be noted that due to significant differences between the v3.x client and the v4.x client color schemes are not interchangeable and must be designed for the correct client version.
The easiest way to create your own scheme is to start with one of the default schema files. To get to the default schema files, you'll need a file browser for your device (such as iFunBox for use with iOS devices, or ASTRO File Manager for Android).
*In iOS, the day schemes are found in '''User Applications » Waze » Waze.app » skins » default » day''' and its subfolders, and the night scheme is found in '''User Applications » Waze » Waze.app » skins » default » night'''.
*{{anchor|Android files}}In Android, you can use the visual Editor "[https://play.google.com/store/apps/details?id=de.toggeli.we Toggelis Waze Editor]" or edit the files manually. The day schemes are found in '''SD Card (or your root folder) » Waze » skins » default » day''' and its subfolders, and the night scheme is found in '''SD Card (or your root folder) » Waze » skins » default » night'''.
You may wish to copy both directories to your computer to make it easier.
Within the '''day''' folder, there are several subfolders. Each subfolder contains a schema file, as does the '''day''' folder itself. The schema files correspond to the default schemes as follows:
* 1: The blues
* 2: Mochaccino
* 3: Snow day
* 4: Twilight
* 5: Tutti-frutti
* 6: Rosebud
* 7: Electrolytes
* 8: Map editors
* 9: Green peace
* 10: Minimalism
* 11: Green fields
* '''12: Default'''
* day folder: Vitamin C
Note that Waze 4.0 for iOS only has two day color schemes; Default (12) and Map Editors (8 - with old colors).
To edit a schema file, open it in a text editor. Each schema file is a list of parameters – most relating to color and size. Color parameters are in #rrggbb hex color format (see [[wikipedia:web colors|web colors]]); some color parameters have two additional digits, controlling the alpha channel (transparency) of that particular feature (#rrggbbaa).
The categories, descriptors, and classes used in the schemas are modified from the RoadMap schema API. Here is the current Waze schema API:
{| class="wikitable"
! Category !! Descriptors
| Map (global) ||
*Background (solid color of land, except islands)
| Labels (global) ||
*Color (solid color of all labels)
*Bgcolor (alpha outline color of all labels)
*MinFeatureSize (minimum size for a feature that can be labeled)
| Road Class:
*Primary (Major highways)
*Secondary (Minor highways)
*Ramps (Ramps)
*Highways (Primary streets)
*Streets (Streets, Private streets, Parking lot roads)
*Pedestrian (Pedestrian boardwalk)
*4X4 Trails (Dirt road/4X4 trail)
*Trails (Walking trail)
*Walkway (Stairs)
*Railroads (Railroad)
*Runways (Runway/taxi)
*Ferry (Ferry)
*Class (required; must be set to Road)
*Thickness (required; thickness of road relative to zoom level and screen size. If less than 2, the road cannot have a fill color or label)
*Color (solid color of the road)
*Color1 (alpha fill color pen for munched roads; nodes will be solid)
*Color2 (alpha fill color pen for unmunched roads; nodes will be solid)
*Declutter (zoom level at which the road is forcibly hidden)
*Delta1 (fill color margin for munched roads; negative value)
*Delta2 (fill color margin for unmunched roads; negative value)
*LabelDeclutter (zoom level at which the label is forcibly hidden)
*LabelColor: (label color #rrggbbaa)
| Area Class:
*Airports (Islands, NOT AIRPORTS)
*Cities (Cities)
*Parks (Parks, forests, etc)
*Sea (Lakes, rivers, streams, canals, swamps, oceans, etc)
*Stations (All area places that don't fall into one of the above categories)
*Class (required; must be set to Area)
*Thickness (required; thickness of area outline relative to zoom level and screen size. If less than 2, the area cannot have a label)
*Color (alpha fill color)
*Color1 (solid outline color)
*Declutter (zoom level at which the area is forcibly hidden)
*Delta1 (outline color margin; negative value)
*LabelDeclutter (zoom level at which the label is forcibly hidden)
| Navigation (navigational features)
*RouteColor (main screen highlighted destination route color)
*StopPointColor (main screen highlighted stop point route color)
*Alt1outeColor (TYPO REQUIRED; route 1 highlight color in the Routes map)
*Alt2outeColor (TYPO REQUIRED; route 2 highlight color in the Routes map)
*Alt3RouteColor (route 3 highlight color in the Routes map)
*PossibleRouteColor (NOT YET IDENTIFIED, default is light blue)
*NavigateAlt1Pen1-0 (NOT YET IDENTIFIED)
*NavigateAlt1Pen1-1 (NOT YET IDENTIFIED)
*NavigateAlt1Pen2-0 (NOT YET IDENTIFIED)
*NavigateAlt1Pen2-1 (NOT YET IDENTIFIED)
*NavigateAlt1Pen3-0 (per a typo this also sets NavigateAlt1Pen3-1, NOT YET IDENTIFIED)
=== Installing custom color schemes ===
==== iOS ====
Installing custom themes in iOS does not require replacing the default themes, so don't worry about creating a backup.
* Get an iOS file manager, such as [http://www.i-funbox.com/ iFunBox].
* In the file manager, open "Waze" in User Applications.
* In the Waze » Documents folder, if it's not already there, create a new folder named '''skins'''. Inside the skins folder, create a new folder called '''default'''.
* To install a day theme,
** In the Waze » Documents » skins » default folder, create a folder named '''day'''.
** Create a numbered folder inside the '''day''' folder that corresponds with the number of the included skin you would like to replace.
*** For example, to replace the "Tutti-frutti" theme, create a folder named '''5'''.
** Place your custom schema file inside the numbered folder you just created.
* To install a night theme,
** In the Waze » Documents » skins » default folder, create a folder named '''night'''.
** Place your custom schema file directly inside the '''night''' folder you just created.
** Note that this will replace the default night theme; only one night theme can be installed at a given time.
* To use an installed theme,
** Day schemes: In Settings »&nbsp;Display settings » Map Color Scheme, select the name of the theme you replaced. So, if you placed your schema file in folder '''5''', select "Tutti-frutti" in the app to use your custom scheme (there is currently no known way to rename schemes in the list in the app). Also, ensure that the client is in "day" mode, or leave it in "auto" and wait until daytime.
** Night schemes: Set the client to "night" mode or wait until nighttime.
* You can replace a schema file for a currently-selected theme even while the client is running, but to use a new version of a theme you are already running, you have to make the client reload the theme. To do this, switch away from and back to that theme. The quickest way to do this is to set the client to day/night mode and back.
* To uninstall a custom theme, delete its schema file. You can also temporarily disable a custom theme by renaming the schema file to something other than "schema".
==== Android ====
* Choose a scheme you wish to replace from [[#Android files|the built in list above]].
* Place the new schema file in the corresponding folder, replacing (or renaming) the original file.
* Alternatively you can directly modify the existing schema file ''(open with a text editor)'' with the changes you desire. You may also copy and paste the complete code of the scheme you want into the original schema file, replacing the original content.
** If there are sub-folders for specific zoom levels, you will have to either remove or modify the schema files in those directories as well.
=== Example custom color schemes ===
{{mbox|image=[[File:Wikitext.png|50px|link=|alt=]]|text=To simplify the coding for adding a script to this table there is the recommended option to use the {{tl|ColorSchemeEntry}} template. ''instructions are available on the templates page''.}}
{| class="wikitable sortable"
! Name !! By !! Details !! Screenshot !! Links
| [[User:BobTheWikipedian/Color_schemes/Map_editors|Map Editors 2015]]
| [[User:BobTheWikipedian|BobTheWikipedian]]
| {{User:BobTheWikipedian/Color_schemes/Map_editors|transcludesection=details}}
{{ColorSchemeEntry|User:PesachZ/Color_schemes/Map editors 2015 colors}}
| [[User:Sketch/Color_schemes/Friendly_WME|Friendly WME Theme]]
| [[User:Sketch|Sketch]]
| {{User:Sketch/Color_schemes/Friendly_WME|transcludesection=details}}
{{ColorSchemeEntry|User:PesachZ/Color_schemes/Map_editors night}}
{{ColorSchemeEntry|User:PesachZ/Color_schemes/Map editors night 2015 colors}}
| [[User:Sketch/Color_schemes/WME_Neon_Night|WME Neon Night Theme]]
| [[User:Sketch|Sketch]]
| {{User:Sketch/Color_schemes/WME_Neon_Night|transcludesection=details}}
{{ColorSchemeEntry|User:PesachZ/Color_schemes/Night blue}}
| [[User:DeepSouthDiver/Garminesque day|Garminesque day]]
{{User:DeepSouthDiver/Garminesque day|transcludesection=update}}
| [[User:DeepSouthDiver|DeepSouthDiver]]
|  {{User:DeepSouthDiver/Garminesque day|transcludesection=details}}
| {{User:DeepSouthDiver/Garminesque day|transcludesection=screenshot}}
| {{User:DeepSouthDiver/Garminesque day|transcludesection=links}}
| [[User:DeepSouthDiver/Garminesque night|Garminesque night]]
{{User:DeepSouthDiver/Garminesque night|transcludesection=update}}
| [[User:DeepSouthDiver|DeepSouthDiver]]
|  {{User:DeepSouthDiver/Garminesque night|transcludesection=details}}
| {{User:DeepSouthDiver/Garminesque night|transcludesection=screenshot}}
| {{User:DeepSouthDiver/Garminesque night|transcludesection=links}}
| [[User:Spookyx/New WME Cool Day|New WME Cool Day]]
{{User:Spookyx/New WME Cool Day|transcludesection=update}}
| [[User:Spookyx|Spookyx]]
|  {{User:Spookyx/New WME Cool Day|transcludesection=details}}
| {{User:Spookyx/New WME Cool Day|transcludesection=screenshot}}
| {{User:Spookyx/New WME Cool Day|transcludesection=links}}
| [[User:bretmcvey/Serenity|Serenity]]
| [[User:bretmcvey|bretmcvey]]
|  {{User:bretmcvey/Serenity|transcludesection=details}}
| {{User:bretmcvey/Serenity|transcludesection=screenshot}}
| {{User:bretmcvey/Serenity|transcludesection=links}}
|- style="vertical-align:top;"
| [[User:Dave2084/Colour_Schemes/OS_OpenData|OS OpenData]]
| [[User:Dave2084|Dave2084]]
| {{User:Dave2084/Colour_Schemes/OS_OpenData|transcludesection=details}}
| {{User:Dave2084/Colour_Schemes/OS_OpenData|transcludesection=screenshot}}
| {{User:Dave2084/Colour_Schemes/OS_OpenData|transcludesection=links}}
|- style="vertical-align:top;"
| [[User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|Classic Google Maps]]
| [[User:Dave2084|Dave2084]]
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|transcludesection=details}}
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|transcludesection=screenshot}}
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK|transcludesection=links}}
|- style="vertical-align:top;"
| [[User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK_v4|Classic Google Maps v4.1]]
| [[User:Dave2084|Dave2084]]
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK_v4|transcludesection=details}}
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK_v4|transcludesection=screenshot}}
| {{User:Dave2084/Colour_Schemes/Classic_Google_Maps_UK_v4|transcludesection=links}}
|- style="vertical-align:top;"
| [[User:Dave2084/Colour_Schemes/Audi_TT_At_Night|Audi TT At Night]]
| [[User:Dave2084|Dave2084]]
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night|transcludesection=details}}
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night|transcludesection=screenshot}}
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night|transcludesection=links}}
|- style="vertical-align:top;"
| [[User:Dave2084/Colour_Schemes/Audi_TT_At_Night_v4|Audi TT At Night v4.1]]
| [[User:Dave2084|Dave2084]]
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night_v4|transcludesection=details}}
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night_v4|transcludesection=screenshot}}
| {{User:Dave2084/Colour_Schemes/Audi_TT_At_Night_v4|transcludesection=links}}
| [[User:Chief5232/WME Map Editors Black|WME Map Editors Black]]
{{User:Chief5232/WME Map Editors Black|transcludesection=update}}
| [[User:Chief5232|Chief5232]]
|  {{User:Chief5232/WME Map Editors Black|transcludesection=details}}
| {{User:Chief5232/WME Map Editors Black|transcludesection=screenshot}}
| {{User:Chief5232/WME Map Editors Black|transcludesection=links}}
| Example || Example || Example || Example || Example
| Example || Example || Example || Example || Example
[[Category:Advanced app content]]

Revision as of 04:28, 7 February 2016