Skip to content

Quadami v0.2.1

Latest

Choose a tag to compare

@github-actions github-actions released this 12 Nov 12:13
· 220 commits to master since this release
09b2e20

Quadami 0.2.1: automatic quad remeshing for Blender 4.2 or newer, as an extension zip with
the remesher program inside. Free software under the GNU GPL, version 3 or later.

What changed

A fix release on top of 0.2.0, with one new button and a stricter fold count. Like 0.2.0 it is a release with known limits,
not a stable one. On all 770 runs of our standard test sets the result is the same as with 0.2.0,
quad for quad; only models of the kind in the first point below can come out differently. Compared with 0.2.0:

  • Models with very many tiny thin pieces no longer run for many minutes. On a wrought-iron gate
    or a lace-like model, the fallback quad extraction could trace tens of thousands of quads for a
    piece meant to get about a hundred, which took many minutes or ran out of memory. Such a piece is
    now left out instead (it shows as a piece with no quads), and a later attempt at a higher count
    usually fills it. Our iron-gate test model now finishes in 9-20 seconds at 3,300 and 4,000 quads
    (12 of 12 runs).
  • Copy Report (bottom of the result box): puts one block of text on the clipboard for a bug
    report: the build line, Blender and system versions, the run's settings, the input's size, every
    row and warning of the result box, the time of each step, the remesher's last output and the full
    report. It holds no mesh data, and your user name is removed from folder paths. It also works after
    a failed run. Paste it into the bug report form or an e-mail (user guide §6).
  • Folded faces now also counts twisted quads: quads whose two halves face apart along either
    diagonal, which the old corner test missed. The row reads N (T twisted). Quads bent along a
    sharp edge of your model (90° or more) are not counted. The mesh is the same as before; only the
    number is higher on some models (on our test sets, about 1.4 instead of 1.1 per 1,000 quads).
  • Imports marked Sharp all over no longer leave zigzag lines on the result. 0.2.0 already left
    such marks out of Follow Marks, but Keep from Original still copied them, so an FBX or OBJ
    import that marks most edges Sharp got zigzag sharp paths all over the result. A mark on more than
    half of the edges of a mesh with over 1,000 edges is now not copied either.

Warnings in the panel

  • Folded faces includes twisted quads and shows how many of them there are (N (T twisted)), so
    it can be higher than 0.2.0 showed for the same result.

  • A mark on more than half of the edges is left out: the warning now also says that the mark is
    not copied onto the result.

The other warnings are as in 0.2.0 (user guide §6).

Known limits

