Extruded two dimensional geometric shapes. More...

Collaboration diagram for 2D Extrusions:

Files
file	shapes2de.scad
	Linearly extruded two-dimensional basic shapes.

Functions
module	erectangle (size, h, vr, vrm=0, center=false)
	An extruded rectangle with edge, fillet, and/or chamfer corners. More...

module	erectangle_c (size, core, h, t, co, cr=0, vr, vr1, vr2, vrm=0, vrm1, vrm2, center=false)
	An extruded rectangle with a removed rectangular core. More...

module	erhombus (size, h, vr, center=false)
	An extruded rhombus. More...

module	etriangle_ppp (v1, v2, v3, h, vr, v1r, v2r, v3r, centroid=false, incenter=false, center=false)
	An extruded general triangle specified by three vertices. More...

module	etriangle_vp (v, h, vr, centroid=false, incenter=false, center=false)
	An extruded general triangle specified by a vector of its three vertices. More...

module	etriangle_lll (s1, s2, s3, h, vr, v1r, v2r, v3r, centroid=false, incenter=false, center=false)
	An extruded general triangle specified by its three side lengths. More...

module	etriangle_vl (v, h, vr, centroid=false, incenter=false, center=false)
	An extruded general triangle specified by a vector of its three side lengths. More...

module	etriangle_vl_c (vs, vc, h, co, cr=0, vr, vr1, vr2, centroid=false, incenter=false, center=false)
	A general triangle specified by its sides with a removed triangular core. More...

module	etriangle_lal (s1, a, s2, h, x=1, vr, v1r, v2r, v3r, centroid=false, incenter=false, center=false)
	An extruded general triangle specified by two sides and the included angle. More...

module	etriangle_ala (a1, s, a2, h, x=1, vr, v1r, v2r, v3r, centroid=false, incenter=false, center=false)
	An extruded general triangle specified by a side and two adjacent angles. More...

module	etriangle_aal (a1, a2, s, h, x=1, vr, v1r, v2r, v3r, centroid=false, incenter=false, center=false)
	An extruded general triangle specified by a side, one adjacent angle and the opposite angle. More...

module	etriangle_ll (x, y, h, vr, v1r, v2r, v3r, centroid=false, incenter=false, center=false)
	An extruded right-angled triangle specified by its opposite and adjacent side lengths. More...

module	etriangle_la (x, y, aa, oa, h, vr, v1r, v2r, v3r, centroid=false, incenter=false, center=false)
	An extruded right-angled triangle specified by a side length and an angle. More...

module	engon (n, r, h, vr, center=false)
	An extruded n-sided equiangular/equilateral regular polygon. More...

module	eellipse (size, h, center=false)
	An extruded ellipse. More...

module	eellipse_c (size, core, h, t, co, cr=0, center=false)
	An extruded ellipse with a removed elliptical core. More...

module	eellipse_s (size, h, a1=0, a2=0, center=false)
	An extruded ellipse sector. More...

module	eellipse_cs (size, core, h, t, a1=0, a2=0, co, cr=0, center=false)
	An extruded sector of an ellipse with a removed elliptical core. More...

module	estar2d (size, h, n=5, vr, center=false)
	An extruded two dimensional star. More...

Detailed Description

Extruded two dimensional geometric shapes.

Function Documentation

module eellipse	(	size	,
		h	,
		center	= `false`
	)

An extruded ellipse.

Parameters

size	<vector\|decimal> A vector [rx, ry] of decimals or a single decimal for (rx=ry).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

eellipse

1 eellipse( size=[25, 40], h=20, center=true );

Definition at line 767 of file shapes2de.scad.

module eellipse_c	(	size	,
		core	,
		h	,
		t	,
		co	,
		cr	= `0`,
		center	= `false`
	)

An extruded ellipse with a removed elliptical core.

Parameters

size	<vector\|decimal> A vector [rx, ry] of decimals or a single decimal for (rx=ry).
core	<vector\|decimal> A vector [rx, ry] of decimals or a single decimal for (rx=ry).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
t	<vector\|decimal> A vector [x, y] of decimals or a single decimal for (x=y).
co	<vector> Core offset. A vector [x, y] of decimals.
cr	<decimal> Core z-rotation.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Thickness t

core = size - t; when t and size are given.
size = core + t; when t and core are given.

Example

eellipse_c

1 eellipse_c( size=[25,40], core=[16,10], co=[0,10], cr=45, h=20, center=true );

Definition at line 807 of file shapes2de.scad.

module eellipse_cs	(	size	,
		core	,
		h	,
		t	,
		a1	= `0`,
		a2	= `0`,
		co	,
		cr	= `0`,
		center	= `false`
	)

