setunit_to_unit()

Converts a value from the unit set in system settings to the current G-code unit (G20 for inches, G21 for millimeters).

setunit_to_unit(value)

• The equivalent value in the current G-code unit.
• If the system unit matches the current G-code unit, the value remains unchanged.
• If the system is set to millimeters and the G-code unit is inches, the value is converted from millimeters to inches.
• If the system is set to inches and the G-code unit is millimeters, the value is converted from inches to millimeters.

Convert 1 inch to G-code units

setunit_to_unit(1);  // returns 25.4 if G21 (mm), 1 if G20 (inches)

Convert 100 mm to G-code units

setunit_to_unit(100);  // returns 3.937 if G20 (inches), 100 if G21 (mm)

Pseudocode:

if (_set_units == _units)
  return value;
else if (_set_units == inches)
  return value * 25.4;
else if (_set_units == millimeters)
  return value / 25.4;

mm_to_unit
unit_to_mm

mm_to_setunit
setunit_to_mm

unit_to_setunit
setunit_to_unit

setunit