ArcSpan - Revision history

WikiSysop at 15:32, 31 August 2024

2024-08-31T15:32:51Z

← Older revision		Revision as of 09:32, 31 August 2024
Line 2:		Line 2:
	[[Category:SDK]]		[[Category:SDK]]

	This object represents an arc span in a Contour. It is derived from the Span class and all methods and properties of the span class are valid on this object as well. As well as creating spans to append to a contour you can use the ArcTo methods to avoid span creation. Arcs are represented internally using the start and end points and a ‘bulge factor’ which controls the shape of the arc. The bulge represents a ratio between the chord length of an arc and its height (bulge = (2*arc_height) / chord_length).		This object represents an arc span in a Contour. It is derived from the Span class and all methods and properties of the span class are valid on this object as well. As well as creating spans to append to a contour you can use the ArcTo methods to avoid span creation. Arcs are represented internally using the start and end points and a ‘bulge factor’ which controls the shape of the arc. The bulge represents a ratio between the chord length of an arc and its height (bulge = (2 * arc_height) / chord_length).

	== Constructors ==		== Constructors ==
Line 107:		Line 107:
	ret_centre_pt - Point3D - returned 3d position for centre point of arc (not mid-point)		ret_centre_pt - Point3D - returned 3d position for centre point of arc (not mid-point)

	Example Code		Example Code
	local arc = ArcSpan(Point3D(0,0,0), Point3D(1,0,0), 1.0)		<nowiki>
	local centre = Point3D()		local arc = ArcSpan(Point3D(0,0,0), Point3D(1,0,0), 1.0)
	local radius = arc:RadiusAndCentre(centre)		local centre = Point3D()
	MessageBox("Arc Radius = " .. radius ..		local radius = arc:RadiusAndCentre(centre)
	" Centre Point = " .. centre.x .. "," .. centre.y )		MessageBox("Arc Radius = " .. radius ..
			" Centre Point = " .. centre.x .. "," .. centre.y ) </nowiki>


	=== :SetBulge(bulge) ===		=== :SetBulge(bulge) ===

WikiSysop at 03:17, 4 August 2021

2021-08-04T03:17:47Z

← Older revision		Revision as of 21:17, 3 August 2021
Line 1:		Line 1:
	[[File:Back.jpg\|right\|50px\|link=~~High Level Objects~~]]		[[File:Back.jpg\|right\|50px\|link=Creating Vectors From Script]]
	[[Category:SDK]]		[[Category:SDK]]

Line 128:		Line 128:
	::''mid -Point2D -mid point for arc ( NOT centre point)		::''mid -Point2D -mid point for arc ( NOT centre point)

	[[File:Back.jpg\|right\|50px\|link=~~High Level Objects~~]]		[[File:Back.jpg\|right\|50px\|link=Creating Vectors From Script]]
	==References==		==References==
	'''Please Note:''' The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 2.05, published September 12, 2018. by Vectric Ltd. Most current document from Vertric can be downloaded at [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information]		'''Please Note:''' The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 2.05, published September 12, 2018. by Vectric Ltd. Most current document from Vertric can be downloaded at [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information]

WikiSysop at 03:16, 4 August 2021

2021-08-04T03:16:34Z

← Older revision		Revision as of 21:16, 3 August 2021
Line 9:		Line 9:
	- Constructor -		- Constructor -
	A new span representing an arc is created within a Lua script using this contructor method		A new span representing an arc is created within a Lua script using this contructor method
	start_pt – Point2D – 2D position for start point of span		::''start_pt – Point2D – 2D position for start point of span
	end_pt – Point2D – 2D position for end point of span- must have same Z values as start		::''end_pt – Point2D – 2D position for end point of span- must have same Z values as start
	pt_on_arc- Point2D – 2D position for a point on arc		::''pt_on_arc- Point2D – 2D position for a point on arc

	----		----
Line 20:		Line 20:
	local end_pt = Point2D(1.0, 0)		local end_pt = Point2D(1.0, 0)
	local pt_on_arc = Point2D(0.5, 0.3)		local pt_on_arc = Point2D(0.5, 0.3)
	local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)		local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc) </nowiki>
	</nowiki>
	===ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) - Constructor ===		===ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) - Constructor ===

Line 31:		Line 31:
	::''ccw - bool - true if arc is Counter Clockwise		::''ccw - bool - true if arc is Counter Clockwise

	::''e.g		:: e.g
	~~::''~~local start_pt = Point2D(0, 0)		<nowiki> local start_pt = Point2D(0, 0)
	~~::''~~local end_pt = Point2D(1.0, 0)		local end_pt = Point2D(1.0, 0)
	~~::''~~local center_pt = Point2D(0.5, 0)		local center_pt = Point2D(0.5, 0)
	~~::''~~local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)		local arc_span = ArcSpan(start_pt, end_pt, center_pt, false) </nowiki>

	:: NOTE: arcs can be a maximum of 180 degrees		:: NOTE: arcs can be a maximum of 180 degrees
	~~::''96~~

	=== ArcSpan(Point3D start_pt, Point3D end_pt, Point3D centre_pt, bool ccw) - Constructor ===		=== ArcSpan(Point3D start_pt, Point3D end_pt, Point3D centre_pt, bool ccw) - Constructor ===
Line 47:		Line 47:
	::''centre_pt - Point3D - 3d position for centre point of arc (not mid-point)		::''centre_pt - Point3D - 3d position for centre point of arc (not mid-point)
	::''ccw - bool - true if arc is Counter Clockwise		::''ccw - bool - true if arc is Counter Clockwise

	::''e.g		::''e.g
	::''local start_pt = Point3D(0, 0, 0)		::''local start_pt = Point3D(0, 0, 0)
Line 53:		Line 54:
	::local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)		::local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)
	::NOTE: arcs can be a maximum of 180 degrees		::NOTE: arcs can be a maximum of 180 degrees
	~~::ArcSpan(Point3D start_pt, Point3D end_pt, Point2D pt_on_arc)~~
	~~::- Constructor~~
	~~::A new span representing an arc is created within a Lua script using this contructor method~~
	~~::start_pt - Point3D – 3D position for start point of span~~
	~~::end_pt - Point3D – 3D position for end point of span- must have same Z values as start pt_on_arc- Point2D – 2D position for a point on arc~~
	::NOTE: arcs can be a maximum of 180 degrees e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local pt_on_arc = Point2D(0.5, 0.3) local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)
	~~=== ArcSpan(Point2D start_pt, Point2D end_pt, double bulge) ===~~

	-- Constructor --		=== ArcSpan(Point3D start_pt, Point3D end_pt, Point2D pt_on_arc) - Constructor ===

			A new span representing an arc is created within a Lua script using this contructor method
			::''start_pt - Point3D – 3D position for start point of span
			::''end_pt - Point3D – 3D position for end point of span- must have same Z values as start pt_on_arc- Point2D – 2D position for a point on arc

			:: NOTE: arcs can be a maximum of 180 degrees

			::''e.g
			::''local start_pt = Point3D(0, 0, 0)
			::''local end_pt = Point3D(1.0, 0, 0)
			::''local pt_on_arc = Point2D(0.5, 0.3)
			::''local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)

			=== ArcSpan(Point2D start_pt, Point2D end_pt, double bulge) - Constructor ===

			A new span representing an arc is created within a Lua script using this contructor method start_pt – Point2D – 2D position for start point of span end_pt – Point2D – 2D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point2D(0, 0) local end_pt = Point2D(1.0, 0) local arc_span = ArcSpan(start_pt, end_pt, 1.0)

			=== ArcSpan(Point3D start_pt, Point3D end_pt, double bulge) - Constructor ===

	A new span representing an arc is created within a Lua script using this contructor method start_pt – Point2D – 2D position for start point of span end_pt – Point2D – 2D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point2D(0, 0) local end_pt = Point2D(1.0, 0) local arc_span = ArcSpan(start_pt, end_pt, 1.0) 97 ArcSpan(Point3D start_pt, Point3D end_pt, double bulge) - Constructor A new span representing an arc is created within a Lua script using this contructor method start_pt - Point3D – 3D position for start point of span end_pt - Point3D – 3D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local arc_span =		A new span representing an arc is created within a Lua script using this contructor method start_pt - Point3D – 3D position for start point of span end_pt - Point3D – 3D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local arc_span =

	=== ArcSpan(start_pt, end_pt, 1.0) ===		=== ArcSpan(start_pt, end_pt, 1.0) ===

	NOTE: arcs can be a maximum of 180 degrees Properties .Bulge R/O - double - signed bulge for arc .IsAntiClockwise R/O - bool - true if arc is anticlockwise (same as .IsCCW) .IsCCW R/O - bool - true if arc is counter clockwise (same as . IsAntiClockwise) .IsClockwise R/O - bool - true if arc is clockwise (same as . IsCW ) .IsCW R/O - bool - true if arc is clockwise (same as . IsClockwise)		NOTE: arcs can be a maximum of 180 degrees

			== Properties ==

			=== .Bulge ===
			R/O - double - signed bulge for arc

			=== .IsAntiClockwise ===
			R/O - bool - true if arc is anticlockwise (same as .IsCCW)

			=== .IsCCW ===
			R/O - bool - true if arc is counter clockwise (same as . IsAntiClockwise)

			===.IsClockwise ===
			R/O - bool - true if arc is clockwise (same as . IsCW )

			===.IsCW ===
			R/O - bool - true if arc is clockwise (same as . IsClockwise)

	== Methods ==		== Methods ==

	:ArcMidPoint()		=== :ArcMidPoint() ===
	Returns a Point3D holding the mid point of the arc		Returns a Point3D holding the mid point of the arc
	:RadiusAndCentre(Point3D ret_centre_pt)
			=== :RadiusAndCentre(Point3D ret_centre_pt) ===
	Calculate the centre point of the arc and the radius. The method returns the radius and also sets the position of the passed point to the centre point position of the arc.		Calculate the centre point of the arc and the radius. The method returns the radius and also sets the position of the passed point to the centre point position of the arc.
	ret_centre_pt - Point3D - returned 3d position for centre point of arc (not mid-point)		ret_centre_pt - Point3D - returned 3d position for centre point of arc (not mid-point)

	Example Code		Example Code
	local arc = ArcSpan(Point3D(0,0,0), Point3D(1,0,0), 1.0)		local arc = ArcSpan(Point3D(0,0,0), Point3D(1,0,0), 1.0)
Line 82:		Line 113:
	MessageBox("Arc Radius = " .. radius ..		MessageBox("Arc Radius = " .. radius ..
	" Centre Point = " .. centre.x .. "," .. centre.y )		" Centre Point = " .. centre.x .. "," .. centre.y )
	:SetBulge(bulge)
			=== :SetBulge(bulge) ===
	Set the bulge factor for this arc		Set the bulge factor for this arc
	Bulge - double - bulge factor for arc		Bulge - double - bulge factor for arc
	98

	---		---

WikiSysop at 03:06, 4 August 2021

2021-08-04T03:06:55Z

← Older revision		Revision as of 21:06, 3 August 2021
Line 1:		Line 1:
			[[File:Back.jpg\|right\|50px\|link=High Level Objects]]
			[[Category:SDK]]

	This object represents an arc span in a Contour. It is derived from the Span class and all methods and properties of the span class are valid on this object as well. As well as creating spans to append to a contour you can use the ArcTo methods to avoid span creation. Arcs are represented internally using the start and end points and a ‘bulge factor’ which controls the shape of the arc. The bulge represents a ratio between the chord length of an arc and its height (bulge = (2*arc_height) / chord_length).		This object represents an arc span in a Contour. It is derived from the Span class and all methods and properties of the span class are valid on this object as well. As well as creating spans to append to a contour you can use the ArcTo methods to avoid span creation. Arcs are represented internally using the start and end points and a ‘bulge factor’ which controls the shape of the arc. The bulge represents a ratio between the chord length of an arc and its height (bulge = (2*arc_height) / chord_length).

