File size: 10,592 Bytes
8b468fc 8010824 8b468fc 8010824 8b468fc | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 | <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="inkvec-guide" content="studio">
<title>Result: reading the quality report · Inkvec Studio guide</title>
<link rel="stylesheet" href="guide.css">
</head>
<body>
<div class="shell">
<aside class="side"><a class="guidebrand" href="index.html"><img src="logo-mono.svg" alt=""> <span>Inkvec Studio</span></a><div class="grp"><h4>User guide</h4><a href="index.html">Overview</a><a href="install.html">Install and first launch</a><a href="getting-started.html">Getting started</a><a href="viewer.html">The viewer</a><a href="result.html" aria-current="page">Result</a><a href="tune.html">Tune</a><a href="palette.html">Palette and colour groups</a><a href="export.html">Export</a><a href="minify.html">Minify SVG</a><a href="fabricate.html">Fabricate</a><a href="batch.html">Batch</a><a href="settings.html">Settings</a><a href="shortcuts.html">Keyboard and mouse</a><a href="troubleshooting.html">Troubleshooting</a></div><div class="grp"><h4>Tutorials</h4><a href="tutorials/jpeg-logo.html">Clean up a JPEG logo</a><a href="tutorials/favicon-asset-pack.html">A favicon and an asset pack</a><a href="tutorials/vinyl-htv.html">Layered vinyl and iron-on</a><a href="tutorials/laser.html">Laser: DXF and G-code</a></div><div class="grp"><h4>Online</h4><a href="https://logolabs.github.io/inkvec/">Inkvec documentation</a><a href="https://logolabs.github.io/inkvec/studio/result.html">This page on the web</a></div><p class="guidenote">This copy of the guide is part of the app and works without a network.</p></aside>
<main><article><h1 id="result-reading-the-quality-report">Result: reading the quality report</h1>
<p>The <strong>Result</strong> half of the rail is what the last trace produced. It is a measurement, not a
score: the SVG is rendered and compared with your image pixel by pixel, and the figures are what
that comparison found.</p>
<p><img alt="The Result half of the rail: the quality report, editability, and the readout at the foot" src="img/result.webp"></p>
<p>From the top, the Result tab shows:</p>
<ol>
<li>The <strong>Denoiser</strong> and <strong>Editable</strong> settings (shared with Tune; see
<a href="tune.html#the-engine-the-denoiser-and-editable">Tune</a>).</li>
<li><strong>Auto chose</strong>, while it has something to offer (see
<a href="getting-started.html#the-choice-card-keep-auto-or-customise">Getting started</a>).</li>
<li>The <strong>quality report</strong>.</li>
<li><strong>Editability</strong>.</li>
<li><strong>What this trace could not recover</strong>.</li>
<li>The <strong>palette</strong> (<a href="palette.html">its own page</a>).</li>
<li>One line comparing Inkvec with another tracer on the project's published benchmark. It is
labelled as such: it is not a measurement of your file.</li>
</ol>
<p>While a trace runs, a list of the engine's stages appears at the top, each ticked with the time it
took as it finishes.</p>
<h2 id="the-quality-report">The quality report</h2>
<p>The large number is the <strong>mean colour difference</strong> between the SVG and the image, in <strong>dE00</strong>
(CIEDE2000), the standard measure of how different two colours look to a person. It is averaged
over every pixel, so most of it comes from anti-aliased edges.</p>
<table>
<thead>
<tr>
<th>dE00</th>
<th>What it means</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>Identical.</td>
</tr>
<tr>
<td>about 0.1</td>
<td>Typical for a clean PNG logo.</td>
</tr>
<tr>
<td>under 1.0</td>
<td>Not visible side by side.</td>
</tr>
<tr>
<td>about 1.0</td>
<td>Where a trained eye starts to see a difference.</td>
</tr>
<tr>
<td>well above 1</td>
<td>Visible: a colour is off, or a detail is missing.</td>
</tr>
</tbody>
</table>
<p>The meter under it runs from 0 to 5 on a square-root scale, with a tick at 1.0, <em>just visible</em>.
Beside the mean is the <strong>median</strong>, the difference at the typical pixel. A median much lower than
the mean says the error is concentrated somewhere (often one small detail) rather than spread
evenly.</p>
<p>The header says what was measured: <strong>full trace</strong> or <strong>draft</strong>, and the size it was traced at.
The card fades while a new trace is running.</p>
<p>The figures below the meter:</p>
<table>
<thead>
<tr>
<th>Figure</th>
<th>What it counts</th>
</tr>
</thead>
<tbody>
<tr>
<td>coordinates</td>
<td>Numbers in the drawing's geometry. The best single measure of how heavy the file is to edit and to ship.</td>
</tr>
<tr>
<td>paths</td>
<td>Drawn elements: paths, circles, rectangles.</td>
</tr>
<tr>
<td>colours found</td>
<td>Distinct inks in the drawing.</td>
</tr>
<tr>
<td>segments</td>
<td>Lines, curves and arcs, across all paths.</td>
</tr>
<tr>
<td>file size</td>
<td>The SVG as written.</td>
</tr>
<tr>
<td>minified</td>
<td>What <a href="tune.html#output">Minify</a> would make it, or <em>already</em> if it is on.</td>
</tr>
<tr>
<td>traced at</td>
<td>The size the image was traced at, on its longer side.</td>
</tr>
<tr>
<td>time taken</td>
<td>How long the trace took.</td>
</tr>
</tbody>
</table>
<p><strong>Find the worst corner</strong> zooms the viewer to 12× on the place where the SVG and the image
disagree most, with the <a href="viewer.html#detail-the-pixel-grid-under-the-edge">pixel grid</a> on, and says
how large that disagreement is.</p>
<h2 id="the-readout-at-the-foot">The readout at the foot</h2>
<p>Pinned under both halves of the rail are the three numbers that matter most, <strong>dE00</strong>,
<strong>coordinates</strong> and <strong>file</strong>, each with what it changed by since the previous full trace. Fewer
coordinates and a smaller file are shown as good news; a higher colour difference turns amber,
since that is the cost. Drafts are never compared (they are smaller, so they would show changes
nobody made); the readout compares full trace with full trace.</p>
<p>This is how to judge a control: move it, and read what it bought and what it cost here.</p>
<p>Under the readout are <strong>Export</strong>, <strong>Copy SVG</strong> and the comparison-card button (see
<a href="export.html">Export</a>), and <strong>Trace again</strong>, which runs a full trace with the controls as they are.</p>
<h2 id="editability">Editability</h2>
<p>A trace is fitted for the pixels alone, so the file it makes does not have the habits of a file
an artist drew by hand. This card counts three of those habits on your drawing:</p>
<table>
<thead>
<tr>
<th>Row</th>
<th>What it counts</th>
<th>Hand-drawn files</th>
</tr>
</thead>
<tbody>
<tr>
<td>Handles on an axis</td>
<td>Curve handles pointing exactly along x or y</td>
<td>34%</td>
</tr>
<tr>
<td>Smooth joins</td>
<td>Places two curves meet without a kink</td>
<td>89%</td>
</tr>
<tr>
<td>Nodes sharing a coordinate</td>
<td>Nodes with the same x or y as another node, so they can be aligned in one move</td>
<td>86%</td>
</tr>
</tbody>
</table>
<p>Each bar shows your drawing's share, with the count, and a tick where hand-drawn files sit: the
median of 1,544 SVGs drawn by artists, measured the same way. A plain trace starts near zero on
the first two. <strong>Make it editable</strong> turns on <a href="tune.html#the-engine-the-denoiser-and-editable">Editable structure</a>,
which moves the bars towards the ticks. It costs a little colour accuracy (about 0.04 dE00 on
icons); the quality report shows the price on your image.</p>
<p>A drawing made only of lines and arcs has no curve handles and no curve joins, so only the last row
is shown, with a note saying why.</p>
<h2 id="what-this-trace-could-not-recover">What this trace could not recover</h2>
<p>This panel is always there. When it finds nothing it says <em>Nothing we can detect was lost</em>. When it
finds something, each row says what, with <strong>Why</strong> for the measurement behind it and, sometimes, one
link.</p>
<table>
<thead>
<tr>
<th>Row</th>
<th>What it means</th>
<th>What you can do</th>
</tr>
</thead>
<tbody>
<tr>
<td>The lettering came back as outlines, not editable text.</td>
<td>Six or more shapes of matching height sit on one baseline. Tracing recovers their shapes, not the typeface, so the words cannot be re-typed.</td>
<td>Set the text again in a vector editor if you need it live.</td>
</tr>
<tr>
<td>The source is a JPEG (or WebP), so these colours carry its compression damage.</td>
<td>The colours measured are the ones in the file, which are not quite the ones the artwork was drawn with.</td>
<td>Turn on the <a href="settings.html#denoiser">denoiser</a>, and check the colours against your brand values (<a href="palette.html#paste-a-brand-palette">paste a brand palette</a>).</td>
</tr>
<tr>
<td>Stroke widths are baked into filled outlines.</td>
<td>Several shapes are outlines drawn around lines rather than the lines themselves; an editor sees closed shapes, not strokes.</td>
<td>Try the <em>Line art</em> preset.</td>
</tr>
<tr>
<td>Line art was asked for, and the stroke widths vary too much to recover.</td>
<td>Strokes need one width per path; this drawing's widths change along the line.</td>
<td>Nothing: this drawing is not uniform-stroke line art.</td>
</tr>
<tr>
<td>Part of this image is a continuous ramp, which is something SVG cannot hold.</td>
<td>Part of the image is a smooth shade (a blur, a mesh, a photographic shadow) that no SVG gradient reproduces within a visible difference.</td>
<td>Nothing in the settings; it is the closest arrangement of fills.</td>
</tr>
<tr>
<td><em>N</em> very small features did not survive the trace at this size.</td>
<td>Small islands of detail were painted over.</td>
<td>Raise <strong>Trace size</strong>, or lower <strong>Speckle floor</strong> (see <a href="tune.html#detail">Tune</a>).</td>
</tr>
</tbody>
</table>
<p>The first row in this panel is also copied into the asset pack's README when you export one.</p><nav class="pagenav"><a class="prev" href="viewer.html"><span class="dir">Previous</span><span class="lbl">The viewer</span></a><a class="next" href="tune.html"><span class="dir">Next</span><span class="lbl">Tune</span></a></nav></article></main>
<aside class="rail"><h5>On this page</h5><ul><ul><li class="l2"><a href="#the-quality-report">The quality report</a></li><li class="l2"><a href="#the-readout-at-the-foot">The readout at the foot</a></li><li class="l2"><a href="#editability">Editability</a></li><li class="l2"><a href="#what-this-trace-could-not-recover">What this trace could not recover</a></li></ul></ul></aside>
</div>
</body>
</html>
|