grey/BOSL2
1
0
Fork 0
mirror of https://github.com/BelfrySCAD/BOSL2.git synced 2024-12-29 16:29:40 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Synopses - regions.scad part 1

Browse source
This commit is contained in:
Richard Milewski 2023-04-04 22:42:34 -07:00
parent ed367099b3
commit 06c78ab9c4
1 changed files with 20 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
regions.scad
View file

@ -43,6 +43,9 @@
// Function: is_region() // Function: is_region()
// Synopsis: Returns true if the input appears to be a region.
// Topics: Regions, Paths, Polygons, Lists
// See Also: is_valid_region(), is_1region(), is_region_simple()
// Usage: // Usage:
// bool = is_region(x); // bool = is_region(x);
// Description: // Description:
@ -52,6 +55,9 @@ function is_region(x) = is_list(x) && is_path(x.x);
// Function: is_valid_region() // Function: is_valid_region()
// Synopsis: Returns true if the input is a valid region.
// Topics: Regions, Paths, Polygons, Lists
// See Also: is_region(), is_1region(), is_region_simple()
// Usage: // Usage:
// bool = is_valid_region(region, [eps]); // bool = is_valid_region(region, [eps]);
// Description: // Description:
@ -208,6 +214,9 @@ function _polygon_crosses_region(region, poly, eps=EPSILON) =
// Function: is_region_simple() // Function: is_region_simple()
// Synopsis: Returns true if the input is a region with no corner contact.
// Topics: Regions, Paths, Polygons, Lists
// See Also: is_region(), is_valid_region(), is_1region()
// Usage: // Usage:
// bool = is_region_simple(region, [eps]); // bool = is_region_simple(region, [eps]);
// Description: // Description:
@ -238,12 +247,15 @@ function is_region_simple(region, eps=EPSILON) =
// Function: make_region() // Function: make_region()
// Synopsis: Converts lists of intersecting polygons into valid regions.
// Topics: Regions, Paths, Polygons, Lists
// See Also: force_region(), region()
//
// Usage: // Usage:
// region = make_region(polys, [nonzero], [eps]); // region = make_region(polys, [nonzero], [eps]);
// Description: // Description:
// Takes a list of polygons that may intersect themselves or cross each other // Takes a list of polygons that may intersect themselves or cross each other
// and converts it into a properly defined region without // and converts it into a properly defined region without these defects.
// these defects.
// Arguments: // Arguments:
// polys = list of polygons to use // polys = list of polygons to use
// nonzero = set to true to use nonzero rule for polygon membership. Default: false // nonzero = set to true to use nonzero rule for polygon membership. Default: false
@ -268,6 +280,9 @@ function make_region(polys,nonzero=false,eps=EPSILON) =
eps=eps); eps=eps);
// Function: force_region() // Function: force_region()
// Synopsis: Given a polygon returns a region.
// Topics: Regions, Paths, Polygons, Lists
// See Also: make_region(), region()
// Usage: // Usage:
// region = force_region(poly) // region = force_region(poly)
// Description: // Description:
@ -280,6 +295,9 @@ function force_region(poly) = is_path(poly) ? [poly] : poly;
// Section: Turning a region into geometry // Section: Turning a region into geometry
// Module: region() // Module: region()
// Synopsis: Creates the 2D polygons described by the given region or list of polygons.
// Topics: Regions, Paths, Polygons, Lists
// See Also: make_region(), region()
// Usage: // Usage:
// region(r, [anchor], [spin=], [cp=], [atype=]) [ATTACHMENTS]; // region(r, [anchor], [spin=], [cp=], [atype=]) [ATTACHMENTS];
// Description: // Description: