Quickstart

VectorEZ helps you quickly convert a bitmap image to a vector format.

The example below will guide you through the process of loading an image, selecting a color in that image, extracting the contours around the specified color, tuning the result, and finally saving it in a vector graphics format (SVG).

1. Load a bitmap image

Use the menu File → Open image... to open a bitmap file. The supported image formats are: BMP, PNG and TGA. In this example we open a scanned image, bird.png.

2. Select the segmentation color

Use the pipette tool in the "Source image" panel to select the color that will be used to extract the contour.

3. Tune the vectorization

In the "Vectorization" panel, use the "Precision" slider to tune the result to your convenience. Moving the slider to left will lessen the precision, meaning the curve will fit more loosely to the input image, the contour will be less detailed and the resulting file will be smaller. On the contrary, moving the slider to the right will result in a more detailed curve that fits more closely to the input. The output file will be larger.

4. Save the result

Save the result as a SVG file once you are satisfied with the vectorization output. In our example we saved the file bird.svg.

Controls and key bindings

Interface

Interface

The View panel

The view panel gives control on what is displayed in the viewport. It does not affect the vectorization process.

1. Set the viewport's background color with a color editor or a pipette tool.
2. Split view (shortcut: S): Show the source image on the lefthand side of the viewport and the vectorization on the righthand side.
3. Flip view (shortcut: F): Flip between the source image and the vectorization.
4. Zoom to fit: Reset the zoom on the image to fit the viewport.
5. Zoom in/out. Also with the mouse wheel (Windows) or the touchpad (macOS), as well as shortcut keys.

The background color does not affect the vectorization, it can however be saved as the background color of the vector image file, depending on its format.

The Source Image panel

The source image panel controls what pre-processing is applied to the source image, and which color is used to extract the silhouettes to be vectorized.

1. Hide/show the source image.
2. Set the segmentation color with a color editor or a pipette tool.
3. Set the tolerance on the segmentation color.
4. Pre-process the source image to a grayscale image.

The segmentation color is the color used the define the silhouette shapes that must be vectorized. In the output file, it is also used as the fill color of the vector paths.

While the mouse hovers on the tolerance slider [3], the silhouette is highlighted in the source image

The Vectorization panel

Finally, the vectorization panel controls the transformation process of the selected silhouette to the vector paths.

1. Hide/show the vectorization.
2. Sharp corners: When selected, allow sharp angles at anchor nodes. When not selected (the default), all nodes are smooth.
3. Hide/show the anchor nodes. Those are the extremities of the Bezier curves that form the contour paths.
4. Hide/show the information overlay. Located at the bottom left hand corner of the viewport, that overlay provides quantitative information regarding the vectorization: The number of countour groups, the number of contours and the number of nodes.
5. The precision slider decides how closely the vector contours will fit to the silhouettes extracted around around the segmentation color. The higher the precision, the more accurate the fit, and the higher the number of nodes.