95ce581af2 | ||
---|---|---|
.github | ||
images | ||
src | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
Directory.Build.props | ||
LICENSE | ||
NuGet.Config | ||
README.md | ||
Trace.sln | ||
global.json |
README.md
Trace
Trace is an application for transforming bitmaps into vector graphics using BitmapToVector library.
- BitmapToVector C# port of Potrace with optional SkiaSharp support.
- Potrace Transforming bitmaps into vector graphics.
- mkbitmap Transform images into bitmaps with scaling and filtering.
- A detailed technical description of how the Potrace algorithm works.
- Technical documentation of the Potrace library API (for developers).
- Avalonia - A cross platform XAML framework for .NET
Usage
Turdsize
The turdsize parameter can be used to 'despeckle' the bitmap to be traced, by removing all curves whose enclosed area is below the given threshold. The current default for the turdsize parameter is 2. Its useful range is from 0 to infinity.
Turnpolicy
The turnpolicy parameter determines how to resolve ambiguities during decomposition of bitmaps into paths.
The possible choices for the turnpolicy parameter are:
- Black: prefers to connect black (foreground) components.
- White: prefers to connect white (background) components
- Left: always take a left turn.
- Right: always take a right turn.
- Minority: prefers to connect the color (black or white) that occurs least frequently in a local neighborhood of the current position.
- Majority: prefers to connect the color (black or white) that occurs most frequently in a local neighborhood of the current position.
- Random: choose pseudo-randomly.
The current default policy is Minority
, which tends to keep visual lines connected.
Alphamax
The alphamax parameter is a threshold for the detection of corners. It controls the smoothness of the traced curve. The current default is 1.0. The useful range of this parameter is from 0.0 (polygon) to 1.3334 (no corners).
Opticurve and opttolerance
The opticurve parameter is a boolean flag that controls whether Potrace will attempt to simplify
the final curve by reducing the number of Bezier curve segments.
Opticurve=1 turns on optimization, and opticurve=0 turns it off. The current default is on.
The opttolerance parameter defines the amount of error allowed in this simplification. The current default is 0.2. Larger values tend to decrease the number of segments, at the expense of less accuracy. The useful range is from 0 to infinity, although in practice one would hardly choose values greater than 1 or so. For most purposes, the default value is a good tradeoff between space and accuracy.
Fill color
The fill color used for generated output path's. The default is hex value #000000
. It also accepts named colors like Red
, Black
etc.
Color filter
Color filter is an C# expression used to filter input bitmap colors. It has access to Rgba32 pixel sctruct represantion.
The default filter is c.R < 128 && c.A > 0
where c
is variable of type Rgba32
.
Available c
variable properties:
c.R
Redc.G
Greenc.B
Bluec.A
Alpha
Building
Download and install .NET 5.0 SDK.
Build
dotnet build ./src/TraceGui/TraceGui.csproj -c Release
Run
dotnet run --project ./src/TraceGui/TraceGui.csproj -c Release
Licensing
Trace is licensed under the GPL-3.0 License.