command descriptions (2dae10b) - dxfngc · BlinkenArea

doc/dxfngc.xml

@@ -105,8 +104,8 @@
         the G-code list in memory.  Afterwards, the settings for processing the
         drawing to G-code are configured.  This includes the Z coordinates
         and the feed rates for moving and cutting as well as the diameter of
-        the cutting tool.  Please see !!!TODO!!! for a description of all
-        settings.
+        the cutting tool.  Please see the <code>set_*</code> commands in
+        <xref linkend="commands"/> for a description of all settings.
 
       </para>
 
@@ -115,15 +114,16 @@
         The <code>read_dxf</code> reads a CAD drawing in DXF format.  In this
         example, the logo drawing shown in <xref linkend="logo_drawing"/> is
         read.  This loads all layers of the DXF file to memory.  The layers can
-        then be processed with the cutting commands (see !!!TODO!!!) to produce
-        G-code.  The <code>cut_inside</code> command is used here to cut the
-        holes.  It will calculate the path of the cutting tool to be half its
-        diameter further to the inside of the holes.  This makes sure the hole
-        has the desired size and shape after cutting - or more precise as close
-        to it as possible with the selected cutting tool.  The
-        <code>cut_outside</code> command is used for cutting the border of the
-        stencil.  It basically works the same way, but moves the path of the
-        cutting tool further to the outside.
+        then be processed with the cutting commands (see <code>cut_*</code> in
+        <xref linkend="commands"/>) to produce G-code.  The
+        <code>cut_inside</code> command is used here to cut the holes.  It will
+        calculate the path of the cutting tool to be half its diameter further
+        to the inside of the holes.  This makes sure the hole has the desired
+        size and shape after cutting - or more precise as close to it as
+        possible with the selected cutting tool.  The <code>cut_outside</code>
+        command is used for cutting the border of the stencil.  It basically
+        works the same way, but moves the path of the cutting tool further to
+        the outside.
 
       </para>
 
@@ -214,5 +214,370 @@ write_ngc logo.ngc]]></programlisting>
 
   </sect1>
 