Line 14:		Line 17:
	::''NOTE: arcs can be a maximum of 180 degrees		::''NOTE: arcs can be a maximum of 180 degrees
	::''e.g		::''e.g
	~~::''~~local start_pt = Point2D(0, 0)		<nowiki> local start_pt = Point2D(0, 0)
	~~::''~~local end_pt = Point2D(1.0, 0)		local end_pt = Point2D(1.0, 0)
	~~::''~~local pt_on_arc = Point2D(0.5, 0.3)		local pt_on_arc = Point2D(0.5, 0.3)
	~~::''~~local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)		local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)
			</nowiki>
	===ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) ===		===ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) - Constructor ===

	~~-- Constructor --~~

	A new span representing an arc is created within a Lua script using this contructor method		A new span representing an arc is created within a Lua script using this contructor method
Line 36:		Line 37:
	::''local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)		::''local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)

	::''NOTE: arcs can be a maximum of 180 degrees		:: NOTE: arcs can be a maximum of 180 degrees
	::''96		::''96

	=== ArcSpan(Point3D start_pt, Point3D end_pt, Point3D centre_pt, bool ccw) ===		=== ArcSpan(Point3D start_pt, Point3D end_pt, Point3D centre_pt, bool ccw) - Constructor ===

	~~-- Constructor --~~

	A new span representing an arc is created within a Lua script using this contructor method		A new span representing an arc is created within a Lua script using this contructor method
Line 59:		Line 58:
	::start_pt - Point3D – 3D position for start point of span		::start_pt - Point3D – 3D position for start point of span
	::end_pt - Point3D – 3D position for end point of span- must have same Z values as start pt_on_arc- Point2D – 2D position for a point on arc		::end_pt - Point3D – 3D position for end point of span- must have same Z values as start pt_on_arc- Point2D – 2D position for a point on arc
	::NOTE: arcs can be a maximum of 180 degrees e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local pt_on_arc = Point2D(0.5, 0.3) local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc) ArcSpan(Point2D start_pt, Point2D end_pt, double bulge) - Constructor A new span representing an arc is created within a Lua script using this contructor method start_pt – Point2D – 2D position for start point of span end_pt – Point2D – 2D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point2D(0, 0) local end_pt = Point2D(1.0, 0) local arc_span = ArcSpan(start_pt, end_pt, 1.0) 97 ArcSpan(Point3D start_pt, Point3D end_pt, double bulge) - Constructor A new span representing an arc is created within a Lua script using this contructor method start_pt - Point3D – 3D position for start point of span end_pt - Point3D – 3D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local arc_span = ArcSpan(start_pt, end_pt, 1.0) NOTE: arcs can be a maximum of 180 degrees Properties .Bulge R/O - double - signed bulge for arc .IsAntiClockwise R/O - bool - true if arc is anticlockwise (same as .IsCCW) .IsCCW R/O - bool - true if arc is counter clockwise (same as . IsAntiClockwise) .IsClockwise R/O - bool - true if arc is clockwise (same as . IsCW ) .IsCW R/O - bool - true if arc is clockwise (same as . IsClockwise) Methods		::NOTE: arcs can be a maximum of 180 degrees e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local pt_on_arc = Point2D(0.5, 0.3) local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)
			=== ArcSpan(Point2D start_pt, Point2D end_pt, double bulge) ===

			-- Constructor --

			A new span representing an arc is created within a Lua script using this contructor method start_pt – Point2D – 2D position for start point of span end_pt – Point2D – 2D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point2D(0, 0) local end_pt = Point2D(1.0, 0) local arc_span = ArcSpan(start_pt, end_pt, 1.0) 97 ArcSpan(Point3D start_pt, Point3D end_pt, double bulge) - Constructor A new span representing an arc is created within a Lua script using this contructor method start_pt - Point3D – 3D position for start point of span end_pt - Point3D – 3D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local arc_span =

			=== ArcSpan(start_pt, end_pt, 1.0) ===

			NOTE: arcs can be a maximum of 180 degrees Properties .Bulge R/O - double - signed bulge for arc .IsAntiClockwise R/O - bool - true if arc is anticlockwise (same as .IsCCW) .IsCCW R/O - bool - true if arc is counter clockwise (same as . IsAntiClockwise) .IsClockwise R/O - bool - true if arc is clockwise (same as . IsCW ) .IsCW R/O - bool - true if arc is clockwise (same as . IsClockwise)

			== Methods ==

	:ArcMidPoint()		:ArcMidPoint()