An extruded sector of an ellipse with a removed elliptical core.

Parameters

size	<vector\|decimal> A vector [rx, ry] of decimals or a single decimal for (rx=ry).
core	<vector\|decimal> A vector [rx, ry] of decimals or a single decimal for (rx=ry).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
t	<vector\|decimal> A vector [x, y] of decimals or a single decimal for (x=y).
a1	<decimal> The start angle in degrees.
a2	<decimal> The stop angle in degrees.
co	<vector> Core offset. A vector [x, y] of decimals.
cr	<decimal> Core z-rotation.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Thickness t

core = size - t; when t and size are given.
size = core + t; when t and core are given.

Example

eellipse_cs

1 eellipse_cs( size=[25,40], t=[10,5], a1=90, a2=180, co=[10,0], cr=45, h=20, center=true );

Definition at line 887 of file shapes2de.scad.

module eellipse_s	(	size	,
		h	,
		a1	= `0`,
		a2	= `0`,
		center	= `false`
	)

An extruded ellipse sector.

Parameters

size	<vector\|decimal> A vector [rx, ry] of decimals or a single decimal for (rx=ry).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
a1	<decimal> The start angle in degrees.
a2	<decimal> The stop angle in degrees.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

eellipse_s

1 eellipse_s( size=[25,40], h=20, a1=90, a2=180, center=true );

Definition at line 842 of file shapes2de.scad.

module engon	(	n	,
		r	,
		h	,
		vr	,
		center	= `false`
	)

An extruded n-sided equiangular/equilateral regular polygon.

Parameters

n	<decimal> The number of sides.
r	<decimal> The ngon vertex radius.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<decimal> The vertex rounding radius.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

engon

1 engon( n=6, r=25, h=20, vr=6, center=true );

See Wikipedia for more information.

Definition at line 737 of file shapes2de.scad.

module erectangle	(	size	,
		h	,
		vr	,
		vrm	= `0`,
		center	= `false`
	)

An extruded rectangle with edge, fillet, and/or chamfer corners.

Parameters

size	<vector\|decimal> A vector [x, y] of decimals or a single decimal for (x=y).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<vector\|decimal> The corner rounding radius. A vector [v1r, v2r, v3r, v4r] of decimals or a single decimal for (v1r=v2r=v3r=v4r). Unspecified corners are not rounded.
vrm	<integer> The corner radius mode. A 4-bit encoded integer that indicates each corner finish. Use bit value 0 for fillet and 1 for chamfer.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

erectangle

1 erectangle( size=[25,40], vr=5, vrm=3, h=20, center=true );

Definition at line 110 of file shapes2de.scad.

module erectangle_c	(	size	,
		core	,
		h	,
		t	,
		co	,
		cr	= `0`,
		vr	,
		vr1	,
		vr2	,
		vrm	= `0`,
		vrm1	,
		vrm2	,
		center	= `false`
	)

An extruded rectangle with a removed rectangular core.

Parameters

size	<vector\|decimal> A vector [x, y] of decimals or a single decimal for (x=y).
core	<vector\|decimal> A vector [x, y] of decimals or a single decimal for (x=y).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
t	<vector\|decimal> A vector [x, y] of decimals or a single decimal for (x=y).
co	<vector> Core offset. A vector [x, y] of decimals.
cr	<decimal> Core z-rotation.
vr	<vector\|decimal> The default corner rounding radius. A vector [v1r, v2r, v3r, v4r] of decimals or a single decimal for (v1r=v2r=v3r=v4r). Unspecified corners are not rounded.
vr1	<vector\|decimal> The outer corner rounding radius.
vr2	<vector\|decimal> The core corner rounding radius.
vrm	<integer> The default corner radius mode. A 4-bit encoded integer that indicates each corner finish. Use bit value 0 for fillet and 1 for chamfer.
vrm1	<integer> The outer corner radius mode.
vrm2	<integer> The core corner radius mode.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Thickness t

core = size - t; when t and size are given.
size = core + t; when t and core are given.

Example

erectangle_c

1 erectangle_c( size=[40,20], t=[10,1], co=[0,-6], cr=10, vr=5, vrm1=12, h=30, center=true );

Definition at line 164 of file shapes2de.scad.

module erhombus	(	size	,
		h	,
		vr	,
		center	= `false`
	)

An extruded rhombus.

Parameters

size	<vector\|decimal> A vector [w, h] of decimals or a single decimal for (w=h).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<vector\|decimal> The corner rounding radius. A vector [v1r, v2r, v3r, v4r] of decimals or a single decimal for (v1r=v2r=v3r=v4r). Unspecified corners are not rounded.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