+  <sect1 xml:id="commands">
+
+    <title>Commands</title>
+
+    <sect2>
+
+      <title>cmd</title>
+
+      <para>
+
+        The <code>cmd &lt;G-code&gt;</code> command append an arbitrary G-code
+        command to the list of G-code commands in memory.  It is mainly used
+        to generate initialization G-code at the beginning and cleanup G-code
+        at the end of a script.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>cut</title>
+
+      <para>
+
+        The <code>cut &lt;layer&gt;</code> command generates G-code to cut
+        exactly at the lines of the specified layer from the loaded drawing
+        using the current settings.  It does not compensate for the diameter
+        of the cutting tool.  However, this command is able to process
+        arbitrary drawings, especially drawings that contain curves that are
+        not closed and/or do not form valid polygons.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>cut_inside</title>
+
+      <para>
+
+        The <code>cut_inside &lt;layer&gt;</code> command generates G-code to
+        cut along the insides of the polygons contained in the specified layer
+        using the current settings.  It tries to compensate for the for the
+        diameter of the cutting tool as much as geometrically possible.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>cut_outside</title>
+
+      <para>
+
+        The <code>cut_outside &lt;layer&gt;</code> command generates G-code to
+        cut along the outsides of the polygons contained in the specified layer
+        using the current settings.  It tries to compensate for the for the
+        diameter of the cutting tool as much as geometrically possible.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>cut_pcket</title>
+
+      <para>
+
+        The <code>cut_pocket &lt;layer&gt;</code> command generates G-code to
+        cut away the inside of the polygons contained in the specified layer
+        using the current settings.  It tries to compensate for the for the
+        diameter of the cutting tool as much as geometrically possible.  The
+        difference to the <code>cut_inside</code> command is that it does not
+        only cut along the insides of the polygon outline.  Instead it will
+        cover the entire area of the polygon.  This is useful if not cutting
+        all the way (in Z direction) through the material, so the inner part
+        will not fall out of the workpiece.  However, this comes at the cost of
+        a long cutting path.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>read_dxf</title>
+
+      <para>
+
+        The command <code>read_dxf &lt;filename&gt;</code> discards the current
+        drawing in memory and reads a 2D DXF drawing from the specified file.
+        The filename may be an absolute path or a relative one.  If it is
+        relative, it is interpreted relative to the directory of the script
+        file being processed.  Whitespace and non-ASCII characters are not
+        supported in the filename.  Most basic DXF primitives are supported.
+        Unsupported DXF primitives (e.g. like text) are silently ignored.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_base_z</title>
+
+      <para>
+
+        The command <code>set_base_z &lt;z&gt;</code> sets the Z coordinate
+        (in mm) at which cutting starts.  It is ususually set to the Z
+        coordinate of the workpiece surface.  All floating point values are
+        valid, the default is 0.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_cut_z</title>
+
+      <para>
+
+        The command <code>set_cut_z &lt;z&gt;</code> sets the Z coordinate
+        (in mm) to cut to.  For example, it is set to the Z coordinate of the
+        workpiece bottom in order to cut through the entire workpiece.
+        All floating point values are valid, the default is 0.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_cut_z_step</title>
+
+      <para>
+
+        The command <code>set_cut_z &lt;z-step&gt;</code> sets the step size
+        in Z direction (in mm) for cutting.  If the difference between base Z
+        and cut Z coordinates are larger than the Z step size, the cut is done
+        in multiple steps.  Each step cuts at as deep as the Z step size.
+        Only positive floating point values are valid values for this setting.
+        The default is 0.1.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_dwell_time</title>
+
+      <para>
+
+        The command <code>set_dwell_time &lt;time&gt;</code> sets the dwell
+        time (in seconds).  The CNC machine will stop moving for this time
+        before plunging downwards into the workpiece.  If the dwell time is
+        set to zeor, no dwell command is put into the G-code.  A positive
+        values causes generation of dwell commands with this time.  Negative
+        values are not allowed.  The default is no dwelling.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_feed_drill</title>
+
+      <para>
+
+        The command <code>set_feed_drill &lt;feed&gt;</code> sets the feed rate
+        (in mm per minute) for drilling into the material in Z direction.
+        Only positive values are allowed for this setting, the default is 10.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_feed_mill</title>
+
+      <para>
+
+        The command <code>set_feed_mill &lt;feed&gt;</code> sets the feed rate
+        (in mm per minute) for milling through the material in X/Y direction.
+        Only positive values are allowed for this setting, the default is 10.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_layer_mode</title>
+
+      <para>
+
+        If a layer contains multiple polygons or paths and cutting happens in
+        multiple steps in Z direction there are two possibilities to do the
+        cutting, which are selected via the <code>set_layer_mode
+        &lt;mode&gt;</code> command.  The <code>level_by_level</code> mode
+        (which is the default) will process each polygon or path at the current
+        cutting depth before moving the the next depth (i.e. the next Z step).
+        The <code>path_by_path</code> mode will cut each polygon or path step
+        by step until the cut Z coordinate is reached and then move to the next
+        polygon or path.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_move_z</title>
+
+      <para>
+
+        The command <code>set_move_z &lt;z&gt;</code> sets the Z coordinate
+        (in mm) at which movement between cuts is done.  It should be set high
+        emough to not hit any obstacles during movements.  Setting it to a
+        value too high will result in a lot of unneeded up/dowm movement
+        between cuts.  All floating point values are valid, the default is 10.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_offset_x</title>
+
+      <para>
+
+        The command <code>set_offset_x &lt;x&gt;</code> sets an offset in X
+        direction (in mm). All floating point values are valid, the default is
+        0, i.e. no offset.
+
+      </para>
+
+      <para>
+
+        The coordinates from the drawing are rotated around the origin and the
+        offsets in X and Y direction are added afterwards.  The resulting
+        coordinate is then used for G-code generation.  This allows to adapt
+        the coordinate system between the drawing and the CNC mill.  The offset
+        can also be used to cut a workpiece drawn once at multiple positions.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_offset_y</title>
+
+      <para>
+
+        The command <code>set_offset_y &lt;y&gt;</code> sets an offset in X
+        direction (in mm). All floating point values are valid, the default is
+        0, i.e. no offset.
+
+      </para>
+
+      <para>
+
+        The coordinates from the drawing are rotated around the origin and
+        the offsets in X and Y direction are added afterwards.  The resulting
+        coordinate is then used for G-code generation.  This allows to adapt
+        the coordinate system between the drawing and the CNC mill.  The offset
+        can also be used to cut a workpiece drawn once at multiple positions.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_precision</title>
+
+      <para>
+
+        The command <code>set_precision &lt;precision&gt;</code> sets the
+        precision to do all calculations with (in mm).  If the distance
+        between two coordinates is less then the precision setting, they are
+        considered equal for G-code generation.  Only positive floating point
+        values smaller than 1 are valid, the default is 0.001.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_rotation_z</title>
+
+      <para>
+
+        The command <code>set_rotation_z &lt;angle&gt;</code> sets the rotation
+        angle around the Z axis (in degrees, counter-clockwise). All floating
+        point values are valid, the default is 0, i.e. no rotation.
+
+      </para>
+
+      <para>
+
+        The coordinates from the drawing are rotated around the origin and
+        the offsets in X and Y direction are added afterwards.  The resulting
+        coordinate is then used for G-code generation.  This allows to adapt
+        the coordinate system between the drawing and the CNC mill.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>set_tool_diameter</title>
+
+      <para>
+
+        The command <code>set_tool_diameter &lt;diameter&gt;</code> sets the
+        diameter of the cutting tool (in mm).  It is used in some of the
+        <code>cut_*</code> commands.  Only non-negative floating
+        point values are valid, the default is 1.
+
+      </para>
+
+      <para>
+
+        The dxfngc tool assumes a flat end mill is used.  If a cutting tool
+        with another shape is used in the CNC mill, please note that the
+        diameter compensation code assumes a fixed diameter of the tool over
+        its whole length.  However, if this is kept in mind, it is also
+        possible to use cutting tools with other shapes.
+
+      </para>
+
+    </sect2>
+
+    <sect2>
+
+      <title>write_ngc</title>
+
+      <para>
+
+        The command <code>write_ngc &lt;filename&gt;</code> writes the current
+        list of G-code commands kept in memory to the specified file.  The
+        filename may be an absolute path or a relative one.  If it is relative,
+        it is interpreted relative to the directory of the script file being
+        processed.  Whitespace and non-ASCII characters are not supported in
+        the filename.  This command is usually used at the end of the script to
+        output the generated G-code.
+
+      </para>
+
+    </sect2>
+
+  </sect1>
+
 </article>
 


