From 6af13a2a0d34a1c1c837b0d851a7753a01697d8b Mon Sep 17 00:00:00 2001 From: Garth Minette Date: Mon, 4 Oct 2021 19:11:22 -0700 Subject: [PATCH] Fixed up docs for stroke() --- drawing.scad | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/drawing.scad b/drawing.scad index 7282fe9..a619e7b 100644 --- a/drawing.scad +++ b/drawing.scad @@ -19,7 +19,10 @@ // stroke(path, [width], [closed], [endcap1], [endcap2], [endcap_width1], [endcap_width2], [endcap_length1], [endcap_length2], [endcap_extent1], [endcap_extent2], [trim1], [trim2]); // Topics: Paths (2D), Paths (3D), Drawing Tools // Description: -// Draws a 2D or 3D path with a given line width. Endcaps can be specified for each end individually. +// Draws a 2D or 3D path with a given line width. Joints and each endcap can be replaced with +// various marker shapes, and can be assigned different colors. If passed a region instead of +// a path, draws each path in the region as a closed polygon by default. If `closed=false` is +// given with a region, each subpath is drawn as an un-closed line path. // Figure(Med,NoAxes,2D,VPR=[0,0,0],VPD=250): Endcap Types // cap_pairs = [ // ["butt", "chisel" ], @@ -128,9 +131,20 @@ // color="lightgreen", joint_color="red", endcap_color="blue", // joint_width=2.0, endcap_width2=3, $fn=18 // ); -// Example: Simplified Plotting +// Example(2D): Simplified Plotting // path = [for (i=[0:15:360]) [(i-180)/3,20*cos(2*i)]]; // stroke(path, width=2, dots=true, color="lightgreen", dots_color="red", $fn=18); +// Example(2D): Drawing a Region +// rgn = [square(100,center=true), circle(d=60,$fn=18)]; +// stroke(rgn, width=2); +// Example(2D): Drawing a List of Lines +// paths = [ +// for (y=[-60:60:60]) [ +// for (a=[-180:15:180]) +// [a, 2*y+60*sin(a+y)] +// ] +// ]; +// stroke(paths, closed=false, width=5); function stroke( path, width=1, closed, endcaps, endcap1, endcap2, joints, dots,