Various Garmin Device Properties Reference

Frustrated at the minimal columns in the official Device Reference, with the assistance of AI I made a little script to extract various things from the simulator data files. For me I was most interested in the Menu2 title and icon dimensions. I've shared this extended reference via Google Sheets.

  • On real devices where you can set the text size, this could be different when it comes to System views like Menu2

    I don't see a way in the sim to change this so you won't see it there

  • Not really sure what you're getting at here tbh.

  • What I'm saying is what you see for the sim isn't what the values for menu2 are on a real device may be, based on the user setting for the font height set for native stuff.  The fonts you use in your app don't change, but they do in System views like Menu2.

    What real watch do you use?  Look under Settings>Display to see if it has that option.  On some you can only change the text from regular to large, with some you can set a bunch of sizes.

  • I only have an Edge 530, which doesn't appear to have text size settings. Are you saying the Menu2 title rectangle and icon dimensions change on real devices, based on the text size setting?

  • Based on what the user sets for text size, yes.  This is only available on newer device and maybe only watches.

  • Seems mental that changing a text size setting would change the other dimensions too, but OK. Oh well, the reference is probably still useful as a guideline at least.

  • With a smaller text height, more menu items fit on the screen so it makes sense that what's used for the dimensions of the menu2 items also change.

  • TL;DR

    - it's in the sim at Settings > Enhanced Readability Mode [on/off] (same as Display > Large Fonts on FR955)

    - it's in the API at DeviceSettings.isEnhancedReadabilityModeEnabled and AppBase.onEnhancedReadabilityModeChanged

    - on a real FR955 at least, changing Large Fonts doesn't affect the size of the menu title rectangle or the menu icon size

    - In the sim, changing this setting doesn't affect the text size of Menu2, but of course it does on a real device

    - the point of having isEnhancedReadabilityModeEnabled in the API is so that you can write your app to increase its font size if the user enables Large Fonts on the device 

    I don't see a way in the sim to change this so you won't see it there

    It's in the sim: Settings > Enhanced Readability Mode. This is a checkbox that can be toggled on or off, and it's off by default. It's greyed out for devices that don't support it. This setting corresponds to Display > Large Fonts on some newer devices, like FR955.

    The corresponding flag in the Connect IQ API is DeviceSettings.isEnhancedReadabilityModeEnabled. There is also an event handler to notify the app when this flag changes: AppBase.onEnhancedReadabilityModeChanged

    I will say that at least on a real FR955, the size of a native menu title rectangle does not visibly change when large fonts is enabled, and the size of native icons remains unchanged (although the text does get bigger, of course). I tested this by looking at the native "global" settings menu.

    In the simulator, enabling enhanced readability mode does not even change the text size of a Menu2, which indicates to me that it's another case where the sim doesn't follow the behaviour of a real device. It seems that the toggle in the sim only exists for devs to test the behaviour of any code of their own which depends on DeviceSettings.isEnhancedReadabilityModeEnabled.

    Before you say enhanced readability mode is not the same thing as large fonts, you said that years ago when someone else mentioned it, but back then I confirmed that it is the same thing, on a real FR955. To be clear, on a real FR955, the isEnhanceReadabilityModeEnabled field follows the value of Display > Large Fonts.

    Like it or not, Garmin often uses different names for the same thing.

    e.g.

    - Large Fonts (device UI) | Enhanced Readability Mode (CIQ)

    - SatIQ (marketing, CIQ) | Satellites > Auto Select (device UI) 

  • I already have a python script that extracts data from the compiler, simulator json files, and it also generates monkey.jungle based on the data: https://github.com/flocsy/garmin-dev-tools/tree/main/monkey-generator The documentation arguably needs some improvements though.

  • - on a real FR955 at least, changing Large Fonts doesn't affect the size of the menu title rectangle or the menu icon size

    You may want to check the current generation, not one that's a few years old.  The 570 isn't just normal and large, where you can make the font smaller or larger than "normal" and these this do adjust to the different fonts. (it's a slider to set the size)