Toolpath: Difference between revisions
(→.Tool) |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 11: | Line 11: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (integer) Active sheet index when toolpath was calculated. Older toolpaths will return 0 for this value until recalculated, use HasActiveSheetIndex to check for this case. | '''Returns:''' (integer) Active sheet index when toolpath was calculated. Older toolpaths will return 0 for this value until recalculated, use HasActiveSheetIndex to check for this case. | ||
| Line 18: | Line 18: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (Point3D) Position of first point in toolpath - start of first plunge move | '''Returns:''' (Point3D) Position of first point in toolpath - start of first plunge move | ||
| Line 27: | Line 27: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (UUID) returns group id of toolpath, if this toolpath is part of a group (e.g from flat bottomed vcarving). All toolpaths in a group will have the same group id | '''Returns:''' (UUID) returns group id of toolpath, if this toolpath is part of a group (e.g from flat bottomed vcarving). All toolpaths in a group will have the same group id | ||
| Line 34: | Line 34: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (bool) true if this toolpath has a record of active sheet index when it was calculated | '''Returns:''' (bool) true if this toolpath has a record of active sheet index when it was calculated | ||
| Line 41: | Line 41: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (UUID) returns id of toolpath, all toolpaths have a unique id | '''Returns:''' (UUID) returns id of toolpath, all toolpaths have a unique id | ||
| Line 48: | Line 48: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (bool) flag indicating if toolpath is in mm or inches | '''Returns:''' (bool) flag indicating if toolpath is in mm or inches | ||
| Line 55: | Line 55: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (Point3D) Position of last point in toolpath - end of last retract move | '''Returns:''' (Point3D) Position of last point in toolpath - end of last retract move | ||
| Line 62: | Line 62: | ||
'''Interaction:''' Read Write | '''Interaction:''' Read Write | ||
'''Returns:''' (string) name of toolpath - call ToolpathManager:ToolpathModified() after changing | '''Returns:''' (string) name of toolpath - call ToolpathManager:ToolpathModified() after changing | ||
| Line 69: | Line 69: | ||
'''Interaction:''' Read Write | '''Interaction:''' Read Write | ||
'''Returns:''' (string) notes for toolpath - call ToolpathManager:ToolpathModified() after changing | '''Returns:''' (string) notes for toolpath - call ToolpathManager:ToolpathModified() after changing | ||
| Line 76: | Line 76: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (ToolpathPosData) Position data (home pos, safe z etc) for toolpath | '''Returns:''' (ToolpathPosData) Position data (home pos, safe z etc) for toolpath | ||
| Line 83: | Line 83: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (Tool) returns a Tool object which references the tool in the toolpath and can be used to update | '''Returns:''' (Tool) returns a Tool object which references the tool in the toolpath and can be used to update | ||
the tool data. | the tool data. | ||
''See Tool:UpdateToolParameters()for more details.'' | |||
Also call ToolpathManager:ToolpathModified() after changing tool values. | Also call ToolpathManager:ToolpathModified() after changing tool values. | ||
| Line 91: | Line 93: | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (UUID) The side id on which this toolpath belongs | '''Returns:''' (UUID) The side id on which this toolpath belongs | ||
To compare this to another UUID, use | To compare this to another UUID, use | ||
Latest revision as of 17:11, 1 May 2024
The Toolpath object represents a toolpath within the program. Toolpaths are never created directly, they are created using the CreateXXX methods of ToolpathManager.
Properties
.ActiveSheetIndex
Interaction: Read Only
Returns: (integer) Active sheet index when toolpath was calculated. Older toolpaths will return 0 for this value until recalculated, use HasActiveSheetIndex to check for this case.
.FirstPoint
Interaction: Read Only
Returns: (Point3D) Position of first point in toolpath - start of first plunge move
.GroupId
Interaction: Read Only
Returns: (UUID) returns group id of toolpath, if this toolpath is part of a group (e.g from flat bottomed vcarving). All toolpaths in a group will have the same group id
.HasActiveSheetIndex
Interaction: Read Only
Returns: (bool) true if this toolpath has a record of active sheet index when it was calculated
.Id
Interaction: Read Only
Returns: (UUID) returns id of toolpath, all toolpaths have a unique id
.InMM
Interaction: Read Only
Returns: (bool) flag indicating if toolpath is in mm or inches
.LastPoint
Interaction: Read Only
Returns: (Point3D) Position of last point in toolpath - end of last retract move
.Name
Interaction: Read Write
Returns: (string) name of toolpath - call ToolpathManager:ToolpathModified() after changing
.Notes
Interaction: Read Write
Returns: (string) notes for toolpath - call ToolpathManager:ToolpathModified() after changing
.PositionData
Interaction: Read Only
Returns: (ToolpathPosData) Position data (home pos, safe z etc) for toolpath
.Tool
Interaction: Read Only
Returns: (Tool) returns a Tool object which references the tool in the toolpath and can be used to update
the tool data.
See Tool:UpdateToolParameters()for more details.
Also call ToolpathManager:ToolpathModified() after changing tool values.
.SideId
Interaction: Read Only
Returns: (UUID) The side id on which this toolpath belongs
To compare this to another UUID, use
luaUUID(toolpath.SideId).IsEqual( my_other_id)
Methods
:DeleteActiveSheetIndex()
Delete the record of the active sheet index for this toolpath.
:MachiningTime()
Return estimated machining time for toolpath. This estimate will use the Rapid Feed rate and Scale Factor set within the program on the ‘Toolpaths Summary’ page.
:ReplaceTool( Tool tool)
Replace the existing tool with the passed tool.
tool - Tool - tool which will replace the current tool in the tool-path
:Statistics()
Return a ToolpathStats object with information about tool-path such as total length of feed rate moves etc.
:Transform(Matrix2D xform)
Transform the toolpath using passed xform. Only translation and rotation are supported
xform - Matrix2D -transformation matrix to apply to toolpath
References
Please Note: The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 10.0, published August 21, 2019. by Vectric Ltd. Most current document from Vertric can be downloaded at Vertric Developer Information