Line 86:		Line 96:
	::''end -Point2D -End point for arc		::''end -Point2D -End point for arc
	::''mid -Point2D -mid point for arc ( NOT centre point)		::''mid -Point2D -mid point for arc ( NOT centre point)

			[[File:Back.jpg\|right\|50px\|link=High Level Objects]]
			==References==
			'''Please Note:''' The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 2.05, published September 12, 2018. by Vectric Ltd. Most current document from Vertric can be downloaded at [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information]

WikiSysop at 03:02, 4 August 2021

2021-08-04T03:02:01Z

@@ Line 50: / Line 50: @@
 ::''e.g
 ::''local start_pt = Point3D(0, 0, 0)
 ::''local end_pt = Point3D(1.0, 0, 0)
-local center_pt = Point3D(0.5, 0, 0)
+::local center_pt = Point3D(0.5, 0, 0)
-local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)
+::local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)
-NOTE: arcs can be a maximum of 180 degrees
+::NOTE: arcs can be a maximum of 180 degrees
-ArcSpan(Point3D start_pt, Point3D end_pt, Point2D pt_on_arc) - Constructor
+::ArcSpan(Point3D start_pt, Point3D end_pt, Point2D pt_on_arc)
-A new span representing an arc is created within a Lua script using this contructor method
+::- Constructor
-start_pt - Point3D – 3D position for start point of span
+::A new span representing an arc is created within a Lua script using this contructor method
-end_pt - Point3D – 3D position for end point of span- must have same Z values as start
+::start_pt - Point3D – 3D position for start point of span
-pt_on_arc- Point2D – 2D position for a point on arc
+::end_pt - Point3D – 3D position for end point of span- must have same Z values as start pt_on_arc- Point2D – 2D position for a point on arc
-NOTE: arcs can be a maximum of 180 degrees
+::NOTE: arcs can be a maximum of 180 degrees e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local pt_on_arc = Point2D(0.5, 0.3) local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc) ArcSpan(Point2D start_pt, Point2D end_pt, double bulge) - Constructor A new span representing an arc is created within a Lua script using this contructor method start_pt – Point2D – 2D position for start point of span end_pt – Point2D – 2D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point2D(0, 0) local end_pt = Point2D(1.0, 0) local arc_span = ArcSpan(start_pt, end_pt, 1.0) 97 ArcSpan(Point3D start_pt, Point3D end_pt, double bulge) - Constructor A new span representing an arc is created within a Lua script using this contructor method start_pt - Point3D – 3D position for start point of span end_pt - Point3D – 3D position for end point of span - must have same Z values as start bulge - double - buge factor for arc e.g local start_pt = Point3D(0, 0, 0) local end_pt = Point3D(1.0, 0, 0) local arc_span = ArcSpan(start_pt, end_pt, 1.0) NOTE: arcs can be a maximum of 180 degrees Properties .Bulge R/O - double - signed bulge for arc .IsAntiClockwise R/O - bool - true if arc is anticlockwise (same as .IsCCW) .IsCCW R/O - bool - true if arc is counter clockwise (same as . IsAntiClockwise) .IsClockwise R/O - bool - true if arc is clockwise (same as . IsCW ) .IsCW R/O - bool - true if arc is clockwise (same as . IsClockwise) Methods
 e.g
 :ArcMidPoint()
 Returns a Point3D holding the mid point of the arc

WikiSysop: /* = ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) */

2021-08-04T03:00:06Z

= ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw)

← Older revision		Revision as of 21:00, 3 August 2021
Line 19:		Line 19:
	::''local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)		::''local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)

	==== ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) ===		===ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) ===

	-- Constructor --		-- Constructor --

WikiSysop at 02:59, 4 August 2021

