Files
kisscut/README.md
2025-05-21 06:05:38 +02:00

1.9 KiB

kisscut

Author: Victor Giers

⚠️ This README.md has been automatically generated using AI and might contain hallucinations or inaccuracies. Please proceed with caution!

KissCut Vectorization Tool

Description

KissCut is a simple tool to convert bitmap images into vectorized outlines suitable for laser cutting and other purposes. It processes images to extract contours, smooth them, and export as SVG files.

Features

  • Convert image masks to vector outlines.
  • Adjustable parameters for contour detection and smoothing.
  • Export vector graphics in SVG format.
  • Drag-and-drop functionality for easy file loading.
  • User-friendly GUI with sliders for fine-tuning settings.

Requirements

  • Python 3.6 or higher
  • Required libraries: numpy, Pillow, scikit-image, PyQt5

Install the required libraries using pip:

pip install numpy pillow scikit-image PyQt5

Usage

  1. Load an Image: Drag and drop an image file into the preview window or use the "Update Preview" button to load.
  2. Adjust Parameters:
    • DPI (Dots Per Inch): Resolution of the input image.
    • Inflation (inch): Additional margin around the detected contour.
    • Alpha Threshold: Threshold for binarizing the image.
    • RDP Epsilon (mm): Precision of the RDP algorithm for simplifying contours.
    • Spline Smoothing: Amount of smoothing applied to the contour.
    • Spline Points: Number of points used in the spline approximation.
    • Corner Angle (deg): Threshold angle for detecting corners.
  3. Update Preview: Click "Update Preview" to apply changes and see the result.
  4. Export Vector: Click "Export Vector" to save the vectorized outline as an SVG file.

License

This project is licensed under the CC0-1.0 Public Domain Dedication, which means you can copy, modify, distribute and use the work, even commercially, without needing to give any attribution.