From 4284b86ba96ed188904a7c77cd4e909a68740669 Mon Sep 17 00:00:00 2001 From: Adrian Mariano Date: Tue, 28 May 2024 19:55:21 -0400 Subject: [PATCH] doc tweak --- attachments.scad | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/attachments.scad b/attachments.scad index 82b9066..f7d4311 100644 --- a/attachments.scad +++ b/attachments.scad @@ -779,7 +779,7 @@ function _make_anchor_legal(anchor,geom) = // . // If you give `inside=true` then the anchor arrows are lined up so they are pointing the same direction and // the child object will be located inside the parent. In this case a default "remove" tag is applied to -// the children. +// the children. // . // Because the attachment process forces an orientation and anchor point for the child, it overrides // any such specifications you give to the child: **both `anchor=` and `orient=` given to the child are @@ -797,10 +797,17 @@ function _make_anchor_legal(anchor,geom) = // These options will probably be necessary, in fact, to get the child correctly positioned. Note that // giving `spin=` to `attach()` in this case is the same as applying `zrot()` to the child. // . -// Attached children may be ovarlapped into the parent a bit, as given by the `$overlap` value +// You can overlap attached children into the parent by giving the `$overlap` value // which is 0 by default, or by the `overlap=` argument. This is to prevent OpenSCAD // from making non-manifold objects. You can define `$overlap=` as an argument in a parent -// module to set the default for all attachments to it. +// module to set the default for all attachments to it. When you give `inside=true`, a positive overlap +// value shifts the child object outward. +// . +// If you specify an `inset=` value then the child is shifted away from any edges it is aligned to, towards the middle +// of the parent. The `shiftout=` parameter is intended to simplify differences with aligned objects +// placed inside the parent. It will shift the child outward along every direction where it is aligned with +// the parent. For an inside child this is equivalent to giving a positive overlap and negative inset value. +// For a child with `inside=false` it is equivalent to a negative overlap and negative inset. // . // For a step-by-step explanation of // attachments, see the [Attachments Tutorial](Tutorial-Attachments).