svg2gcode 3.2.5__tar.gz → 3.2.6__tar.gz

{svg2gcode-3.2.5 → svg2gcode-3.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: svg2gcode
-Version: 3.2.5
+Version: 3.2.6
 Summary: svg2gcode: convert an SVG (Scalable Vector Graphic) image to gcode.
 Keywords: scalable vector graphics,svg,image,laser cutter,laser engraving
 Author-email: Johannes Noordanus <mailjohannes.mailnoordanus@gmail.com>
@@ -127,7 +127,7 @@ options:
   --overscan <default:0>
                         overscan image lines to avoid incorrect power levels for pixels at left and right borders, number in pixels, default off
   --showoverscan        show overscan pixels (note that this is visible and part of the gcode emitted!)
-  --constantburn        use constant burn mode M3 (a bit more dangerous!), instead of dynamic burn mode M4
+  --constantburn        set constant burn mode M3 (default set to dynamic burn mode M4); this enhances engraving quality
   --origin delta-x delta-y
                         translate origin by vector (delta-x,delta-y) in mm (default not set, option --selfcenter cannot be used at the same time)
   --scale factor-x factor-y
@@ -290,6 +290,10 @@ One containing the drawings of the .svg, the other containing the images:
     > logo_images.gc      # all images
 ```   
 
+### Burn mode M3/M4:
+
+Default *svg2gcode* uses dynamic burn mode *M4*. This can be changed by setting option *--constantburn* which selects burn mode *M3*. Mode *M4* is not suitable for engravings because it automatically compensates (laser)power for speed. This conflicts with the specific gcode settings given by *image2gcode* (called by *svg2gcode*) for each pixel. In fact some experiments show that *M4* causes loss of quality and image deterioration when speed is increased. On white oak images had too much black and grey which did not go away for substantially higher speed. When switched back to constant burn (*M3*) mode, the same high speed gave excellent images having a sepia (licht yellow brown) color tone.
+
 ### Notes:
  - drawing objects - within the composer - must be converted to a```path```to be translated to a gcode sequence
  - also, image objects should **not** be converted to a ```path```

{svg2gcode-3.2.5 → svg2gcode-3.2.6}/README.md

@@ -113,7 +113,7 @@ options:
   --overscan <default:0>
                         overscan image lines to avoid incorrect power levels for pixels at left and right borders, number in pixels, default off
   --showoverscan        show overscan pixels (note that this is visible and part of the gcode emitted!)
-  --constantburn        use constant burn mode M3 (a bit more dangerous!), instead of dynamic burn mode M4
+  --constantburn        set constant burn mode M3 (default set to dynamic burn mode M4); this enhances engraving quality
   --origin delta-x delta-y
                         translate origin by vector (delta-x,delta-y) in mm (default not set, option --selfcenter cannot be used at the same time)
   --scale factor-x factor-y
@@ -276,6 +276,10 @@ One containing the drawings of the .svg, the other containing the images:
     > logo_images.gc      # all images
 ```   
 
+### Burn mode M3/M4:
+
+Default *svg2gcode* uses dynamic burn mode *M4*. This can be changed by setting option *--constantburn* which selects burn mode *M3*. Mode *M4* is not suitable for engravings because it automatically compensates (laser)power for speed. This conflicts with the specific gcode settings given by *image2gcode* (called by *svg2gcode*) for each pixel. In fact some experiments show that *M4* causes loss of quality and image deterioration when speed is increased. On white oak images had too much black and grey which did not go away for substantially higher speed. When switched back to constant burn (*M3*) mode, the same high speed gave excellent images having a sepia (licht yellow brown) color tone.
+
 ### Notes:
  - drawing objects - within the composer - must be converted to a```path```to be translated to a gcode sequence
  - also, image objects should **not** be converted to a ```path```

{svg2gcode-3.2.5 → svg2gcode-3.2.6}/svg2gcode/__init__.py

@@ -1,4 +1,4 @@
 """
 svg2gcode: convert an SVG (Scalable Vector Graphic) image to gcode.
 """
-__version__ = "3.2.5"
+__version__ = "3.2.6"

{svg2gcode-3.2.5 → svg2gcode-3.2.6}/svg2gcode/__main__.py

@@ -127,7 +127,7 @@ def main() -> int:
     parser.add_argument('--overscan', default=cfg["overscan_default"], metavar="<default:" +str(cfg["overscan_default"])+ ">",
         type=int, help="overscan image lines to avoid incorrect power levels for pixels at left and right borders, number in pixels, default off")
     parser.add_argument('--showoverscan', action='store_true', default=False, help='show overscan pixels (note that this is visible and part of the gcode emitted!)' )
-    parser.add_argument('--constantburn', action='store_true', default=False, help='use constant burn mode M3 (a bit more dangerous!), instead of dynamic burn mode M4')
+    parser.add_argument('--constantburn', action='store_true', default=False, help='set constant burn mode M3 (default is dynamic burn mode M4); this enhances engraving quality')
     parser.add_argument('--origin', default=None, nargs=2, metavar=('delta-x', 'delta-y'),
         type=float, help="translate origin by vector (delta-x,delta-y) in mm (default not set, option --selfcenter cannot be used at the same time)")
     parser.add_argument('--scale', default=None, nargs=2, metavar=('factor-x', 'factor-y'),