Settings ======== Settings can be accessed from the menu by selecting **File > Settings**. The **Settings** menu contains four categories: General, Palettes, Audio, and Text. .. image:: images/settings-general-04-restore-defaults.png Settings can be globally restored to default with the **Restore Defaults** button in the lower left corner. .. image:: images/settings-general-05-individual-restore-default.png Individual settings can be restored to their default with the circle arrow button beside the respective setting. .. note:: Most settings will require reloading the application to take effect. General ------- Clock Format ^^^^^^^^^^^^ Toggle between a 12-hour and 24-hour clock display. Default Alert Action ^^^^^^^^^^^^^^^^^^^^ Changes what happens when selecting an alert in the Alerts panel. - Go (Default) - Switch to issuing radar site and pan map to location. - View - Open Alert to view text issued from NWS. Default Radar Site ^^^^^^^^^^^^^^^^^^ Choose which radar site will load automatically upon opening the application. The map will also be centered over the selected radar site. Default Time Zone ^^^^^^^^^^^^^^^^^ Select between displaying the time zone of the selected radar, the user's local time zone, or UTC. Grid Width and Height ^^^^^^^^^^^^^^^^^^^^^ These settings allow multiple radar products to be viewed simultaneously. Changing Grid Width will create panes side by side, while Grid Height will create panes top and bottom. The maximum value for both is two. *Layout with a Grid Width of 2 and a Grid Height of 1* .. image:: images/settings-general-01-gridwh-w2-h1-small.png *Layout with a Grid Width of 1 and a Grid Height of 2* .. image:: images/settings-general-02-gridwh-w1-h2-small.png *Layout with a Grid Width of 2 and a Grid Height of 2* .. image:: images/settings-general-03-gridwh-w2-h2-small.png GPS Plugin ^^^^^^^^^^ Selected between the operating system default GPS provider and an external device supporting the NMEA protocol. When selecting NMEA, either a serial source or a network source should be selected. For the proper GPS baud rate, Supercell Wx attempts to determine the correct value based on information supplied by the operating system. Please consult your GPS manual for the proper value. For selecting a network source, please see `Qt documentation `_ for proper format. If using **gpsd** on Linux to serve GPS information to Supercell Wx, you will need to use `gpspipe and socat `_ to serve NMEA data. Map Provider ^^^^^^^^^^^^ Select the provider for the map underlays. Currently Mapbox and MapTiler are supported. .. note:: The map types available on the Map Style dropdown in the Radar Toolbox will depend on the selected map provider. Mapbox API Key ^^^^^^^^^^^^^^ Input API key to be used when using Mapbox as the map provider. MapTiler API Key ^^^^^^^^^^^^^^^^ Input API key to be used when using MapTiler as the map provider. The available API keys can be found `on the account API Keys page `_ Custom Map URL ^^^^^^^^^^^^^^ URL for a custom map style. This can be a map from either Mapbox Studio or MapTiler Cloud. A Mapbox map URL has the format: ``mapbox://styles//``. This is labeled as the **Style URL** in Mapbox Studio. A MapTiler map URL typically has the format: ``https://api.maptiler.com/maps//style.json``. This is labeled as **Vector Style** in MapTiler Cloud. Note the ``?key=...`` suffix must be removed from the URL string. When modifying a style, you may need to close Supercell Wx, delete the cache, and re-open the application. On Windows, the cache is a ``.db`` file located at ``%LocalAppData%\Supercell Wx\`` or ``C:\Users\\AppData\Local\Supercell Wx\``. On Linux, the cache is located at ``~/.local/share/Supercell Wx/``. .. note:: Custom Mapbox styles are supported up to at least Mapbox GL JS 1.10.0+. Later Mapbox SDK versions may have issues, as not all newer features are currently supported by the `MapLibre `_ `Style Specification `_. Feature parity between `Mapbox `_ and MapLibre are not one-to-one, with a divergence somewhere around or after v8. Custom Map Layer ^^^^^^^^^^^^^^^^ When using a custom map, Supercell Wx needs to know underneath which layer to render the radar product and other items. When viewing the Layer Manager, the layer name specified here (in regular expression format), and all higher priority layers become the Map Symbology. Layers underneath this become the Map Underlay. Theme ^^^^^ **Default** will select the default Qt theme for the operating system being used. For Windows, this is the *Windows Vista* style, and for Linux, this is the *Fusion* style. This typically gives a native look-and-feel consistent with the rest of the operating system. **Fusion** will select the Fusion theme. On Linux, this is already the default. On Windows, this typically enables a Dark Mode if turned on in Windows settings. **Fusion Light** will select the Fusion theme and attempt to use a Light Mode palette. You can use this to override the default Light or Dark Mode selection from the Fusion theme. Note the override does not work in some desktop environments. **Fusion Dark** will select the Fusion theme and attempt to use a Dark Mode palette. You can use this to override the default Light or Dark Mode selection from the Fusion theme. Note the override does not work in some desktop environments. **Fusion Custom** will select the Fusion theme and allow the user to supply a custom `color scheme <#theme-file>`_. Additional Fusion Themes are available for selection. These will select the Fusion theme along with a specific color scheme. - Fusion Airy - Fusion Darker - Fusion Dusk - Fusion IA Ora - Fusion Sand - Fusion Waves Theme File ^^^^^^^^^^ When using the **Fusion Custom** Theme, allows the the use of a custom color scheme. See `qt6ct `_ for sample palettes. Warnings Provider ^^^^^^^^^^^^^^^^^ Supercell Wx supports multiple warnings providers: - https://warnings.cod.edu - https://warnings.allisonhouse.com Radar Site Threshold ^^^^^^^^^^^^^^^^^^^^ When the Radar Sites map layer is displayed, the site selections are always displayed, regardless of the map zoom level. To hide the selections at wider zoom levels, increase this value. To hide the selections at narrower zoom levels, decrease this value. To keep site selections always displayed, leave this value at zero. Anti-Aliasing Enabled ^^^^^^^^^^^^^^^^^^^^^ Allows enabling and disabling of anti-aliasing on the map. Disabling can improve performance, but may result in graphics with rougher edges. Changing this setting requires restarting the application. Multi-Pane Cursor Marker Always On ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The multi-pane cursor marker will display when holding down ``CTRL``. When this box is checked, this marker will always be displayed. Show Map Attribution / Logo ^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you have permission to hide map attribution, these selections allow you to do so. At the time of writing, Mapbox does not advertise permission to hide attribution. MapTiler allows hiding of the logo for paid subscriptions, but still requires the attribution unless a special license has been granted. - `Mapbox Attribution Guidelines `_ - `MapTiler Attribution Guidelines `_ Show Map Center ^^^^^^^^^^^^^^^ Display an icon at the center of the map. Show Range Folding when Smoothing Radar Data ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ When smoothing radar data, the transition between range folded values and other values can have a strong gradient. To prevent this from occurring, range folding is by default hidden while smoothing, but this can be turned back on. *Range folding hidden* .. image:: images/settings-general-06-smoothed-range-folding-off.png *Range folding displayed* .. image:: images/settings-general-06-smoothed-range-folding-on.png Update Notifications Enabled ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Notify the user of updates to Supercell Wx. Debug Enabled ^^^^^^^^^^^^^ Enables the **Debug** options menu. Palettes -------- Color Tables ^^^^^^^^^^^^ The map and radar display have multiple customization options, including color tables. The default color tables come from `NOAA's Weather and Climate Toolkit `_, but can be modified from the **Palettes** category in the **Settings** dialog. Color tables are compatible with the `GRLevelX `_ `Color Table File Specification `_. .. image:: images/settings-palette-01-color-tables.png Additional color tables can be found at a number of sites, including: - https://grlevelxusers.com/grlevelx-goodies/categories/color-tables/ - https://www.wxtools.org/ Alerts ^^^^^^ In addition to color tables, alert colors can also be modified. First, select the Phenomenon from the list. Next, select the adjacent tool button next to the Category. .. image:: images/settings-palette-02-alerts.png Use the text boxes to specify a colors in ARGB hexadecimal format (#aarrggbb), or use the color pickers to select a color. Adjust the width value to customize the appearance of the line further. .. image:: images/settings-palette-03-edit-line.png Units ----- Units displayed in Supercell Wx for both radar products and dialogs can be configured from the **Units** tab. Standard, metric, and other units are available, as well as a **User-defined** selection. With **User-defined** selected, radar product units will be determined based on the **Scale**, **Offset** and **Units** fields defined in the color table for each applicable product. .. image:: images/settings-units-01.png Audio ----- Audio notifications can be selectively enabled for alerts from the **Audio** tab. .. image:: images/settings-audio-01.png Sound ^^^^^ By default, the two-tone Attention Signal used by the Emergency Alert System is played when a new or updated alert occurs for the selected location. An alternate audio file can be selected and sampled using the buttons to the right of the file path. Radius ^^^^^^ For Fixed, Track, and Radar Site location methods, an audio notification will be triggered whenever an alert is within the selected radius of the given location. Setting the radius to 0 will only trigger a notification when the location is inside the alert. Location Method ^^^^^^^^^^^^^^^ Fixed """"" The **Fixed** location method will allow the user to manually enter a latitude and longitude for alert audio notificatons. Track """"" When using the **Track** location method, Supercell Wx will request location information from the operating system. This may result in the operating system notifying the user that Supercell Wx is using location information. Radar Site """""""""" The **Radar Site** location method will enable alerts issued within a selected radius from the selected Radar Site. In addition to selecting a radar site, two special values can be selected. - With Radar Site set to **default**, the default radar site will always be used when determining whether to play an alert sound. - With Radar Site set to **follow**, the currently selected radar site will be used when determining whether to play an alert sound. County """""" With the **County** location method, the user can select a county. Pressing the adjacent tool button will open a county selection dialog. .. image:: images/settings-audio-02-county.png WFO """ With the **WFO** location method, the user can select a Weather Forecast Office. Pressing the adjacent tool button will open a WFO selection dialog. .. image:: images/settings-audio-03-wfo.png All """ With the **All** location method, alert audio notifications will be played for any location. Text ---- Under the text menu, the user is given several different customization options to adjust the font and style to the user's liking. .. image:: images/settings-text-01.png Choosing the font ^^^^^^^^^^^^^^^^^^ The user can select the font they'd like to use by choosing either the default display item or the tooltip display item, and then hitting the 3 dots next to the font name. .. image:: images/settings-text-02-select-font.png *Choose the font, font style, font size, effects and writing system* .. image:: images/settings-text-03-select-font.png Tooltip method ^^^^^^^^^^^^^^ The tooltip method allows the user to change the method used for which pop-ups are displayed. The user is also able to change the character wrap size if the text from placefiles appear to be too long on the user's screen. *Tooltip methods* .. image:: images/settings-text-04-tooltip-method.png *Character wrap and placefile text drop shadow* .. image:: images/settings-text-05-character-wrap.png *Radar Site Hover Text Enabled* Enables or disables a description of each radar site when hovered over. Hotkeys ------- Hotkey shortcuts can be configured from the **Hotkeys** tab. This allows the customization and control of Supercell Wx using the keyboard for most common functions. .. image:: images/settings-hotkeys-01.png