2021-08-04T02:59:34Z

← Older revision		Revision as of 20:59, 3 August 2021
Line 3:		Line 3:
	== Constructors ==		== Constructors ==

	== ArcSpan(Point2D start_pt, Point2D end_pt, Point2D pt_on_arc) ==		=== ArcSpan(Point2D start_pt, Point2D end_pt, Point2D pt_on_arc) ===
	- Constructor -		- Constructor -
	A new span representing an arc is created within a Lua script using this contructor method		A new span representing an arc is created within a Lua script using this contructor method
Line 9:		Line 9:
	end_pt – Point2D – 2D position for end point of span- must have same Z values as start		end_pt – Point2D – 2D position for end point of span- must have same Z values as start
	pt_on_arc- Point2D – 2D position for a point on arc		pt_on_arc- Point2D – 2D position for a point on arc
	NOTE: arcs can be a maximum of 180 degrees
	e.g		----
	local start_pt = Point2D(0, 0)
	local end_pt = Point2D(1.0, 0)		::''NOTE: arcs can be a maximum of 180 degrees
	local pt_on_arc = Point2D(0.5, 0.3)		::''e.g
	local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)		::''local start_pt = Point2D(0, 0)
	ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) - Constructor		::''local end_pt = Point2D(1.0, 0)
			::''local pt_on_arc = Point2D(0.5, 0.3)
			::''local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)

			==== ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) ===

			-- Constructor --

	A new span representing an arc is created within a Lua script using this contructor method		A new span representing an arc is created within a Lua script using this contructor method
	start_pt – Point2D – 2D position for start point of span
	end_pt – Point2D – 2D position for end point of span- must have same Z values as start		::''start_pt – Point2D – 2D position for start point of span
	centre_pt – Point2D – 2D position for centre point of arc (not mid-point)		::''end_pt – Point2D – 2D position for end point of span- must have same Z values as start
	ccw - bool - true if arc is Counter Clockwise		::''centre_pt – Point2D – 2D position for centre point of arc (not mid-point)
	e.g		::''ccw - bool - true if arc is Counter Clockwise
	local start_pt = Point2D(0, 0)
	local end_pt = Point2D(1.0, 0)		::''e.g
	local center_pt = Point2D(0.5, 0)		::''local start_pt = Point2D(0, 0)
	local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)		::''local end_pt = Point2D(1.0, 0)
	NOTE: arcs can be a maximum of 180 degrees		::''local center_pt = Point2D(0.5, 0)
	96		::''local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)
	ArcSpan(Point3D start_pt, Point3D end_pt, Point3D centre_pt, bool ccw) - Constructor
			::''NOTE: arcs can be a maximum of 180 degrees
			::''96

			=== ArcSpan(Point3D start_pt, Point3D end_pt, Point3D centre_pt, bool ccw) ===

			-- Constructor --

	A new span representing an arc is created within a Lua script using this contructor method		A new span representing an arc is created within a Lua script using this contructor method
	start_pt - Point3D - 3d position for start point of span		::''start_pt - Point3D - 3d position for start point of span
	end_pt - Point3D - 3d position for end point of span- must have same Z values as start		::''end_pt - Point3D - 3d position for end point of span- must have same Z values as start
	centre_pt - Point3D - 3d position for centre point of arc (not mid-point)		::''centre_pt - Point3D - 3d position for centre point of arc (not mid-point)
	ccw - bool - true if arc is Counter Clockwise		::''ccw - bool - true if arc is Counter Clockwise
	e.g		::''e.g
	local start_pt = Point3D(0, 0, 0)		::''local start_pt = Point3D(0, 0, 0)
	local end_pt = Point3D(1.0, 0, 0)		::''local end_pt = Point3D(1.0, 0, 0)
	local center_pt = Point3D(0.5, 0, 0)		local center_pt = Point3D(0.5, 0, 0)
	local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)		local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)