erhombus

1 erhombus( size=[40,25], h=10, vr=[3,0,3,9], center=true );

Definition at line 213 of file shapes2de.scad.

module estar2d	(	size	,
		h	,
		n	= `5`,
		vr	,
		center	= `false`
	)

An extruded two dimensional star.

Parameters

size	<vector\|decimal> A vector [l, w] of decimals or a single decimal for (size=l=2*w).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
n	<decimal> The number of points.
vr	<vector\|decimal> The vertex rounding radius. A vector [v1r, v2r, v3r] of decimals or a single decimal for (v1r=v2r=v3r).
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

estar2d

1 estar2d( size=[40, 15], h=15, n=5, vr=2, center=true );

Definition at line 926 of file shapes2de.scad.

module etriangle_aal	(	a1	,
		a2	,
		s	,
		h	,
		x	= `1`,
		vr	,
		v1r	,
		v2r	,
		v3r	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded general triangle specified by a side, one adjacent angle and the opposite angle.

Parameters

a1	<decimal> The opposite angle 1 in degrees.
a2	<decimal> The adjacent angle 2 in degrees.
s	<decimal> The side length.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
x	<decimal> The side to draw on the positive x-axis (`x=1` for `s`).
vr	<decimal> The default vertex rounding radius.
v1r	<decimal> Vertex 1 rounding radius.
v2r	<decimal> Vertex 2 rounding radius.
v3r	<decimal> Vertex 3 rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_aal

1 etriangle_aal( a1=60, a2=30, s=40, h=20, vr=2, centroid=true, center=true );

Definition at line 589 of file shapes2de.scad.

module etriangle_ala	(	a1	,
		s	,
		a2	,
		h	,
		x	= `1`,
		vr	,
		v1r	,
		v2r	,
		v3r	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded general triangle specified by a side and two adjacent angles.

Parameters

a1	<decimal> The adjacent angle 1 in degrees.
s	<decimal> The side length adjacent to the angles.
a2	<decimal> The adjacent angle 2 in degrees.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
x	<decimal> The side to draw on the positive x-axis (`x=1` for `s`).
vr	<decimal> The default vertex rounding radius.
v1r	<decimal> Vertex 1 rounding radius.
v2r	<decimal> Vertex 2 rounding radius.
v3r	<decimal> Vertex 3 rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_ala

1 etriangle_ala( a1=30, s=50, a2=60, h=20, vr=2, centroid=true, center=true );

Definition at line 537 of file shapes2de.scad.

module etriangle_la	(	x	,
		y	,
		aa	,
		oa	,
		h	,
		vr	,
		v1r	,
		v2r	,
		v3r	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded right-angled triangle specified by a side length and an angle.

Parameters

x	<decimal> The length of the side along the x-axis.
y	<decimal> The length of the side along the y-axis.
aa	<decimal> The adjacent angle in degrees.
oa	<decimal> The opposite angle in degrees.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<decimal> The default vertex rounding radius.
v1r	<decimal> Vertex 1 rounding radius.
v2r	<decimal> Vertex 2 rounding radius.
v3r	<decimal> Vertex 3 rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_la

1 etriangle_la( x=40, aa=30, h=20, vr=2, centroid=true, center=true );

Note: When both x and y are given, both triangles are rendered.; When both aa and oa are given, aa is used.

Definition at line 690 of file shapes2de.scad.

module etriangle_lal	(	s1	,
		a	,
		s2	,
		h	,
		x	= `1`,
		vr	,
		v1r	,
		v2r	,
		v3r	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded general triangle specified by two sides and the included angle.

Parameters

s1	<decimal> The length of the side 1.
a	<decimal> The included angle in degrees.
s2	<decimal> The length of the side 2.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
x	<decimal> The side to draw on the positive x-axis (`x=1` for `s1`).
vr	<decimal> The default vertex rounding radius.
v1r	<decimal> Vertex 1 rounding radius.
v2r	<decimal> Vertex 2 rounding radius.
v3r	<decimal> Vertex 3 rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_lal

1 etriangle_lal( s1=50, a=60, s2=30, h=20, vr=2, centroid=true, center=true );

Definition at line 485 of file shapes2de.scad.

module etriangle_ll	(	x	,
		y	,
		h	,
		vr	,
		v1r	,
		v2r	,
		v3r	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded right-angled triangle specified by its opposite and adjacent side lengths.

Parameters

x	<decimal> The length of the side along the x-axis.
y	<decimal> The length of the side along the y-axis.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<decimal> The default vertex rounding radius.
v1r	<decimal> Vertex 1 rounding radius.
v2r	<decimal> Vertex 2 rounding radius.
v3r	<decimal> Vertex 3 rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_ll

1 etriangle_ll( x=30, y=40, h=20, vr=2, centroid=true, center=true );

Definition at line 638 of file shapes2de.scad.

module etriangle_lll	(	s1	,
		s2	,
		s3	,
		h	,
		vr	,
		v1r	,
		v2r	,
		v3r	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded general triangle specified by its three side lengths.

Parameters

s1	<decimal> The length of the side 1 (along the x-axis).
s2	<decimal> The length of the side 2.
s3	<decimal> The length of the side 3.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<decimal> The default vertex rounding radius.
v1r	<decimal> Vertex 1 rounding radius.
v2r	<decimal> Vertex 2 rounding radius.
v3r	<decimal> Vertex 3 rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_lll

1 etriangle_lll( s1=30, s2=40, s3=50, h=20, vr=2, centroid=true, center=true );

Definition at line 338 of file shapes2de.scad.

module etriangle_ppp	(	v1	,
		v2	,
		v3	,
		h	,
		vr	,
		v1r	,
		v2r	,
		v3r	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded general triangle specified by three vertices.

Parameters

v1	<vector> A vector [x, y] for vertex 1.
v2	<vector> A vector [x, y] for vertex 2.
v3	<vector> A vector [x, y] for vertex 3.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<decimal> The default vertex rounding radius.
v1r	<decimal> Vertex 1 rounding radius.
v2r	<decimal> Vertex 2 rounding radius.
v3r	<decimal> Vertex 3 rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_ppp

1 etriangle_ppp( v1=[0,0], v2=[5,25], v3=[40,5], h=20, vr=2, centroid=true, center=true );

Definition at line 250 of file shapes2de.scad.

module etriangle_vl	(	v	,
		h	,
		vr	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded general triangle specified by a vector of its three side lengths.

Parameters

v	<vector> A vector [s1, s2, s3] of decimals.
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<vector\|decimal> The vertex rounding radius. A vector [v1r, v2r, v3r] of decimals or a single decimal for (v1r=v2r=v3r).
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

t = triangle_lll2vp( 3, 4, 5 );
s = triangle_vp2vl( t );
etriangle_vl( v=s, h=5, vr=2 );

Definition at line 387 of file shapes2de.scad.

module etriangle_vl_c	(	vs	,
		vc	,
		h	,
		co	,
		cr	= `0`,
		vr	,
		vr1	,
		vr2	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

A general triangle specified by its sides with a removed triangular core.

Parameters

vs	<vector\|decimal> The size. A vector [s1, s2, s3] of decimals or a single decimal for (s1=s2=s3).
vc	<vector\|decimal> The core. A vector [s1, s2, s3] of decimals or a single decimal for (s1=s2=s3).
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
co	<vector> Core offset. A vector [x, y] of decimals.
cr	<decimal> Core z-rotation.
vr	<vector\|decimal> The default vertex rounding radius. A vector [v1r, v2r, v3r] of decimals or a single decimal for (v1r=v2r=v3r).
vr1	<vector\|decimal> The outer vertex rounding radius.
vr2	<vector\|decimal> The core vertex rounding radius.
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

etriangle_vl_c

1 etriangle_vl_c(vs=50, vc=30, h=15, co=[0,-10], cr=180, vr=[2,2,8], centroid=true, center=true);

Note: The outer and inner triangles centroids are aligned prior to the core removal.

Definition at line 433 of file shapes2de.scad.

module etriangle_vp	(	v	,
		h	,
		vr	,
		centroid	= `false`,
		incenter	= `false`,
		center	= `false`
	)

An extruded general triangle specified by a vector of its three vertices.

Parameters

v	<vector> A vector [v1, v2, v3] of vectors [x, y].
h	<vector\|decimal> A vector of decimals or a single decimal to specify simple extrusion height.
vr	<vector\|decimal> The vertex rounding radius. A vector [v1r, v2r, v3r] of decimals or a single decimal for (v1r=v2r=v3r).
centroid	<boolean> Center centroid at origin.
incenter	<boolean> Center incenter at origin.
center	<boolean> Center about origin.

See also: st_linear_extrude_scale for a description on specifying h.

Example

t = triangle_lll2vp( 30, 40, 50 );
r = [2, 4, 6];
etriangle_vp( v=t, h=5, vr=r );

Definition at line 299 of file shapes2de.scad.

Files

Functions

Detailed Description

Function Documentation