Gimp.range_estimate_settings

function range_estimate_settings(lower: Number(gdouble), upper: Number(gdouble)): [step: Number(gdouble), page: Number(gdouble), digits: Number(gint)] {
    // Gjs wrapper for gimp_range_estimate_settings()
}
  

This function proposes reasonable settings for increments and display digits. These can be used for instance on Gtk.Range or other widgets using a Gtk.Adjustment typically. Note that it will never return digits with value 0. If you know that your input needs to display integer values, there is no need to set digits.

There is no universal answer to the best increments and number of decimal places. It often depends on context of what the value is meant to represent. This function only tries to provide sensible generic values which can be used when it doesn't matter too much or for generated GUI for instance. If you know exactly how you want to show and interact with a given range, you don't have to use this function.

lower

the lower value.

upper

the higher value.

step

the proposed step increment.

page

the proposed page increment.

digits

the proposed decimal places precision.