xcyl(), ycyl(), zcyl() pass through all parameters to cyl()

shapes3d.scad

@@ -2516,49 +2516,25 @@ module cyl(
 
 
 
-// Module: xcyl()
+// Function&Module: xcyl()
-// Synopsis: creates a cylinder oriented along the X axis.
+// Synopsis: Creates a cylinder oriented along the X axis.
-// SynTags: Geom
+// SynTags: Geom, VNF
 // Topics: Cylinders, Textures, Rounding, Chamfers
 // See Also: texture(), rotate_sweep(), cyl()
-// Description:
-//   Creates an attachable cylinder with roundovers and chamfering oriented along the X axis.
-//
 // Usage: Typical
 //   xcyl(l|h|length|height, r|d=, [anchor=], ...) [ATTACHMENTS];
 //   xcyl(l|h|length|height, r1=|d1=, r2=|d2=, [anchor=], ...) [ATTACHMENTS];
-//
+// Description:
-// Arguments:
+//   Creates an attachable cylinder with roundovers, chamfering, and optional texture, oriented along the X axis.
-//   l / h / length / height = Length of cylinder along oriented axis. Default: 1
+//   .
-//   r = Radius of cylinder.  Default: 1
+//   This is a shortcut for `cyl()` with `orient=RIGHT`, but otherwise using the same arguments.
-//   ---
+//   .
-//   r1 = Optional radius of left (X-) end of cylinder.
+//   See [cyl()] for more detailed usage and arguments.
-//   r2 = Optional radius of right (X+) end of cylinder.
-//   d = Optional diameter of cylinder. (use instead of `r`)
-//   d1 = Optional diameter of left (X-) end of cylinder.
-//   d2 = Optional diameter of right (X+) end of cylinder.
-//   circum = If true, cylinder should circumscribe the circle of the given size.  Otherwise inscribes.  Default: `false`
-//   chamfer = The size of the chamfers on the ends of the cylinder.  Default: none.
-//   chamfer1 = The size of the chamfer on the left end of the cylinder.  Default: none.
-//   chamfer2 = The size of the chamfer on the right end of the cylinder.  Default: none.
-//   chamfang = The angle in degrees of the chamfers on the ends of the cylinder.
-//   chamfang1 = The angle in degrees of the chamfer on the left end of the cylinder.
-//   chamfang2 = The angle in degrees of the chamfer on the right end of the cylinder.
-//   from_end = If true, chamfer is measured from the end of the cylinder, instead of inset from the edge.  Default: `false`.
-//   rounding = The radius of the rounding on the ends of the cylinder.  Default: none.
-//   rounding1 = The radius of the rounding on the left end of the cylinder.
-//   rounding2 = The radius of the rounding on the right end of the cylinder.
-//   realign = If true, rotate the cylinder by half the angle of one face.
-//   anchor = Translate so anchor point is at origin (0,0,0).  See [anchor](attachments.scad#subsection-anchor).  Default: `CENTER`
-//   spin = Rotate this many degrees around the Z axis after anchor.  See [spin](attachments.scad#subsection-spin).  Default: `0`
-//   orient = Vector to rotate top towards, after spin.  See [orient](attachments.scad#subsection-orient).  Default: `UP`
-//
 // Example: By Radius
 //   ydistribute(50) {
 //       xcyl(l=35, r=10);
 //       xcyl(l=35, r1=15, r2=5);
 //   }
-//
 // Example: By Diameter
 //   ydistribute(50) {
 //       xcyl(l=35, d=20);
@@ -2566,82 +2542,98 @@ module cyl(
 //   }
 
 function xcyl(
-    h, r, d, r1, r2, d1, d2, l, 
+    h, r, center,
+    l, r1, r2,
+    d, d1, d2,
+    length, height,
     chamfer, chamfer1, chamfer2,
     chamfang, chamfang1, chamfang2,
     rounding, rounding1, rounding2,
-    circum=false, realign=false, from_end=false, length, height,
+    circum=false, realign=false, shift=[0,0],
-    anchor=CENTER, spin=0, orient=UP
+    teardrop=false, clip_angle,
-) = no_function("xcyl");
+    from_end, from_end1, from_end2,
+    texture, tex_size=[5,5], tex_reps, tex_counts,
+    tex_inset=false, tex_rot=0,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin=0
+) = cyl(h, r, center,
+    l, r1, r2,
+    d, d1, d2,
+    length, height,
+    chamfer, chamfer1, chamfer2,
+    chamfang, chamfang1, chamfang2,
+    rounding, rounding1, rounding2,
+    circum, realign, shift,
+    teardrop, clip_angle,
+    from_end, from_end1, from_end2,
+    texture, tex_size, tex_reps, tex_counts,
+    tex_inset, tex_rot,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin, orient=RIGHT);
 
 module xcyl(
-    h, r, d, r1, r2, d1, d2, l, 
+    h, r, center,
+    l, r1, r2,
+    d, d1, d2,
     chamfer, chamfer1, chamfer2,
     chamfang, chamfang1, chamfang2,
     rounding, rounding1, rounding2,
-    circum=false, realign=false, from_end=false, length, height,
+    circum=false, realign=false, shift=[0,0],
-    anchor=CENTER, spin=0, orient=UP
+    teardrop=false, clip_angle,
+    from_end, from_end1, from_end2,
+    texture, tex_size=[5,5], tex_reps, tex_counts,
+    tex_inset=false, tex_rot=0,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin=0
 ) {
     r1 = get_radius(r1=r1, r=r, d1=d1, d=d, dflt=1);
     r2 = get_radius(r1=r2, r=r, d1=d2, d=d, dflt=1);
     l = one_defined([l,h,length,height],"l,h,length,height",1);
-    attachable(anchor,spin,orient, r1=r1, r2=r2, l=l, axis=RIGHT) {
+    attachable(anchor,spin,orient=UP, r1=r1, r2=r2, l=l, axis=RIGHT) {
         cyl(
-            l=l, r1=r1, r2=r2,
+            undef, undef, center, // h,r,center
-            chamfer=chamfer, chamfer1=chamfer1, chamfer2=chamfer2,
+            l, r1, r2,
-            chamfang=chamfang, chamfang1=chamfang1, chamfang2=chamfang2,
+            undef, undef, undef,  // d,d1,d2
-            rounding=rounding, rounding1=rounding1, rounding2=rounding2,
+            chamfer, chamfer1, chamfer2,
-            circum=circum, realign=realign, from_end=from_end,
+            chamfang, chamfang1, chamfang2,
-            anchor=CENTER, orient=RIGHT
+            rounding, rounding1, rounding2,
+            circum, realign, shift,
+            teardrop, clip_angle,
+            from_end, from_end1, from_end2,
+            texture, tex_size, tex_reps, tex_counts,
+            tex_inset, tex_rot,
+            tex_scale, tex_depth, tex_samples, length, height, 
+            tex_taper, style, tex_style,
+            extra, extra1, extra2, 
+            anchor, spin, orient=RIGHT
         );
         children();
     }
 }
 
 
-// Module: ycyl()
+// Function&Module: ycyl()
 // Synopsis: Creates a cylinder oriented along the y axis.
-// SynTags: Geom
+// SynTags: Geom, VNF
 // Topics: Cylinders, Textures, Rounding, Chamfers
 // See Also: texture(), rotate_sweep(), cyl()
 // Description:
-//   Creates an attachable cylinder with roundovers and chamfering oriented along the y axis.
+//   Creates an attachable cylinder with roundovers, chamfering, and optional texture, oriented along the Y axis.
-//
+//   .
-// Usage: Typical
+//   This is a shortcut for `cyl()` with `orient=BACK`, but otherwise using the same arguments.
-//   ycyl(l|h|length|height, r|d=, [anchor=], ...) [ATTACHMENTS];
+//   .
-//   ycyl(l|h|length|height, r1=|d1=, r2=|d2=, [anchor=], ...) [ATTACHMENTS];
+//   See [cyl()] for more detailed usage and arguments.
-//
-// Arguments:
-//   l / h / length / height = Length of cylinder along oriented axis. (Default: `1.0`)
-//   r = Radius of cylinder.
-//   ---
-//   r1 = Radius of front (Y-) end of cone.
-//   r2 = Radius of back (Y+) end of one.
-//   d = Diameter of cylinder.
-//   d1 = Diameter of front (Y-) end of one.
-//   d2 = Diameter of back (Y+) end of one.
-//   circum = If true, cylinder should circumscribe the circle of the given size.  Otherwise inscribes.  Default: `false`
-//   chamfer = The size of the chamfers on the ends of the cylinder.  Default: none.
-//   chamfer1 = The size of the chamfer on the front end of the cylinder.  Default: none.
-//   chamfer2 = The size of the chamfer on the back end of the cylinder.  Default: none.
-//   chamfang = The angle in degrees of the chamfers on the ends of the cylinder.
-//   chamfang1 = The angle in degrees of the chamfer on the front end of the cylinder.
-//   chamfang2 = The angle in degrees of the chamfer on the back end of the cylinder.
-//   from_end = If true, chamfer is measured from the end of the cylinder, instead of inset from the edge.  Default: `false`.
-//   rounding = The radius of the rounding on the ends of the cylinder.  Default: none.
-//   rounding1 = The radius of the rounding on the front end of the cylinder.
-//   rounding2 = The radius of the rounding on the back end of the cylinder.
-//   realign = If true, rotate the cylinder by half the angle of one face.
-//   anchor = Translate so anchor point is at origin (0,0,0).  See [anchor](attachments.scad#subsection-anchor).  Default: `CENTER`
-//   spin = Rotate this many degrees around the Z axis after anchor.  See [spin](attachments.scad#subsection-spin).  Default: `0`
-//   orient = Vector to rotate top towards, after spin.  See [orient](attachments.scad#subsection-orient).  Default: `UP`
-//
 // Example: By Radius
 //   xdistribute(50) {
 //       ycyl(l=35, r=10);
 //       ycyl(l=35, r1=15, r2=5);
 //   }
-//
 // Example: By Diameter
 //   xdistribute(50) {
 //       ycyl(l=35, d=20);
@@ -2649,84 +2641,99 @@ module xcyl(
 //   }
 
 function ycyl(
-    h, r, d, r1, r2, d1, d2, l,
+    h, r, center,
+    l, r1, r2,
+    d, d1, d2,
+    length, height,
     chamfer, chamfer1, chamfer2,
     chamfang, chamfang1, chamfang2,
     rounding, rounding1, rounding2,
-    circum=false, realign=false, from_end=false,height,length,
+    circum=false, realign=false, shift=[0,0],
-    anchor=CENTER, spin=0, orient=UP
+    teardrop=false, clip_angle,
-) = no_function("ycyl");
+    from_end, from_end1, from_end2,
+    texture, tex_size=[5,5], tex_reps, tex_counts,
+    tex_inset=false, tex_rot=0,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin=0
+) = cyl(h, r, center,
+    l, r1, r2,
+    d, d1, d2,
+    length, height,
+    chamfer, chamfer1, chamfer2,
+    chamfang, chamfang1, chamfang2,
+    rounding, rounding1, rounding2,
+    circum, realign, shift,
+    teardrop, clip_angle,
+    from_end, from_end1, from_end2,
+    texture, tex_size, tex_reps, tex_counts,
+    tex_inset, tex_rot,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin, orient=BACK);
 
 
 module ycyl(
-    h, r, d, r1, r2, d1, d2, l,
+    h, r, center,
+    l, r1, r2,
+    d, d1, d2,
     chamfer, chamfer1, chamfer2,
     chamfang, chamfang1, chamfang2,
     rounding, rounding1, rounding2,
-    circum=false, realign=false, from_end=false,height,length,
+    circum=false, realign=false, shift=[0,0],
-    anchor=CENTER, spin=0, orient=UP
+    teardrop=false, clip_angle,
+    from_end, from_end1, from_end2,
+    texture, tex_size=[5,5], tex_reps, tex_counts,
+    tex_inset=false, tex_rot=0,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin=0
 ) {
     r1 = get_radius(r1=r1, r=r, d1=d1, d=d, dflt=1);
     r2 = get_radius(r1=r2, r=r, d1=d2, d=d, dflt=1);
     l = one_defined([l,h,length,height],"l,h,length,height",1);
-    attachable(anchor,spin,orient, r1=r1, r2=r2, l=l, axis=BACK) {
+    attachable(anchor,spin,orient=UP, r1=r1, r2=r2, l=l, axis=BACK) {
         cyl(
-            l=l, r1=r1, r2=r2,
+            undef, undef, center, // h,r,center
-            chamfer=chamfer, chamfer1=chamfer1, chamfer2=chamfer2,
+            l, r1, r2,
-            chamfang=chamfang, chamfang1=chamfang1, chamfang2=chamfang2,
+            undef, undef, undef,  // d,d1,d2
-            rounding=rounding, rounding1=rounding1, rounding2=rounding2,
+            chamfer, chamfer1, chamfer2,
-            circum=circum, realign=realign, from_end=from_end,
+            chamfang, chamfang1, chamfang2,
-            anchor=CENTER, orient=BACK
+            rounding, rounding1, rounding2,
+            circum, realign, shift,
+            teardrop, clip_angle,
+            from_end, from_end1, from_end2,
+            texture, tex_size, tex_reps, tex_counts,
+            tex_inset, tex_rot,
+            tex_scale, tex_depth, tex_samples, length, height, 
+            tex_taper, style, tex_style,
+            extra, extra1, extra2, 
+            anchor, orient=BACK
         );
         children();
     }
 }
 
 
-
 // Module: zcyl()
-// Synopsis: Creates a cylinder oriented along the Z axis.
+// Synopsis: Creates a cylinder oriented along the y axis.
-// SynTags: Geom
+// SynTags: Geom, VNF
 // Topics: Cylinders, Textures, Rounding, Chamfers
 // See Also: texture(), rotate_sweep(), cyl()
 // Description:
-//   Creates an attachable cylinder with roundovers and chamfering oriented along the Z axis.
+//   Pass-through to [cyl()]. Creates an attachable cylinder with roundovers, chamfering, and optional texture, oriented along the Z axis.
-//
+//   .
-// Usage: Typical
+//   This is a shortcut for `cyl()` with `orient=UP` (which is also the default for [cyl()]), but otherwise using the same arguments.
-//   zcyl(l|h|length|height, r|d=, [anchor=],...) [ATTACHMENTS];
+//   .
-//   zcyl(l|h|length|height, r1=|d1=, r2=|d2=, [anchor=],...);
+//   See [cyl()] for more detailed usage and arguments.
-//
-// Arguments:
-//   l / h / length / height = Length of cylinder along oriented axis. (Default: 1.0)
-//   r = Radius of cylinder.
-//   ---
-//   r1 = Radius of front (Y-) end of cone.
-//   r2 = Radius of back (Y+) end of one.
-//   d = Diameter of cylinder.
-//   d1 = Diameter of front (Y-) end of one.
-//   d2 = Diameter of back (Y+) end of one.
-//   circum = If true, cylinder should circumscribe the circle of the given size.  Otherwise inscribes.  Default: `false`
-//   chamfer = The size of the chamfers on the ends of the cylinder.  Default: none.
-//   chamfer1 = The size of the chamfer on the bottom end of the cylinder.  Default: none.
-//   chamfer2 = The size of the chamfer on the top end of the cylinder.  Default: none.
-//   chamfang = The angle in degrees of the chamfers on the ends of the cylinder.
-//   chamfang1 = The angle in degrees of the chamfer on the bottom end of the cylinder.
-//   chamfang2 = The angle in degrees of the chamfer on the top end of the cylinder.
-//   from_end = If true, chamfer is measured from the end of the cylinder, instead of inset from the edge.  Default: `false`.
-//   rounding = The radius of the rounding on the ends of the cylinder.  Default: none.
-//   rounding1 = The radius of the rounding on the bottom end of the cylinder.
-//   rounding2 = The radius of the rounding on the top end of the cylinder.
-//   realign = If true, rotate the cylinder by half the angle of one face.
-//   anchor = Translate so anchor point is at origin (0,0,0).  See [anchor](attachments.scad#subsection-anchor).  Default: `CENTER`
-//   spin = Rotate this many degrees around the Z axis after anchor.  See [spin](attachments.scad#subsection-spin).  Default: `0`
-//   orient = Vector to rotate top towards, after spin.  See [orient](attachments.scad#subsection-orient).  Default: `UP`
-//
 // Example: By Radius
 //   xdistribute(50) {
 //       zcyl(l=35, r=10);
 //       zcyl(l=35, r1=15, r2=5);
 //   }
-//
 // Example: By Diameter
 //   xdistribute(50) {
 //       zcyl(l=35, d=20);
@@ -2734,33 +2741,76 @@ module ycyl(
 //   }
 
 function zcyl(
-    h, r, d, r1, r2, d1, d2, l,
+    h, r, center,
+    l, r1, r2,
+    d, d1, d2,
+    length, height,
     chamfer, chamfer1, chamfer2,
     chamfang, chamfang1, chamfang2,
     rounding, rounding1, rounding2,
-    circum=false, realign=false, from_end=false, length, height,
+    circum=false, realign=false, shift=[0,0],
-    anchor=CENTER, spin=0, orient=UP
+    teardrop=false, clip_angle,
-) = no_function("zcyl");
+    from_end, from_end1, from_end2,
+    texture, tex_size=[5,5], tex_reps, tex_counts,
+    tex_inset=false, tex_rot=0,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin=0
+) = cyl(h, r, center,
+    l, r1, r2,
+    d, d1, d2,
+    length, height,
+    chamfer, chamfer1, chamfer2,
+    chamfang, chamfang1, chamfang2,
+    rounding, rounding1, rounding2,
+    circum, realign, shift,
+    teardrop, clip_angle,
+    from_end, from_end1, from_end2,
+    texture, tex_size, tex_reps, tex_counts,
+    tex_inset, tex_rot,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin, orient=UP);
 
 module zcyl(
-    h, r, d, r1, r2, d1, d2, l,
+    h, r, center,
+    l, r1, r2,
+    d, d1, d2,
     chamfer, chamfer1, chamfer2,
     chamfang, chamfang1, chamfang2,
     rounding, rounding1, rounding2,
-    circum=false, realign=false, from_end=false, length, height,
+    circum=false, realign=false, shift=[0,0],
-    anchor=CENTER, spin=0, orient=UP
+    teardrop=false, clip_angle,
+    from_end, from_end1, from_end2,
+    texture, tex_size=[5,5], tex_reps, tex_counts,
+    tex_inset=false, tex_rot=0,
+    tex_scale, tex_depth, tex_samples, length, height, 
+    tex_taper, style, tex_style,
+    extra, extra1, extra2, 
+    anchor, spin=0
 ) {
     r1 = get_radius(r1=r1, r=r, d1=d1, d=d, dflt=1);
     r2 = get_radius(r1=r2, r=r, d1=d2, d=d, dflt=1);
     l = one_defined([l,h,length,height],"l,h,length,height",1);
-    attachable(anchor,spin,orient, r1=r1, r2=r2, l=l) {
+    attachable(anchor,spin,orient=UP, r1=r1, r2=r2, l=l) {
         cyl(
-            l=l, r1=r1, r2=r2,
+            undef, undef, center, // h,r,center
-            chamfer=chamfer, chamfer1=chamfer1, chamfer2=chamfer2,
+            l, r1, r2,
-            chamfang=chamfang, chamfang1=chamfang1, chamfang2=chamfang2,
+            undef, undef, undef,  // d,d1,d2
-            rounding=rounding, rounding1=rounding1, rounding2=rounding2,
+            chamfer, chamfer1, chamfer2,
-            circum=circum, realign=realign, from_end=from_end,
+            chamfang, chamfang1, chamfang2,
-            anchor=CENTER
+            rounding, rounding1, rounding2,
+            circum, realign, shift,
+            teardrop, clip_angle,
+            from_end, from_end1, from_end2,
+            texture, tex_size, tex_reps, tex_counts,
+            tex_inset, tex_rot,
+            tex_scale, tex_depth, tex_samples, length, height, 
+            tex_taper, style, tex_style,
+            extra, extra1, extra2, 
+            anchor, orient=UP
         );
         children();
     }