Line 98:		Line 112:
	Bulge - double - bulge factor for arc		Bulge - double - bulge factor for arc
	98		98
	Global helper methods
	ArcBulgeFromMidPoint(Point2D start, Point2D end, Point2D mid)		---
	Return the bulge factor for an arc through the specified 3 points
	start -Point2D -Start point for arc		== Global helper methods ==
	end -Point2D -End point for arc
	mid -Point2D -mid point for arc ( NOT centre point)		=== ArcBulgeFromMidPoint(Point2D start, Point2D end, Point2D mid) ===
			::''Return the bulge factor for an arc through the specified 3 points
			::''start -Point2D -Start point for arc
			::''end -Point2D -End point for arc
			::''mid -Point2D -mid point for arc ( NOT centre point)

WikiSysop at 02:55, 4 August 2021

2021-08-04T02:55:20Z

← Older revision		Revision as of 20:55, 3 August 2021
Line 1:		Line 1:
	This object represents an arc span in a Contour. It is derived from the Span class and all methods and properties of the span class are valid on this object as well. As well as creating spans to append to a contour you can use the ArcTo methods to avoid span creation. Arcs are represented internally using the start and end points and a ‘bulge factor’ which controls the shape of the arc. The bulge represents a ratio between the chord length of an arc and its height (bulge = (2*arc_height) / chord_length).		This object represents an arc span in a Contour. It is derived from the Span class and all methods and properties of the span class are valid on this object as well. As well as creating spans to append to a contour you can use the ArcTo methods to avoid span creation. Arcs are represented internally using the start and end points and a ‘bulge factor’ which controls the shape of the arc. The bulge represents a ratio between the chord length of an arc and its height (bulge = (2*arc_height) / chord_length).
	Constructors
	ArcSpan(Point2D start_pt, Point2D end_pt, Point2D pt_on_arc) - Constructor		== Constructors ==

			== ArcSpan(Point2D start_pt, Point2D end_pt, Point2D pt_on_arc) ==
			- Constructor -
	A new span representing an arc is created within a Lua script using this contructor method		A new span representing an arc is created within a Lua script using this contructor method
	start_pt – Point2D – 2D position for start point of span		start_pt – Point2D – 2D position for start point of span

WikiSysop at 02:53, 4 August 2021

2021-08-04T02:53:43Z

