Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
This manual needs work, please contribute if you can. ("Edit" button on the top right of this page)
If you find that VisiCut does not do what it should, please create an Issue instead of documenting the workaround here, as this will only cause confusion and will quickly be outdated.
Directly in VisiCut
Visicut supports the following filetypes: svg, dxf, eps, ls (laserscript), ...
Please note that some files, especially svg, should better be opened from the Inkscape extension.
Inkscape and Illustrator extensions
Especially when using inkscape, it is recommended to use the VisiCut extension instead of opening the svg file directly from VisiCut. The extension does some cleanup, converts text to path etc.
In VisiCut, select Extras -> Install Inkscape extension... to install the extension to Inkscape. Then you can restart Inkscape, open a file, Extensions -> Lasercut -> Open with VisiCut.
After it you can find the VisiCut-extension in Inkscape in
Extensions > Lasercut-Path > Add to/ Open in VisiCut If you have selected one or more objects, only these will be sent to VisiCut.
TODO document the illustrator extension
For each combination of material and thickness, different laser settings (speed and power) are stored for each laserprofile (cut, engrave, etc.).
The mapping determines which objects are cut, marked, engraved or ignored.
It is easiest to map by color, e.g. cut red objects, ignore blue ones and engrave the rest.
The operations like cut, engrave, etc. are not fixed. You can edit them and create custom ones. For example if you cut with too low power, you just mark the material.
The default laserprofiles are:
Cut: Cutting through the materials. Vectors are sorted by a chosen sorting strategy.
Mark: Leaving markings on materials by cutting with less power or more speed.
Engrave: Take a bitmap and "dither" it to black or white pixels (using different algorithms with different results: Dithering algorithms)
Then make a raster job where every black pixel is "laser-on" and every white pixel is "laser-off"
Resolution: Resolution of conversion. Lower resolution makes bigger pixels and less vertical lines. Less vertical lines means you might see the actual lines and you cut less deep. See following image, top gradient was 500dpi, bottom 200dpi. Using resolution of 100dpi, 200 dpi and 300 dpi (Floyd-Steinberg dithering lagorithm): Engrave 3d: Take a bitmap and convert it to GREYSCALE. Make a raster-job where every pixel is black=laser 100%, white laser=0% and all in between linearly interpolated.
The LAOS firmware does not support engrave 3d by default (yet), there is only some old code, converting the raster to a vector job it also doesn't overshoot, making it cut deeper at the edges. I do not know if it works properly, because this mode is rarely used. The Epilog cutters however fully support engrave3d.
You can adjust the settings of every laserprofile. Below are the properties. You can add multiple treatments to one profile, which is useful for cutting very thick material in two steps.
Some settings are only available on certain lasercutters.
Power: Which percentage of max power should be used.
Speed: Which percentage of max speed should be used.
Focus: Focus of the laserbeam. Focus is counted from the top of the material, higher numbers mean greater distance between focus lens and object. Focus -1 means that the focus is inside the material, 1mm below the surface. Frequency: Use low values (500) for flamable materials (wood), higher values (5000) for acrylic. Ventilation: TODO, Whether the Lasercutter should ventilate. Purge: TODO
Positioning, resizing and rotating
Use the Preview Window to graphically move, rotate and resize your job. It should be pretty self-explanatory (such as in Inkscape or Corel Draw): Click on the laser job (drawing) to select it, click again to toggle between move and rotate. Drag to move/rotate, or click on any measurement to edit it.
The same is possible with the Position tab.
X/Y is the distance between the machine origin point (top left corner of the machine bed, if not configured differently) and the reference point your drawing.
The "reference point" control allows to choose which point of your drawing is used for the X/Y settings, e.g., if you want to place the drawing's center at a specific point and not the drawing's top-left edge. (This is not the "startpoint" -- also called "Origin" in other lasercutting software. See below for that).
Setting the start point (Origin)
The recommended usage of VisiCut is to have your lasercutter referenced to the machine bed, so that the VisiCut preview panel corresponds to your machine bed. This is strictly required if you use a camera image.
However, certain lasers also support setting a different origin, usually by manually moving the machine to a certain point and setting it as the new origin (Epilog Zing: Press X/Y Off, move to desired origin, press GO). If nothing is changed in VisiCut, this origin point will then correspond to the zero point of your preview window (typically top-left, see the ruler labels). To set another point in the drawing as zero point, do the following:
- Make sure your drawing is not selected in the preview panel (click somewhere beside your drawing, such as in the area below).
- Right-click and choose "set startpoint"
Using a camera
With VisiCam you can see your lasercutter bed as an image inside VisiCut and use it for positioning your objects. If setup correctly, the precision is within some millimeters.
VisiCut fetches the image via network from a HTTP server (VisiCam). The server address can be configured in the lasercutter settings, where you can also find a button for auto-detection. The VisiCam server runs on a normal Linux computer and fetches the image from a USB webcam. You can also use the Raspberry Pi 2 with its camera module.
Importing and exporting settings
The settings are stored in a
.visicut folder in your home directory (
~/.visicut for Linux/Mac,
%USERPROFILE%\.visicut for Windows).
These properties are often specific to the device type that you use.
IP and Port: If you get Timeout or other errors, please make sure you can ping your lasercutter. The standard port should be correct, you can test it a port scanner like nmap. For Epilog laser devices, USB is not supported, and due to firmware limitations you have to unplug the machine's USB port and switch it off and on again before the Ethernet port will work.
Additional space per Raster line: How much the laserhead overshoots the drawing so it can accelerate and deaccelerate. This makes sure the laser doesn't engrave deeper towards the edges because of speed differences.
Debug output file: If you fill in a filename here VisiCut will create a text file with the code that's send to the lasercutter. This file is placed next to the Visicut.jar file. In the case of OS X you'll find in by right clicking on the application and selecting Show Package contents. Then you'l find it in Contents/Resources/Java.
Usage with a Mac
- You need to have administrative privileges on the computer you're working on to set this up (but shouldn't need them after the initial set-up.)
- Use the Platform independent ZIP.
- Unzip and move folder to Applications folder.
- Open folder and ctrl-click the .MacOS file.
- Choose Get Info and U=use the Open With drop down to select Other.
- Switch to All Applications and choose Terminal from the Utilities folder.
- Close the Get Info window.
- Double-click Visicut.MacOS to open VisiCut. The first time, you will get a warning about it being unsigned. Go to System Preferences and then to Security. There will be a note there about VisiCut. Tell the computer (twice) that it’s ok to run this and then close System Preferences.
- Assuming you're using a Mac laptop and thus have no ethernet port, get a USB to ethernet adapter and plug it into one of your USB ports.
- Open System Preferences and select Network.
- Select AppleU...Adapter.
- Set ConfigureIPv4:to Manually.
- Set IP Address: to almost the same as your laser cutter but make it one or two off in the last set in the dotted quad (so if your laser cutter has the default 192.168.3.4, you could use 192.168.3.3) Your computer must have a dif- ferent address from the laser cutter but the two need to be in the same part of the network.
- Set Subnet Mask:to 255.255.0.0.
- Click Apply.