Classes
class	depth_params

Functions
def	addToJob (obj, jobname=None)

def	arc (cx, cy, sx, sy, ex, ey, horizFeed=0, ez=None, ccw=False)

def	drillTipLength (tool)

def	feed (x=None, y=None, z=None, horizFeed=0, vertFeed=0)

def	filterArcs (arcEdge)

def	findParentJob (obj)

def	findToolController (obj, name=None)

def	fmt (val)

def	getEnvelope (partshape, subshape=None, depthparams=None)

def	GetJobs (jobname=None)

def	getToolControllers (obj)

def	guessDepths (objshape, subs=None)

def	helicalPlunge (plungePos, rampangle, destZ, startZ, toold, plungeR, horizFeed)

def	horizontalEdgeLoop (obj, edge)

def	horizontalFaceLoop (obj, face, faceList=None)

def	isDrillable (obj, candidate, tooldiameter=None, includePartials=False)

def	loopdetect (obj, edge1, edge2)

def	makeWorkplane (shape)

def	rampPlunge (edge, rampangle, destZ, startZ)

def	rapid (x=None, y=None, z=None)

def	reverseEdge (e)

def	segments (poly)

def	sort_jobs (locations, keys, attractors=None)

def	translate (context, text, disambig=None)

def	waiting_effects (function)

Variables
	DraftGeomUtils

	Part

	TechDraw

	UserInput

Function Documentation

◆ addToJob()

def PathScripts.PathUtils.addToJob	(	obj,
		jobname = `None`
	)

adds a path object to a job
obj = obj
jobname = None

References PathScripts.PathUtils.GetJobs().

Referenced by PathScripts.post.gcode_pre.insert().

◆ arc()

def PathScripts.PathUtils.arc	(	cx,
		cy,
		sx,
		sy,
		ex,
		ey,
		horizFeed = `0`,
		ez = `None`,
		ccw = `False`
	)

Return gcode string to perform an arc.

Assumes XY plane or helix around Z
Don't worry about starting Z- assume that's dealt with elsewhere
If start/end radii aren't within eps, abort.

cx, cy -- arc center coordinates
sx, sy -- arc start coordinates
ex, ey -- arc end coordinates
ez -- ending Z coordinate.  None unless helix.
horizFeed -- horiz feed speed
ccw -- arc direction

Referenced by PathScripts.PathUtils.helicalPlunge().

◆ drillTipLength()

def PathScripts.PathUtils.drillTipLength ( tool )

returns the length of the drillbit tip.

◆ feed()

def PathScripts.PathUtils.feed	(	x = `None`,
		y = `None`,
		z = `None`,
		horizFeed = `0`,
		vertFeed = `0`
	)

Return gcode string to perform a linear feed.

Referenced by PathScripts.PathUtils.rampPlunge().

◆ filterArcs()

def PathScripts.PathUtils.filterArcs ( arcEdge )

filterArcs(Edge) -used to split arcs that over 180 degrees. Returns list

◆ findParentJob()

def PathScripts.PathUtils.findParentJob ( obj )

retrieves a parent job object for an operation or other Path object

Referenced by PathScripts.PathUtils.getToolControllers().

◆ findToolController()

def PathScripts.PathUtils.findToolController	(	obj,
		name = `None`
	)

returns a tool controller with a given name.
If no name is specified, returns the first controller.
if no controller is found, returns None

References PathScripts.PathUtils.getToolControllers().

Referenced by PathScripts.post.gcode_pre.insert().

◆ fmt()

def PathScripts.PathUtils.fmt ( val )

◆ getEnvelope()

def PathScripts.PathUtils.getEnvelope	(	partshape,
		subshape = `None`,
		depthparams = `None`
	)

getEnvelope(partshape, stockheight=None)
returns a shape corresponding to the partshape silhouette extruded to height.
if stockheight is given, the returned shape is extruded to that height otherwise the returned shape
is the height of the original shape boundbox
partshape = solid object
stockheight = float - Absolute Z height of the top of material before cutting.

References PathScripts.PathUtils.makeWorkplane().

◆ GetJobs()

def PathScripts.PathUtils.GetJobs ( jobname = None )

returns all jobs in the current document.  If name is given, returns that job

Referenced by PathScripts.PathUtils.addToJob().

◆ getToolControllers()

def PathScripts.PathUtils.getToolControllers ( obj )

returns all the tool controllers

References PathScripts.PathUtils.findParentJob().

Referenced by PathScripts.PathUtils.findToolController().

◆ guessDepths()