As in 0.2.0 (thin parts, folded
sculpt input, holes, hard-surface edges, the cleanup, Follow Marks, copied data, modifiers baked in,
Keep Ridges), except for the long runs on very many tiny thin pieces, fixed above. In their place:

  • Very many tiny thin pieces (a wrought-iron gate, wire ornaments, lace) can come out with some
    pieces missing (red Missing parts). Raise Target Quads or delete the smallest pieces. If a run
    still takes long, press Esc to cancel; Blender stays usable.
  • Copy Report keeps the remesher's output only for the last run since Blender started. Read the
    text before you send it: folder paths outside your home folder are kept as they are.
  • Against 0.2.0 on our test sets (release check, corpus and closed sets, 6 runs per case on each
    platform, run 41224250346 on 2b858a3): passed on Linux, Windows and macOS. No structural check
    fails on more cases than with 0.2.0, and no validity number is worse. Changes merged after that
    commit leave the output mesh byte-identical on 770 Linux runs of our test sets, so the check was not
    repeated.
  • Tried by hand on Linux (Ubuntu 24.04, Blender 4.5, test builds of this release's code): Blender's cube at 2,000 quads with Copy Report (no user name in the
    text), a sword joined from several parts with Sharp on most edges at 3,000 quads (marks left out
    and not copied, no zigzag sharp lines), and Copy Report after a run cancelled with Esc. No crash,
    hang or cut-off text. After a cancelled run, Copy Report shows "0 islands" for the input (not counted
    yet), not the real number. Checked again on the final build: the sword at 10,000
    quads shows Folded faces 39 (24 twisted), matching the report.
  • Tried by hand on Windows (a real Windows desktop, this release's CI build; build line correct,
    Defender silent, 0 detections on VirusTotal for the download zip): Blender's monkey at 5,000 quads,
    Fast 5,005 quads (1 folded, 0.7 s) and Quality 5,093 quads (0 folded, 1.8 s); a head at 10,000
    quads, 9,854 quads (4 folded, 3 twisted); the cube at 3,000 quads, 2,948 quads (1 folded,
    1 twisted); the sword at 3,000 quads, 2,861 quads (44 folded, 24 twisted). Every result all quads,
    no holes or non-manifold edges. The 300,000-quad warning appears and cancels, Esc cancels a run,
    Ctrl+Z undoes it, and no files are left in %TEMP%. It also passes the automatic tests (the remesher's tests, an
    install into a real Blender 5.2 that remeshes and the panel check). The program is not code-signed
    (see Download).
  • macOS is experimental and untested: nobody has run this release on a real Mac, and the program
    is not notarized, so macOS may block it (user guide §2). Reports from Mac users are welcome.
  • Version numbers name releases only. Test builds between releases keep this version; tell them
    apart by the build line.

Download

Pick the zip for your system. Do not unpack it: Blender installs the zip itself
(Edit > Preferences > Get Extensions, the ⌄ menu top right, Install from Disk..., then
restart Blender). The user guide
explains every setting and warning.

System File SHA-256
linux-x64 quadami-0.2.1-linux-x64.zip 2f094d973c1c6bada7155c2b7ffbe77219dfdeaabbadd4ffb3a0e30ccd2b48af
windows-x64 quadami-0.2.1-windows-x64.zip 336469c0b5bf66e5f7b9cf714fbaeb01879b3119726b9d29cd98f1d20bee535c
macos-arm64 quadami-0.2.1-macos-arm64.zip 757b2ff4c99e40cb70029b44edc5ddf10d6434cf04cf37c0a10051a0d6214501
  • Linux x64: any distribution with glibc 2.28 or newer (the floor of Blender 4.2 itself; e.g.
    Ubuntu 20.04+, Debian 10+, Fedora 29+, RHEL/Rocky/Alma 8+). Built on AlmaLinux 8, checked to need
    nothing newer.
  • Windows x64: Windows 10 or 11. The remesher is not code-signed. Blender unpacks it itself, so
    Windows SmartScreen should not ask; if your antivirus quarantines autoremesher-cli.exe, restore it
    or build from source.
  • macOS, Apple silicon (M1 or newer), macOS 11.2+: experimental, untested. It passes the
    automatic tests in Blender without a window, but nobody has tried it on a real Mac yet, and the
    remesher is not signed or notarized by Apple. Installed through Blender it should run; if macOS
    says it "cannot be opened because the developer cannot be verified", see the user guide, §2
    (macOS). Intel Macs: build from source.

Check a download with sha256sum -c SHA256SUMS.txt (Linux), shasum -a 256 -c SHA256SUMS.txt
(macOS) or Get-FileHash <zip> (Windows PowerShell), against the table above. To check that a zip
was built by this project's GitHub Actions from the commit below (with the
GitHub CLI): gh attestation verify <zip> -R KajetanMuczynski/quadami.

Build line. The bottom of the Quadami panel shows Add-on build v0.2.1 09b2e20 2026-11-12. Put that line in
every bug report.

Source and licenses

Built by GitHub Actions from commit 09b2e20d53fb86e51ee24624bd13a87729ec2885 (tag v0.2.1):
source,
changes since v0.2.0.
Each zip holds licenses/: the GPL (Quadami and libQEx), upstream AutoRemesher's MIT notice
(Jeremy Hu), and the licenses of OpenMesh, oneTBB, Eigen, meshoptimizer, isotropicremesher and
tinyobjloader compiled into the remesher, plus SOURCE.txt naming the source commit.