docs: update BED_MESH_OFFSET description

Add the ZFADE parameter to the documentation.

Signed-off-by:  Eric Callahan <arksine.code@gmail.com>
This commit is contained in:
Eric Callahan 2024-02-06 11:19:03 -05:00 committed by KevinOConnor
parent 0cd16e956d
commit 0aaabf1904
2 changed files with 17 additions and 7 deletions

View File

@ -542,11 +542,19 @@ This gcode may be used to clear the internal mesh state.
### Apply X/Y offsets ### Apply X/Y offsets
`BED_MESH_OFFSET [X=<value>] [Y=<value>]` `BED_MESH_OFFSET [X=<value>] [Y=<value>] [ZFADE=<value>]`
This is useful for printers with multiple independent extruders, as an offset This is useful for printers with multiple independent extruders, as an offset
is necessary to produce correct Z adjustment after a tool change. Offsets is necessary to produce correct Z adjustment after a tool change. Offsets
should be specified relative to the primary extruder. That is, a positive should be specified relative to the primary extruder. That is, a positive
X offset should be specified if the secondary extruder is mounted to the X offset should be specified if the secondary extruder is mounted to the
right of the primary extruder, and a positive Y offset should be specified right of the primary extruder, a positive Y offset should be specified
if the secondary extruder is mounted "behind" the primary extruder. if the secondary extruder is mounted "behind" the primary extruder, and
a positive ZFADE offset should be specified if the secondary extruder's
nozzle is above the primary extruder's.
Note that a ZFADE offset does *NOT* directly apply additional adjustment. It
is intended to compensate for a `gcode offset` when [mesh fade](#mesh-fade)
is enabled. For example, if a secondary extruder is higher than the primary
and needs a negative gcode offset, ie: `SET_GCODE_OFFSET Z=-.2`, it can be
accounted for in `bed_mesh` with `BED_MESH_OFFSET ZFADE=.2`.

View File

@ -184,10 +184,12 @@ SAVE_CONFIG gcode must be run to make the changes to persistent memory
permanent. permanent.
#### BED_MESH_OFFSET #### BED_MESH_OFFSET
`BED_MESH_OFFSET [X=<value>] [Y=<value>]`: Applies X and/or Y offsets `BED_MESH_OFFSET [X=<value>] [Y=<value>] [ZFADE=<value]`: Applies X, Y,
to the mesh lookup. This is useful for printers with independent and/or ZFADE offsets to the mesh lookup. This is useful for printers with
extruders, as an offset is necessary to produce correct Z adjustment independent extruders, as an offset is necessary to produce correct Z
after a tool change. adjustment after a tool change. Note that a ZFADE offset does not apply
additional z-adjustment directly, it is used to correct the `fade`
calculation when a `gcode offset` has been applied to the Z axis.
### [bed_screws] ### [bed_screws]