def PathScripts.PathUtils.guessDepths	(	objshape,
		subs = `None`
	)

takes an object shape and optional list of subobjects and returns a depth_params
object with suggested height/depth values.

objshape = Part::Shape.
subs = list of subobjects from objshape

◆ helicalPlunge()

def PathScripts.PathUtils.helicalPlunge	(	plungePos,
		rampangle,
		destZ,
		startZ,
		toold,
		plungeR,
		horizFeed
	)

Return gcode string to perform helical entry move.

plungePos -- vector of the helical entry location
destZ -- the lowest Z position or milling level
startZ -- Starting Z position for helical move
rampangle -- entry angle
toold -- tool diameter
plungeR -- the radius of the entry helix

References PathScripts.PathUtils.arc(), and PathScripts.PathUtils.rapid().

◆ horizontalEdgeLoop()

def PathScripts.PathUtils.horizontalEdgeLoop	(	obj,
		edge
	)

horizontalEdgeLoop(obj, edge) ... returns a wire in the horizontal plane, if that is the only horizontal wire the given edge is a part of.

Referenced by PathScripts.PathUtils.horizontalFaceLoop().

◆ horizontalFaceLoop()

def PathScripts.PathUtils.horizontalFaceLoop	(	obj,
		face,
		faceList = `None`
	)

horizontalFaceLoop(obj, face, faceList=None) ... returns a list of face names which form the walls of a vertical hole face is a part of.
All face names listed in faceList must be part of the hole for the solution to be returned.

References PathScripts.PathUtils.horizontalEdgeLoop().

◆ isDrillable()

def PathScripts.PathUtils.isDrillable	(	obj,
		candidate,
		tooldiameter = `None`,
		includePartials = `False`
	)

Checks candidates to see if they can be drilled.
Candidates can be either faces - circular or cylindrical or circular edges.
The tooldiameter can be optionally passed.  if passed, the check will return
False for any holes smaller than the tooldiameter.
obj=Shape
candidate = Face or Edge
tooldiameter=float

◆ loopdetect()

def PathScripts.PathUtils.loopdetect	(	obj,
		edge1,
		edge2
	)

Returns a loop wire that includes the two edges.
Useful for detecting boundaries of negative space features ie 'holes'
If a unique loop is not found, returns None
edge1 = edge
edge2 = edge

◆ makeWorkplane()

def PathScripts.PathUtils.makeWorkplane ( shape )

Creates a workplane circle at the ZMin level.

Referenced by PathScripts.PathUtils.getEnvelope().

◆ rampPlunge()

def PathScripts.PathUtils.rampPlunge	(	edge,
		rampangle,
		destZ,
		startZ
	)

Return gcode string to linearly ramp down to milling level.

edge -- edge to follow
rampangle -- entry angle
destZ -- Final Z depth
startZ -- Starting Z depth

FIXME: This ramps along the first edge, assuming it's long
enough, NOT just wiggling back and forth by ~0.75 * toolD.
Not sure if that's any worse, but it's simpler
I think this should be changed to be limited to a maximum ramp size.  Otherwise machine time will get longer than it needs to be.

References PathScripts.PathUtils.feed(), and PathScripts.PathUtils.rapid().

◆ rapid()

def PathScripts.PathUtils.rapid	(	x = `None`,
		y = `None`,
		z = `None`
	)

Returns gcode string to perform a rapid move.

Referenced by PathScripts.PathUtils.helicalPlunge(), and PathScripts.PathUtils.rampPlunge().

◆ reverseEdge()

def PathScripts.PathUtils.reverseEdge ( e )

◆ segments()

def PathScripts.PathUtils.segments ( poly )

A sequence of (x,y) numeric coordinates pairs

◆ sort_jobs()

def PathScripts.PathUtils.sort_jobs	(	locations,
		keys,
		attractors = `None`
	)

sort holes by the nearest neighbor method
    keys: two-element list of keys for X and Y coordinates. for example ['x','y']
    originally written by m0n5t3r for PathHelix

References DraftVecUtils.dist().

◆ translate()

def PathScripts.PathUtils.translate	(	context,
		text,
		disambig = `None`
	)

◆ waiting_effects()

def PathScripts.PathUtils.waiting_effects ( function )

Variable Documentation

◆ DraftGeomUtils

PathScripts.PathUtils.DraftGeomUtils

◆ Part

PathScripts.PathUtils.Part

◆ TechDraw

PathScripts.PathUtils.TechDraw

◆ UserInput

PathScripts.PathUtils.UserInput

Classes

Functions

Variables