← Older revision		Revision as of 20:53, 3 August 2021
Line 1:		Line 1:
	~~Blank page~~		This object represents an arc span in a Contour. It is derived from the Span class and all methods and properties of the span class are valid on this object as well. As well as creating spans to append to a contour you can use the ArcTo methods to avoid span creation. Arcs are represented internally using the start and end points and a ‘bulge factor’ which controls the shape of the arc. The bulge represents a ratio between the chord length of an arc and its height (bulge = (2*arc_height) / chord_length).
			Constructors
			ArcSpan(Point2D start_pt, Point2D end_pt, Point2D pt_on_arc) - Constructor
			A new span representing an arc is created within a Lua script using this contructor method
			start_pt – Point2D – 2D position for start point of span
			end_pt – Point2D – 2D position for end point of span- must have same Z values as start
			pt_on_arc- Point2D – 2D position for a point on arc
			NOTE: arcs can be a maximum of 180 degrees
			e.g
			local start_pt = Point2D(0, 0)
			local end_pt = Point2D(1.0, 0)
			local pt_on_arc = Point2D(0.5, 0.3)
			local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)
			ArcSpan(Point2D start_pt, Point2D end_pt, Point2D centre_pt, bool ccw) - Constructor
			A new span representing an arc is created within a Lua script using this contructor method
			start_pt – Point2D – 2D position for start point of span
			end_pt – Point2D – 2D position for end point of span- must have same Z values as start
			centre_pt – Point2D – 2D position for centre point of arc (not mid-point)
			ccw - bool - true if arc is Counter Clockwise
			e.g
			local start_pt = Point2D(0, 0)
			local end_pt = Point2D(1.0, 0)
			local center_pt = Point2D(0.5, 0)
			local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)
			NOTE: arcs can be a maximum of 180 degrees
			96
			ArcSpan(Point3D start_pt, Point3D end_pt, Point3D centre_pt, bool ccw) - Constructor
			A new span representing an arc is created within a Lua script using this contructor method
			start_pt - Point3D - 3d position for start point of span
			end_pt - Point3D - 3d position for end point of span- must have same Z values as start
			centre_pt - Point3D - 3d position for centre point of arc (not mid-point)
			ccw - bool - true if arc is Counter Clockwise
			e.g
			local start_pt = Point3D(0, 0, 0)
			local end_pt = Point3D(1.0, 0, 0)
			local center_pt = Point3D(0.5, 0, 0)
			local arc_span = ArcSpan(start_pt, end_pt, center_pt, false)
			NOTE: arcs can be a maximum of 180 degrees
			ArcSpan(Point3D start_pt, Point3D end_pt, Point2D pt_on_arc) - Constructor
			A new span representing an arc is created within a Lua script using this contructor method
			start_pt - Point3D – 3D position for start point of span
			end_pt - Point3D – 3D position for end point of span- must have same Z values as start
			pt_on_arc- Point2D – 2D position for a point on arc
			NOTE: arcs can be a maximum of 180 degrees
			e.g
			local start_pt = Point3D(0, 0, 0)
			local end_pt = Point3D(1.0, 0, 0)
			local pt_on_arc = Point2D(0.5, 0.3)
			local arc_span = ArcSpan(start_pt, end_pt, pt_on_arc)
			ArcSpan(Point2D start_pt, Point2D end_pt, double bulge) - Constructor
			A new span representing an arc is created within a Lua script using this contructor method
			start_pt – Point2D – 2D position for start point of span
			end_pt – Point2D – 2D position for end point of span - must have same Z values as start
			bulge - double - buge factor for arc
			e.g
			local start_pt = Point2D(0, 0)
			local end_pt = Point2D(1.0, 0)
			local arc_span = ArcSpan(start_pt, end_pt, 1.0)
			97
			ArcSpan(Point3D start_pt, Point3D end_pt, double bulge) - Constructor
			A new span representing an arc is created within a Lua script using this contructor method
			start_pt - Point3D – 3D position for start point of span
			end_pt - Point3D – 3D position for end point of span - must have same Z values as start
			bulge - double - buge factor for arc
			e.g
			local start_pt = Point3D(0, 0, 0)
			local end_pt = Point3D(1.0, 0, 0)
			local arc_span = ArcSpan(start_pt, end_pt, 1.0)
			NOTE: arcs can be a maximum of 180 degrees
			Properties
			.Bulge
			R/O - double - signed bulge for arc
			.IsAntiClockwise
			R/O - bool - true if arc is anticlockwise (same as .IsCCW)
			.IsCCW
			R/O - bool - true if arc is counter clockwise (same as . IsAntiClockwise)
			.IsClockwise
			R/O - bool - true if arc is clockwise (same as . IsCW )
			.IsCW
			R/O - bool - true if arc is clockwise (same as . IsClockwise)
			Methods
			:ArcMidPoint()
			Returns a Point3D holding the mid point of the arc
			:RadiusAndCentre(Point3D ret_centre_pt)
			Calculate the centre point of the arc and the radius. The method returns the radius and also sets the position of the passed point to the centre point position of the arc.
			ret_centre_pt - Point3D - returned 3d position for centre point of arc (not mid-point)
			Example Code
			local arc = ArcSpan(Point3D(0,0,0), Point3D(1,0,0), 1.0)
			local centre = Point3D()
			local radius = arc:RadiusAndCentre(centre)
			MessageBox("Arc Radius = " .. radius ..
			" Centre Point = " .. centre.x .. "," .. centre.y )
			:SetBulge(bulge)
			Set the bulge factor for this arc
			Bulge - double - bulge factor for arc
			98
			Global helper methods
			ArcBulgeFromMidPoint(Point2D start, Point2D end, Point2D mid)
			Return the bulge factor for an arc through the specified 3 points
			start -Point2D -Start point for arc
			end -Point2D -End point for arc
			mid -Point2D -mid point for arc ( NOT centre point)

WikiSysop: Created page with " Blank page"

2021-08-04T02:52:34Z

Created page with " Blank page"

New page

Blank page