Skip to content
ricperryPublic

About

GTK4 vector halftone generator

Resources

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Toniator icon

Toniator

Turn images into artwork made from dots, flowing curves, scattered shapes, cells, and mazes.

Open an image, explore a Pattern, and make it your own. Toniator is a native desktop app with independent color channels, a visual Pattern Wizard, and PNG or editable SVG output. It is free software under GPL-3.0-only.

Toniator 0.4.5 editing a portrait made from source-colored Poisson-disk marks

The actual Toniator 0.4.5 editor. Source for the artwork above:

Original continuous-tone painted portrait used in the editor

The portrait source was created with AI for these demonstrations. Every pattern effect below is rendered by Toniator; screenshots are captured from the real app. Click any image to inspect its full size.

Get the app

Download the 0.4.7 Linux prerelease from GitHub Releases. Choose an AppImage or Flatpak:

# AppImage
chmod +x Toniator-0.4.7-x86_64.AppImage
./Toniator-0.4.7-x86_64.AppImage

# Or Flatpak
flatpak install --user ./Toniator-0.4.7-x86_64.flatpak
flatpak run io.github.ricperry.Toniator

Installation, upgrades, and Windows · Build from source · Release notes

Version 0.4.7 adds optional Fast preview, a clearer native interface and keyboard help, and bounded CPU responsiveness improvements. Each window starts in Accurate CPU mode; Fast is approximate and falls back to CPU when needed. Exports retain their existing CPU rendering. The project format remains schema 19, shared with 0.4.6. Older projects are current-only: the gallery and editor screenshots below retain their 0.4.5 provenance, and their older projects require that release. Open the source artwork in 0.4.7 to create a new project. See format and Preset details.

First steps

  1. Choose Start New Project in the welcome window and open an image. Try the included raster or vector artwork. In the editor, New starts an empty document; Open artwork… adds your image.
  2. Pick a Model: RGB for colored light on black, CMYK for overlapping ink colors on white, or Source color + alpha to paint shapes with the image's own colors and transparency.
  3. Click Change… in Pattern Recipe. Select a gallery card and choose Apply Pattern, or Customize to explore how it is constructed.
  4. Start with All channels. Adjust Feature size: smaller values add finer detail; larger values emphasize the pattern. Try Rotation and offsets, then select an individual channel to give it a different arrangement.
  5. Use Preview / Source to compare with the original. Zoom in to inspect details, drag to pan when zoomed beyond Fit, and choose Fit to see it all.
  6. Open Main Menu → File → Save to keep an editable .toniator project, including its source artwork. Choose Export image… for PNG or SVG.

A quick starting point: after opening your image, choose New options → Select preset… to try a complete built-in look such as Magazine CMYK, Skinny Curve, or Controlled Splatter CMYK.

Creative workflows

Explore the pattern behind the image

The gallery supplies a starting point; the Wizard exposes its construction. Choose Guides, Scatter, or Spiral curve, adjust the family options, choose what it draws, and review before applying. Back lets you experiment; Apply Pattern changes the document in one undoable step.

Choose a Pattern Shape its distribution
Real Pattern Gallery with Poisson Disk Marks selected Real Pattern Wizard showing scatter spacing, Poisson-disk distribution, and Lloyd relaxation

The Wizard studies every Pattern against the same built-in black-to-white source shown here, so its small preview is easy to compare across Patterns. Your portrait remains behind the dialog.

Black-to-white gradient source used by the Pattern Wizard and gallery studies

For scattered points, try Random, Poisson disk, Jittered cells, or Clustered. Change the variation number for another repeatable arrangement; use Point density to follow the artwork, Keep points apart for separation, and Relax points (Lloyd) to smooth the distribution. These control where points live; drawing and Advanced settings control what appears at those points.

Gallery: one source, many constructions

These are 20 full-detail PNG exports from Toniator 0.4.5, with no image editing or pixel upscaling. The files are 2048×2048, 1800×1240, or 2508×2508; the small images here link to the original exports. Each group shows its source once. Open the editable projects, settings, and reproduction guide.