...	...	@@ -105,8 +104,8 @@
105	104	the G-code list in memory. Afterwards, the settings for processing the
106	105	drawing to G-code are configured. This includes the Z coordinates
107	106	and the feed rates for moving and cutting as well as the diameter of
108		- the cutting tool. Please see !!!TODO!!! for a description of all
109		- settings.
	107	+ the cutting tool. Please see the <code>set_*</code> commands in
	108	+ <xref linkend="commands"/> for a description of all settings.
110	109
111	110	</para>
112	111
...	...	@@ -115,15 +114,16 @@
115	114	The <code>read_dxf</code> reads a CAD drawing in DXF format. In this
116	115	example, the logo drawing shown in <xref linkend="logo_drawing"/> is
117	116	read. This loads all layers of the DXF file to memory. The layers can
118		- then be processed with the cutting commands (see !!!TODO!!!) to produce
119		- G-code. The <code>cut_inside</code> command is used here to cut the
120		- holes. It will calculate the path of the cutting tool to be half its
121		- diameter further to the inside of the holes. This makes sure the hole
122		- has the desired size and shape after cutting - or more precise as close
123		- to it as possible with the selected cutting tool. The
124		- <code>cut_outside</code> command is used for cutting the border of the
125		- stencil. It basically works the same way, but moves the path of the
126		- cutting tool further to the outside.
	117	+ then be processed with the cutting commands (see <code>cut_*</code> in
	118	+ <xref linkend="commands"/>) to produce G-code. The
	119	+ <code>cut_inside</code> command is used here to cut the holes. It will
	120	+ calculate the path of the cutting tool to be half its diameter further
	121	+ to the inside of the holes. This makes sure the hole has the desired
	122	+ size and shape after cutting - or more precise as close to it as
	123	+ possible with the selected cutting tool. The <code>cut_outside</code>
	124	+ command is used for cutting the border of the stencil. It basically
	125	+ works the same way, but moves the path of the cutting tool further to
	126	+ the outside.
