242 lines
4.9 KiB
ReStructuredText
242 lines
4.9 KiB
ReStructuredText
.. _cmdreference:
|
|
|
|
Shell Command Reference
|
|
=======================
|
|
|
|
.. warning::
|
|
The FlatCAM Shell is under development and its behavior might change in the future. This includes available commands and their syntax.
|
|
|
|
.. _add_circle:
|
|
|
|
add_circle
|
|
~~~~~~~~~~
|
|
Creates a circle in the given Geometry object.
|
|
|
|
> add_circle <name> <center_x> <center_y> <radius>
|
|
name: Name of the geometry object to which to append the circle.
|
|
|
|
center_x, center_y: Coordinates of the center of the circle.
|
|
|
|
radius: Radius of the circle.
|
|
|
|
.. _add_poly:
|
|
|
|
add_poly
|
|
~~~~~~~~
|
|
Creates a polygon in the given Geometry object.
|
|
|
|
> create_poly <name> <x0> <y0> <x1> <y1> <x2> <y2> [x3 y3 [...]]
|
|
name: Name of the geometry object to which to append the polygon.
|
|
|
|
xi, yi: Coordinates of points in the polygon.
|
|
|
|
.. _add_rect:
|
|
|
|
add_rect
|
|
~~~~~~~~
|
|
Creates a rectange in the given Geometry object.
|
|
|
|
> add_rect <name> <botleft_x> <botleft_y> <topright_x> <topright_y>
|
|
name: Name of the geometry object to which to append the rectangle.
|
|
|
|
botleft_x, botleft_y: Coordinates of the bottom left corner.
|
|
|
|
topright_x, topright_y Coordinates of the top right corner.
|
|
|
|
cncjob
|
|
~~~~~~
|
|
Generates a CNC Job from a Geometry Object.
|
|
|
|
> cncjob <name> [-z_cut <c>] [-z_move <m>] [-feedrate <f>] [-tooldia <t>] [-outname <n>]
|
|
name: Name of the source object
|
|
|
|
z_cut: Z-axis cutting position
|
|
|
|
z_move: Z-axis moving position
|
|
|
|
feedrate: Moving speed when cutting
|
|
|
|
tooldia: Tool diameter to show on screen
|
|
|
|
outname: Name of the output object
|
|
|
|
delete
|
|
~~~~~~
|
|
Deletes the give object.
|
|
|
|
> delete <name>
|
|
name: Name of the object to delete.
|
|
|
|
follow
|
|
~~~~~~
|
|
Creates a geometry object following gerber paths.
|
|
|
|
> follow <name> [-outname <oname>]
|
|
name: Name of the gerber object.
|
|
|
|
outname: Name of the output geometry object.
|
|
|
|
.. _geo_union:
|
|
|
|
geo_union
|
|
~~~~~~~~~
|
|
Runs a union operation (addition) on the components of the geometry object. For example, if it contains 2 intersecting polygons, this opperation adds them intoa single larger polygon.
|
|
|
|
> geo_union <name>
|
|
name: Name of the geometry object.
|
|
|
|
get_names
|
|
~~~~~~~~~
|
|
Lists the names of objects in the project.
|
|
|
|
|
|
> get_names
|
|
No parameters.
|
|
|
|
help
|
|
~~~~
|
|
Shows list of commands.
|
|
|
|
isolate
|
|
~~~~~~~
|
|
Creates isolation routing geometry for the given Gerber.
|
|
|
|
> isolate <name> [-dia <d>] [-passes <p>] [-overlap <o>]
|
|
name: Name of the object
|
|
|
|
dia: Tool diameter
|
|
|
|
passes: # of tool width
|
|
|
|
overlap: Fraction of tool diameter to overlap passes
|
|
|
|
make_docs
|
|
~~~~~~~~~
|
|
Prints command rererence in reStructuredText format.
|
|
|
|
new
|
|
~~~
|
|
Starts a new project. Clears objects from memory.
|
|
|
|
|
|
> new
|
|
No parameters.
|
|
|
|
.. _new_geometry:
|
|
|
|
new_geometry
|
|
~~~~~~~~~~~~
|
|
Creates a new empty geometry object.
|
|
|
|
> new_geometry <name>
|
|
name: New object name
|
|
|
|
.. _offset:
|
|
|
|
offset
|
|
~~~~~~
|
|
Changes the position of the object.
|
|
|
|
> offset <name> <x> <y>
|
|
name: Name of the object
|
|
|
|
x: X-axis distance
|
|
|
|
y: Y-axis distance
|
|
|
|
open_excellon
|
|
~~~~~~~~~~~~~
|
|
Opens an Excellon file.
|
|
|
|
> open_excellon <filename> [-outname <o>]
|
|
filename: Path to file to open.
|
|
|
|
outname: Name of the created excellon object.
|
|
|
|
open_gcode
|
|
~~~~~~~~~~
|
|
Opens an G-Code file.
|
|
|
|
> open_gcode <filename> [-outname <o>]
|
|
filename: Path to file to open.
|
|
|
|
outname: Name of the created CNC Job object.
|
|
|
|
open_gerber
|
|
~~~~~~~~~~~
|
|
Opens a Gerber file.
|
|
|
|
> open_gerber <filename> [-follow <0|1>] [-outname <o>]
|
|
filename: Path to file to open.
|
|
|
|
follow: If 1, does not create polygons, just follows the gerber path.
|
|
|
|
outname: Name of the created gerber object.
|
|
|
|
open_project
|
|
~~~~~~~~~~~~
|
|
Opens a FlatCAM project.
|
|
|
|
> open_project <filename>
|
|
filename: Path to file to open.
|
|
|
|
options
|
|
~~~~~~~
|
|
Shows the settings for an object.
|
|
|
|
|
|
> options <name>
|
|
name: Object name.
|
|
|
|
paint_poly
|
|
~~~~~~~~~~
|
|
Creates a geometry object with toolpath to cover the inside of a polygon.
|
|
|
|
> paint_poly <name> <inside_pt_x> <inside_pt_y> <tooldia> <overlap>
|
|
name: Name of the sourge geometry object.
|
|
|
|
inside_pt_x, inside_pt_y: Coordinates of a point inside the polygon.
|
|
|
|
tooldia: Diameter of the tool to be used.
|
|
|
|
overlap: Fraction of the tool diameter to overlap cuts.
|
|
|
|
plot
|
|
~~~~
|
|
Updates the plot on the user interface
|
|
|
|
save_project
|
|
~~~~~~~~~~~~
|
|
Saves the FlatCAM project to file.
|
|
|
|
> save_project <filename>
|
|
filename: Path to file to save.
|
|
|
|
.. _scale:
|
|
|
|
scale
|
|
~~~~~
|
|
Resizes the object by a factor.
|
|
|
|
> scale <name> <factor>
|
|
name: Name of the object
|
|
|
|
factor: Fraction by which to scale
|
|
|
|
set_active
|
|
~~~~~~~~~~
|
|
Sets a FlatCAM object as active.
|
|
|
|
|
|
> set_active <name>
|
|
name: Name of the object.
|
|
|
|
write_gcode
|
|
~~~~~~~~~~~
|
|
Saves G-code of a CNC Job object to file.
|
|
|
|
> write_gcode <name> <filename>
|
|
name: Source CNC Job object
|
|
|
|
filename: Output filename
|