Dmap2gcode Manual 2/10/21, 12'58 PM
Manual
Contents
• Top
Dmap2Gcode Manual
• Tips from Scorch
• Command Line Options
• Configuration File
• Main Window Settings
Dmap2Gcode Home Download Scorch Works Home
• General Settings
• Roughing Settings
Command Line Options
python [Link] [-g file ]
Usage or
[Link] [-g file ]
dmap2gcode g-code output file to read. Reading the settings from previously saved g-code files
-g
only works if the "Suppress Comments" option was not selected in the "General settings" when
(or --
the g-code file was saved. The default is to suppress the comments because a lot of people are
gcode_file)
using GRBL these days and GRBL does not handle comments well.
-h
print syntax help to console window.
(or --help)
Example
(Using
python
script with python [Link] -g my_file.ngc
preinstalled
python
distribution)
Example
(Using
precompiled [Link] -g my_file.ngc
Windows
executable)
Keyboard Shortcuts
Open the Help dialog box. (There is nothing in the help except a reference back to the web page and my e-
F1
mail address)
F2 Opens General Settings Window
F3 Opens Roughing Settings Window
F5 Refresh display
Configuration File
When Dmap2gcode starts up the the directory in which Dmap2gcode starts in is searched
[Link] Page 1 of 8
Dmap2gcode Manual 2/10/21, 12'58 PM
for a file named "[Link]". If the file is found it is read and all of the Dmap2gcode
options are set according to the settings saved in the config file. After searching for the
config file in the current directory the users home directory is searched for
[Link] "[Link]" or ".dmap2gcoderc" if either of these are found it will be used as the
or default settings. Only the first config file found is read.
.dmap2gcoderc
To create a config file with your preferred options for startup just open Dmap2gcode and
change the settings to your liking and save a file called "[Link]" in the users
home directory or the directory Dmap2gcode is called from. (If you are not using the
precompiled windows executable you could also just edit the settings in the .py file)
Start Now
File size: 17.8MB. OS: macOS
[Link] OPEN
Main Window
[Link] Page 2 of 8
Dmap2gcode Manual 2/10/21, 12'58 PM
Input
Description
Field
The size of the G-Code output for the image in the Y direction (displayed as vertical on the screen)
Image If cutting the full image the tool will move exactly the Image height in the Y direction. This means
Height that if you are cutting with a flat cutter the actual cut size will be the Image height plus the diameter
of the cutting tool.
This dimension is automatically calculated and displayed to indicate the width or X axis size of the
Image
image G-Code output. This dimension is a function of the image aspect ratio and the "Image
Width
Height".
This dimension is automatically calculated and displayed to indicate the resulting size of a single
Pixel Size
pixel based on the selected image and the "Image height" input.
The depth color setting determines whether the depth of cut is determined by the darkness (black)
Depth or lightness (white) of the image. If "black" is selected the portions of the image that are black will be
Color the deepest cuts and white portions of the image will be at Z equals zero. Conversely if "white" is
selected the white areas of the image will be cut the deepest.
Normalize Selecting this option tells the program to treat the darkest pixel as if it were black and the lightest
Depth pixel as if it were white. The remaining levels of grey between are stretched fill the range.
The origin determines the relative location of the g-code x and y zero location. The current location
Origin of the origin is displayed in the display window as a red and green lines. The red and green lines
follow the RGB convention Red is the x-axis, Green in the y-axis.
If "Cut Top Surface" is selected the whole image is cut even if the cut depth is zero. If this option is
Cut Top
not selected the top surface is not cut. The tool path will move to Z-safe and rapid past the areas
Surface
not cut.
Top The "Top Tolerance" determines how far a calculated cut has to be below the zero position before it
Tolerance is not considered a top surface cut.
Tool DIA Specify the tool diameter.
Tool End Specifies the tool shape (Ball End, Flat End, or V-Bit)
[Link] Page 3 of 8
Dmap2gcode Manual 2/10/21, 12'58 PM
V Bit
If the V-bit tool end option is selected this option determines the included angle of the V-bit.
Angle
Scan This option determines if g-code is generated for the "Rows" (X direction), "Columns" (Y direction)
Pattern or both "R then C" (Rows then Columns) or "C then R" (Columns then Rows).
Cut This option adds a perimeter cut to the g-code output when only "Rows" or only "Columns" is
Perimeter selected for the "Scan pattern". This can eliminate a scalloped look at the edge of an image.
"Scan Direction" determines the cutting direction methodology.
Positive: Start milling at a low X or Y axis value, and move towards a high X or Y axis value
Negative: Start milling at a high X or Y axis value, and move towards a low X or Y axis value
Scan
Alternating: Start on the same end of the X or Y axis travel that the last move ended on. This
Direction
reduces the amount of traverse movements
Up Milling: Start milling at low points, moving towards high points
Down Milling: Start milling at high points, moving towards low points
Feed
Specify the tool feed rate that is output in the g-code output file.
Rate
Plunge Specify the tool feed rate that is output in the g-code output file when moving vertically into the
Feed material.
Stepover The distance between adjacent rows or columns.
Z Safe This is the z location that the tool will be directed to prior to any rapid moved.
Max Cut
The depth of the deepest possible cut into the material.
Depth
General Settings
[Link] Page 4 of 8
Dmap2gcode Manual 2/10/21, 12'58 PM
Input
Description
Field
Units Set the units used by Dmap2gcode to inches or mm. This option affects the displayed units and the
(inch/mm) units output in the g-code.
When a series of points are within tolerance of being a straight line, they are output as a straight
Tolerance line. Increasing tolerance can lead to better contouring performance in LinuxCNC, but can also
remove or blur small details in the image.
The text that is entered in the G-Code header entry box is added to the beginning of the g-code
commands in the Dmap2gcode output file. The commands are interpreted by the CNC machine as
entered. The default values (G17 G90 G64 M3 S3000 M7) are explained below:
G17
Sets XY plane
G90
G Code Fixed cycle, simple cycle, for roughing (Z-axis emphasis)
Header G64
G64 without P option keeps the best speed possible, no matter how far away from the
programmed point you end up.
M3 S3000
Spindle start at 3000
M7
Turn mist coolant on (if it is available)
The text that is entered in the G-Code Postscript entry box is added to the end of the g-code
commands in the Dmap2gcode output file. The commands are interpreted by the CNC machine as
entered . The default values (M5 M9 M2) are explained below:
M5
G Code
Stop Spindle
Postscript
M9
Turn all coolant off
M2
End Program
"Lace Bounding" controls whether areas that are relatively flat along a row or column are skipped.
This option only makes sense when both rows and columns are being milled. Possible bounding
options are:
None: Rows and columns are both fully milled.
Lace Secondary: When milling in the second direction, areas that do not strongly slope in that
Bounding direction are skipped.
Full: When milling in the first direction, areas that strongly slope in the second direction are
skipped. When milling in the second direction, areas that do not strongly slope in that direction
are skipped.
LB
When Lace bounding is not None, slopes greater than Contact angle are considered to be "strong"
Contact
slopes, and slopes less than that angle are considered to be weak slopes.
angle
[Link] Page 5 of 8
Dmap2gcode Manual 2/10/21, 12'58 PM
This option allows offsetting the stepover by 1/2 or 1/4 step. If you cut an image and find that the
Offset scan lines were not close enough together switch this option to 1/2 and generate a new g-code file.
Stepover The new file will have the same stepover, however, the steps will be offset by 1/2 step so that the
scan lines will be between the previous scan lines. Repeating the process with 1/4 step will
automatically half the step size and cut between all of the previously cut scan lines
Specifies whether a straight vertical plunge or an arced plunge is to be used for entry into the cut.
Plunge
(NOTE: The arc entry may cause more material to be removed at the entry point. Creating a scallop
Type
outside of the image (height + tool diameter) or (width + tool diameter) boundary)
Roughing Settings
[Link] Page 6 of 8
Dmap2gcode Manual 2/10/21, 12'58 PM
Input Field Description
Roughing Tool DIA Analogous to the "Tool DIA" specifically for the roughing operation.
Roughing Tool End Analogous to the "Tool DIA" specifically for the roughing operation.
Roughing V Bit
Analogous to the "V Bit Angle" specifically for the roughing operation.
Angle
Roughing Scan
Analogous to the "Scan Pattern" specifically for the roughing operation.
Pattern
Roughing Scan
Analogous to the "Scan Direction" specifically for the roughing operation.
Direction
Roughing Feed
Analogous to the "Feed Rate" specifically for the roughing operation.
Rate
Roughing Plunge
Analogous to the "Plunge Feed" specifically for the roughing operation.
Feed
Roughing Stepover Analogous to the "Stepover" specifically for the roughing operation.
The "Roughing Offset" is the thickness of material to be left behind after the roughing
Roughing Offset
operation os complete.
Roughing
The maximum depth of cut four each roughing pass.
Depth/Pass
[Link] Page 7 of 8
Dmap2gcode Manual 2/10/21, 12'58 PM
Scorch Works Home
[Link] Page 8 of 8