127	127
128	128	</para>
129	129
...	...	@@ -214,5 +214,370 @@ write_ngc logo.ngc]]></programlisting>
214	214
215	215	</sect1>
216	216
	217	+ <sect1 xml:id="commands">
	218	+
	219	+ <title>Commands</title>
	220	+
	221	+ <sect2>
	222	+
	223	+ <title>cmd</title>
	224	+
	225	+ <para>
	226	+
	227	+ The <code>cmd <G-code></code> command append an arbitrary G-code
	228	+ command to the list of G-code commands in memory. It is mainly used
	229	+ to generate initialization G-code at the beginning and cleanup G-code
	230	+ at the end of a script.
	231	+
	232	+ </para>
	233	+
	234	+ </sect2>
	235	+
	236	+ <sect2>
	237	+
	238	+ <title>cut</title>
	239	+
	240	+ <para>
	241	+
	242	+ The <code>cut <layer></code> command generates G-code to cut
	243	+ exactly at the lines of the specified layer from the loaded drawing
	244	+ using the current settings. It does not compensate for the diameter
	245	+ of the cutting tool. However, this command is able to process
	246	+ arbitrary drawings, especially drawings that contain curves that are
	247	+ not closed and/or do not form valid polygons.
	248	+
	249	+ </para>
	250	+
	251	+ </sect2>
	252	+
	253	+ <sect2>
	254	+
	255	+ <title>cut_inside</title>
	256	+
	257	+ <para>
	258	+
	259	+ The <code>cut_inside <layer></code> command generates G-code to
	260	+ cut along the insides of the polygons contained in the specified layer
	261	+ using the current settings. It tries to compensate for the for the
	262	+ diameter of the cutting tool as much as geometrically possible.
	263	+
	264	+ </para>
	265	+
	266	+ </sect2>
	267	+
	268	+ <sect2>
	269	+
	270	+ <title>cut_outside</title>
	271	+
	272	+ <para>
	273	+
	274	+ The <code>cut_outside <layer></code> command generates G-code to
	275	+ cut along the outsides of the polygons contained in the specified layer
	276	+ using the current settings. It tries to compensate for the for the
	277	+ diameter of the cutting tool as much as geometrically possible.
	278	+
	279	+ </para>
	280	+
	281	+ </sect2>
	282	+
	283	+ <sect2>
	284	+
	285	+ <title>cut_pcket</title>
	286	+
	287	+ <para>
	288	+
	289	+ The <code>cut_pocket <layer></code> command generates G-code to
	290	+ cut away the inside of the polygons contained in the specified layer
	291	+ using the current settings. It tries to compensate for the for the
	292	+ diameter of the cutting tool as much as geometrically possible. The
	293	+ difference to the <code>cut_inside</code> command is that it does not
	294	+ only cut along the insides of the polygon outline. Instead it will
	295	+ cover the entire area of the polygon. This is useful if not cutting
	296	+ all the way (in Z direction) through the material, so the inner part
	297	+ will not fall out of the workpiece. However, this comes at the cost of
	298	+ a long cutting path.
	299	+
	300	+ </para>
	301	+
	302	+ </sect2>
	303	+
	304	+ <sect2>
	305	+
	306	+ <title>read_dxf</title>
	307	+
	308	+ <para>
	309	+
	310	+ The command <code>read_dxf <filename></code> discards the current
	311	+ drawing in memory and reads a 2D DXF drawing from the specified file.
	312	+ The filename may be an absolute path or a relative one. If it is
	313	+ relative, it is interpreted relative to the directory of the script
	314	+ file being processed. Whitespace and non-ASCII characters are not
	315	+ supported in the filename. Most basic DXF primitives are supported.
	316	+ Unsupported DXF primitives (e.g. like text) are silently ignored.
	317	+
	318	+ </para>
	319	+
	320	+ </sect2>
	321	+
	322	+ <sect2>
	323	+
	324	+ <title>set_base_z</title>
	325	+
	326	+ <para>
	327	+
	328	+ The command <code>set_base_z <z></code> sets the Z coordinate
	329	+ (in mm) at which cutting starts. It is ususually set to the Z
	330	+ coordinate of the workpiece surface. All floating point values are
	331	+ valid, the default is 0.
	332	+
	333	+ </para>
	334	+
	335	+ </sect2>
	336	+
	337	+ <sect2>
	338	+
	339	+ <title>set_cut_z</title>
	340	+
	341	+ <para>
	342	+
	343	+ The command <code>set_cut_z <z></code> sets the Z coordinate
	344	+ (in mm) to cut to. For example, it is set to the Z coordinate of the
	345	+ workpiece bottom in order to cut through the entire workpiece.
	346	+ All floating point values are valid, the default is 0.
	347	+
	348	+ </para>
	349	+
	350	+ </sect2>
	351	+
	352	+ <sect2>
	353	+
	354	+ <title>set_cut_z_step</title>
	355	+
	356	+ <para>
	357	+
	358	+ The command <code>set_cut_z <z-step></code> sets the step size
	359	+ in Z direction (in mm) for cutting. If the difference between base Z
	360	+ and cut Z coordinates are larger than the Z step size, the cut is done
	361	+ in multiple steps. Each step cuts at as deep as the Z step size.
	362	+ Only positive floating point values are valid values for this setting.
	363	+ The default is 0.1.
	364	+
	365	+ </para>
	366	+
	367	+ </sect2>
	368	+
	369	+ <sect2>
	370	+
	371	+ <title>set_dwell_time</title>
	372	+
	373	+ <para>
	374	+
	375	+ The command <code>set_dwell_time <time></code> sets the dwell
	376	+ time (in seconds). The CNC machine will stop moving for this time
	377	+ before plunging downwards into the workpiece. If the dwell time is
	378	+ set to zeor, no dwell command is put into the G-code. A positive
	379	+ values causes generation of dwell commands with this time. Negative
	380	+ values are not allowed. The default is no dwelling.
	381	+
	382	+ </para>
	383	+
	384	+ </sect2>
	385	+
	386	+ <sect2>
	387	+
	388	+ <title>set_feed_drill</title>
	389	+
	390	+ <para>
	391	+
	392	+ The command <code>set_feed_drill <feed></code> sets the feed rate
	393	+ (in mm per minute) for drilling into the material in Z direction.
	394	+ Only positive values are allowed for this setting, the default is 10.
	395	+
	396	+ </para>
	397	+
	398	+ </sect2>
	399	+
	400	+ <sect2>
	401	+
	402	+ <title>set_feed_mill</title>
	403	+
	404	+ <para>
	405	+
	406	+ The command <code>set_feed_mill <feed></code> sets the feed rate
	407	+ (in mm per minute) for milling through the material in X/Y direction.
	408	+ Only positive values are allowed for this setting, the default is 10.
	409	+
	410	+ </para>
	411	+
	412	+ </sect2>
	413	+
	414	+ <sect2>
	415	+
	416	+ <title>set_layer_mode</title>
	417	+
	418	+ <para>
	419	+
	420	+ If a layer contains multiple polygons or paths and cutting happens in
	421	+ multiple steps in Z direction there are two possibilities to do the
	422	+ cutting, which are selected via the <code>set_layer_mode
	423	+ <mode></code> command. The <code>level_by_level</code> mode
	424	+ (which is the default) will process each polygon or path at the current
	425	+ cutting depth before moving the the next depth (i.e. the next Z step).
	426	+ The <code>path_by_path</code> mode will cut each polygon or path step
	427	+ by step until the cut Z coordinate is reached and then move to the next
	428	+ polygon or path.
	429	+
	430	+ </para>
	431	+
	432	+ </sect2>
	433	+
	434	+ <sect2>
	435	+
	436	+ <title>set_move_z</title>
	437	+
	438	+ <para>
	439	+
	440	+ The command <code>set_move_z <z></code> sets the Z coordinate
	441	+ (in mm) at which movement between cuts is done. It should be set high
	442	+ emough to not hit any obstacles during movements. Setting it to a
	443	+ value too high will result in a lot of unneeded up/dowm movement
	444	+ between cuts. All floating point values are valid, the default is 10.
	445	+
	446	+ </para>
	447	+
	448	+ </sect2>
	449	+
	450	+ <sect2>
	451	+
	452	+ <title>set_offset_x</title>
	453	+
	454	+ <para>
	455	+
	456	+ The command <code>set_offset_x <x></code> sets an offset in X
	457	+ direction (in mm). All floating point values are valid, the default is
	458	+ 0, i.e. no offset.
	459	+
	460	+ </para>
	461	+
	462	+ <para>
	463	+
	464	+ The coordinates from the drawing are rotated around the origin and the
	465	+ offsets in X and Y direction are added afterwards. The resulting
	466	+ coordinate is then used for G-code generation. This allows to adapt
	467	+ the coordinate system between the drawing and the CNC mill. The offset
	468	+ can also be used to cut a workpiece drawn once at multiple positions.
	469	+
	470	+ </para>
	471	+
	472	+ </sect2>
	473	+
	474	+ <sect2>
	475	+
	476	+ <title>set_offset_y</title>
	477	+
	478	+ <para>
	479	+
	480	+ The command <code>set_offset_y <y></code> sets an offset in X
	481	+ direction (in mm). All floating point values are valid, the default is
	482	+ 0, i.e. no offset.
	483	+
	484	+ </para>
	485	+
	486	+ <para>
	487	+
	488	+ The coordinates from the drawing are rotated around the origin and
	489	+ the offsets in X and Y direction are added afterwards. The resulting
	490	+ coordinate is then used for G-code generation. This allows to adapt
	491	+ the coordinate system between the drawing and the CNC mill. The offset
	492	+ can also be used to cut a workpiece drawn once at multiple positions.
	493	+
	494	+ </para>
	495	+
	496	+ </sect2>
	497	+
	498	+ <sect2>
	499	+
	500	+ <title>set_precision</title>
	501	+
	502	+ <para>
	503	+
	504	+ The command <code>set_precision <precision></code> sets the
	505	+ precision to do all calculations with (in mm). If the distance
	506	+ between two coordinates is less then the precision setting, they are
	507	+ considered equal for G-code generation. Only positive floating point
	508	+ values smaller than 1 are valid, the default is 0.001.
	509	+
	510	+ </para>
	511	+
	512	+ </sect2>
	513	+
	514	+ <sect2>
	515	+
	516	+ <title>set_rotation_z</title>
	517	+
	518	+ <para>
	519	+
	520	+ The command <code>set_rotation_z <angle></code> sets the rotation
	521	+ angle around the Z axis (in degrees, counter-clockwise). All floating
	522	+ point values are valid, the default is 0, i.e. no rotation.
	523	+
	524	+ </para>
	525	+
	526	+ <para>
	527	+
	528	+ The coordinates from the drawing are rotated around the origin and
	529	+ the offsets in X and Y direction are added afterwards. The resulting
	530	+ coordinate is then used for G-code generation. This allows to adapt
	531	+ the coordinate system between the drawing and the CNC mill.
	532	+
	533	+ </para>
	534	+
	535	+ </sect2>
	536	+
	537	+ <sect2>
	538	+
	539	+ <title>set_tool_diameter</title>
	540	+
	541	+ <para>
	542	+
	543	+ The command <code>set_tool_diameter <diameter></code> sets the
	544	+ diameter of the cutting tool (in mm). It is used in some of the
	545	+ <code>cut_*</code> commands. Only non-negative floating
	546	+ point values are valid, the default is 1.
	547	+
	548	+ </para>
	549	+
	550	+ <para>
	551	+
	552	+ The dxfngc tool assumes a flat end mill is used. If a cutting tool
	553	+ with another shape is used in the CNC mill, please note that the
	554	+ diameter compensation code assumes a fixed diameter of the tool over
	555	+ its whole length. However, if this is kept in mind, it is also
	556	+ possible to use cutting tools with other shapes.
	557	+
	558	+ </para>
	559	+
	560	+ </sect2>
	561	+
	562	+ <sect2>
	563	+
	564	+ <title>write_ngc</title>
	565	+
	566	+ <para>
	567	+
	568	+ The command <code>write_ngc <filename></code> writes the current
	569	+ list of G-code commands kept in memory to the specified file. The
	570	+ filename may be an absolute path or a relative one. If it is relative,
	571	+ it is interpreted relative to the directory of the script file being
	572	+ processed. Whitespace and non-ASCII characters are not supported in
	573	+ the filename. This command is usually used at the end of the script to
	574	+ output the generated G-code.
	575	+
	576	+ </para>
	577	+
	578	+ </sect2>
	579	+
	580	+ </sect1>
	581	+
217	582	</article>
218	583
219	584