Acknowledged

Provide polyfill where needed in Toybox.Graphics.Dc API

Basically, there should be no "[view]" sections below any of Dc methods in the docs.

The context is as follows:

I really don't understand the thought process behind adding a DC method that is supported on just some devices.

What does Garmin expect to happen when someone arrives at a need to use, say, setFill(bitmap) and it's not supported on some (seemingly random) models?

It's not like my need to tile an area with a bitmap will suddenly go away because setFill is not available on VA5. Nor will I want to dumb down the design for some models. Some people might consider that OK, but imnsho that's an amateurish hackery.

The only thing that will happen, realistically, is that I will be re-implementing setFill() for devices that don't have it, i.e. I will be making a homebrew polyfill.

To put differently, these new and shiny API methods are effectively useless, unless someone just happens to be targeting specific models supported by them.

It's never the " Let's look what supports setFill and that will be our target model list ! "

It's always the " We want to do X, let's see if the API supports it for the devices we target ".

Parents
  • e.g. If an API method's documentation says something like "Since: API Level 4.2.1":

    - The dev needs to use an SDK that supports API 4.2.1 (otherwise the code probably won't compile or run in the sim.)

    - The device also needs to have firmware that supports (at least) CIQ 4.2.1

    Ofc the first point can easily be glossed over by always using the latest available SDK as a rule (unless it has a known bug, I guess.) So really, "Since: API Level X" just collapses to "your device needs to support CIQ version X".

Comment
  • e.g. If an API method's documentation says something like "Since: API Level 4.2.1":

    - The dev needs to use an SDK that supports API 4.2.1 (otherwise the code probably won't compile or run in the sim.)

    - The device also needs to have firmware that supports (at least) CIQ 4.2.1

    Ofc the first point can easily be glossed over by always using the latest available SDK as a rule (unless it has a known bug, I guess.) So really, "Since: API Level X" just collapses to "your device needs to support CIQ version X".

Children
No Data