Portrait studies

Source — original painted portrait, 1254×1254:

Source for all seven portrait studies: a continuous-tone woman with dark curls and foliage

Source-colored marks retain the painting's palette. RGB screens and CMYK waves turn the same image into bolder graphic textures.

Source color · Poisson marks Curve Motif · repeated custom curve Clustered Connections
Source-colored Poisson marks Portrait drawn with repeated curve motifs Portrait drawn with short clustered random connections
One Guide Lines Grid Voronoi Three-Guide Maze
Portrait drawn with straight line screens Portrait drawn as scaled Voronoi cells on a grid Portrait drawn as three-guide maze walls
CMYK custom waves
Portrait drawn with curved CMYK guide paths

Curves, spirals, and scattered points

Source — included raster artwork, 1024×1024:

Source for all seven renders below: colored gradients and transparency around a dark center

Round Spiral Line Round Spiral Marks Square Spiral
Raster source drawn as a continuous round spiral Raster source drawn as marks along a round spiral Raster source drawn as a continuous square spiral
Poisson Disk Marks Source-Weighted Voronoi Two-Guide Maze
Raster source drawn with an irregular evenly spaced dot arrangement Raster source drawn with artwork-weighted irregular Voronoi cells Raster source drawn as two-guide maze walls
Fine CMYK waves
Raster source drawn with a fine curved CMYK line screen

Vector artwork becomes new geometry

Source — included SVG artwork, 900×620:

Source for all six renders below: a shaded blue sphere, a dark T panel, and a translucent white wave over a color gradient

Custom curved guides Magazine CMYK dots Triagrid Diamond Marks
Vector source rendered with curved RGB guides Vector source rendered with fine CMYK dot screens Vector source rendered with diamond shapes on a triangular grid
Three-Guide Cells Two-Guide Cells Triagrid Spanning Tree
Vector source rendered as triangular guide-face regions Vector source rendered as inset two-guide cells Vector source rendered as branching spanning-tree connections

Mix Patterns by channel

Each channel can have its own construction and transform. This example reuses the SVG source displayed above, combining straight lines, scattered circles, and diamonds. Select a named channel before changing its Pattern or offsets.

Mixed RGB artwork · 1800×1240 G channel selected in the real editor
Vector artwork with different Patterns and transforms on R, G, and B Green channel inspector showing its Random-family Pattern and independent transform
Channel Pattern Feature size Rotation X / Y offset
R One Guide Lines 1.5 15° +12 / −8
G Poisson Disk Marks 0.95 −10° −16 / +10
B Triagrid Diamond Marks 1.25 30° +8 / +18

Open this editable project or see the exact channel settings.

Keep experimenting

Change one channel at a time. Select R/G/B or C/M/Y/K to vary its Pattern, rotation, spacing, paint, or response. Return to All for shared edits. Advanced Settings… separates Fill response (how much is drawn) from Source weighting (where artwork-dependent points gather).

Save the right thing. A .toniator project holds artwork and editable state. A personal Pattern saves a reusable construction from the Wizard. A Document Preset saves the whole channel/design configuration without source artwork: use New options → Save preset, then Load preset… on another image. Loading a Document Preset keeps your current artwork and canvas.

Compare before exporting. The Source view shows the original in the same canvas framing; it does not alter the design. Here it displays the SVG source used by the vector gallery above:

Toniator Source view showing the original vector artwork

Export your artwork

Use Main Menu → Export image…, choose PNG or SVG and a destination. For PNG, select background, antialiasing, and 1× native, 2×, 4×, 8×, or Custom size. Export resolution is independent of preview zoom. SVG preserves editable vector geometry and a transparent background.

Toniator PNG export options with a real 2x preview of the curved vector example

PNG options for the custom curved-guides result in the vector gallery; its original SVG source is displayed above.

Alpha and DTG/DTF preparation

Source color + alpha retains source transparency and leaves gaps between marks. Here the same portrait has an AI-extracted transparent cut-out as its source; Toniator creates the open Poisson-disk marks.

Transparent source · 1254×1254 Native transparent PNG · 2000×2000
Transparent cut-out source for the print examples Toniator source-colored portrait with genuine transparent space between marks and around the silhouette

For DTG/DTF preparation, enable Print preparation → Prepare for garment printing in PNG options. Set the physical size and DPI, then inspect alpha and optional small-mark, narrow-feature, and gap corrections at a useful zoom. The garment color below is preview-only; the exported PNG retains transparency.

Real PNG print-preparation dialog showing the portrait on a blue garment preview backdrop

Both close-ups below use the same 2000×2000 target, 200% zoom, and pan. These are native preview-region captures; click for the complete app screenshot.

Ordinary antialiased alpha Binary alpha + optional corrections
Native ordinary PNG preview close-up with antialiased mark edges Matched prepared PNG preview close-up with corrected narrow features and gaps

This example uses 200×200 mm at 254 DPI, then 4 px minimum feature width, 3 px isolated-mark removal, and 2 px gap fill. These are illustrative settings for this artwork; choose thresholds for your printing process. Preparation thresholds alpha at 128, then applies the enabled corrections.

Ordinary RGBA PNG · Binary alpha only · Prepared RGBA PNG · Editable project · Settings and pixel checks

Animate the artwork

Author Start and End, choose interpolation and timing, then use Export video… for a PNG sequence, lossless FFV1/Matroska, or AV1/WebM. Still artwork, videos, animated JPEG XL, and imported image sequences can supply the source. Animation walkthrough.

Change scale and rotation

Using the original portrait in Portrait studies, this three-second study moves Feature size from approximately 1.538 to 0.625 and Rotation from 0° to 60°. Toniator renders all intermediate frames with smooth-in/out interpolation.

Animated source-colored portrait changing mark scale and rotation

Native 1254×1254 video · Editable animation project · Source

Move channels independently

The mixed-channel SVG artwork above keeps its three Patterns and Feature sizes fixed. Only each channel's Rotation and X/Y offsets animate, producing independent motion through the image.

Animated vector artwork with independent R, G, and B rotations and translations

Native 900×620 video · Editable animation project · Source · Channel endpoints and reproduction

Both native exports contain 48 frames at 16 fps. The inline GIFs are 720-pixel-wide sharing derivatives: 24 sampled frames at approximately 8 fps, with palette conversion. They contain no invented intermediate frames.

Keyboard and accessibility

Use Main Menu → Help → Keyboard Shortcuts (Ctrl+?) for local help. F10 opens Main Menu, Ctrl+, toggles Settings, and F6 cycles the Canvas and Settings. Ctrl+0 fits the artwork; Ctrl++ and Ctrl+- zoom. Standard document shortcuts include Ctrl+N/O/S, Ctrl+Shift+S, Ctrl+E, Ctrl+W/Q, Ctrl+Z and Ctrl+Shift+Z/Ctrl+Y. Native text fields retain text editing and history.

Interface conventions · Accessibility support and known limits

Documentation

Detailed usage guide · Example projects and exact settings · Command-line rendering · Known issues · Package guide

Toniator is prerelease software; keep original artwork and important projects.

Development

Build from source. Developers can start with the architecture and normative Addendum. The GUI and headless CLI share the same evaluation and rendering core.

The optional Fast preview switch appears after Zoom/Fit; each window still starts in Accurate mode. Fast uses approximate GPU rendering for supported artwork and falls back to the CPU otherwise. Exports remain CPU rendered. See preview modes and measurements and limits. Fast requires a supported Vulkan adapter/driver. See the release notes for its eligibility and accuracy limits.

License and credits

Created by Richard Perry. Free software under GPL-3.0-only, without warranty. Demonstration source artwork above is identified separately.

If Toniator is useful to you, an optional Ko-fi tip supports development. Artwork and design products are available from Silent But Digital Designs.

About

GTK4 vector halftone generator

Resources

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages