Docs menu: SVG parity
Documentation homeOn this page
Shapes and paths Paint and stroke Gradients and patterns Compositing and effects Structure Text Renderers Order of workSVG parity
Which SVG features an import keeps, which are rewritten, and the order the remaining gaps close in.
This page tracks how much of SVG an imported file keeps. A feature ends up in one of three states. It is native when the MSX format and the renderers have it. It is expanded when the importer rewrites it into native features, so nothing is lost. It is a gap when the importer reports it as a warning and draws the file without it. The importer never drops a feature without saying so, with the exceptions marked "not read" below.
Progress is measured with scripts/svg-compare/. At the last full run the importer matched 53 of the 54 icons of a four set corpus (Feather, Bootstrap Icons, Simple Icons, Twemoji), the last being close, and 884 of the 960 files in the resvg shapes, painting, paint server, structure and masking tests. Of the 52 clipPath tests, 47 match, of the 40 mask tests 38, of the 56 image tests 49, of the 34 pattern tests 26 (4 more agree with rsvg-convert and not with the resvg picture), and all 21 style tests and all 21 mix-blend-mode tests. The rest of the image tests use GIF, WebP or compressed SVG. Of the 413 filters tests, 160 match, among them all 8 feDropShadow and all 9 feOffset tests, 9 of 13 feGaussianBlur, 46 of 78 filter and 29 of 44 filter-functions. Most of the rest use primitives that need new effect kinds. Nearly every file that does not match uses a feature listed as a gap here.
Shapes and paths
| SVG feature | State | Notes |
|---|---|---|
rect with rx and ry, circle, ellipse, line, polyline, polygon |
Native | All three renderers |
path with every command, relative forms and arcs |
Native | Arcs become cubic curves in the importer, S and T reflect the previous control point on every renderer |
Paint and stroke
| SVG feature | State | Notes |
|---|---|---|
fill, stroke, widths, fill-rule, opacity |
Native | fill-opacity, stroke-opacity and currentColor are folded into colors |
| Dash array and offset, caps, joins, miter limit | Native | |
visibility, display |
Native | |
paint-order |
Expanded | A stroke first order becomes two shapes |
vector-effect |
Gap | Reported |
shape-rendering |
Not read | A rendering hint |
Gradients and patterns
| SVG feature | State | Notes |
|---|---|---|
linearGradient |
Native | Units, spread and transform as written, from binary version 3 |
radialGradient |
Native | Circle, focal point, focal radius fr and cone as written, under any units and transform |
gradientUnits, gradientTransform, spreadMethod |
Native | Carried as they are from binary version 3 |
Focal point outside the circle, fr |
Gap | Clamped onto the circle, fr ignored |
| Conic gradient | Native, MSX only | CPU and GPU draw it, the SVG output cannot |
pattern on a fill |
Expanded | Tiles clipped to the shape, with units, viewBox, patternTransform, href inheritance and nesting. See Importing SVG |
pattern on a stroke |
Gap | Fallback color if given. The outline of a stroke is not available to clip tiles with |
Compositing and effects
| SVG feature | State | Notes |
|---|---|---|
Group opacity |
Expanded | An isolated layer |
mix-blend-mode |
Expanded | All sixteen CSS keywords |
isolation |
Expanded | A layer |
clip-path with url(#id) |
Expanded | A layer with a clip path. Both units, clip-rule, transform and nested clip paths work on all three renderers |
clip-path as a basic shape such as circle() |
Gap | Reported |
clip-path on a child inside a clipPath |
Gap | Reported, the child is not clipped |
mask with url(#id) |
Expanded | A layer with a mask. Both units, the region, mask-type, nested masks and any paint in the mask work on all three renderers |
mask in a reference cycle, color-interpolation: linearRGB |
Gap | Reported |
filter with feGaussianBlur, feDropShadow, feOffset, blur() and drop-shadow() |
Expanded | A layer with effects and a region clip. Units, xlink:href, chains and lists work |
filter with other primitives, a primitive region, a blur that differs per axis, in other than the previous result, color functions |
Gap | Reported, drawn without that filter. They need effect kinds the format does not have |
marker-start, marker-mid, marker-end, marker in CSS |
Expanded | Copies of the marker content at the vertices, on paths, lines, polylines, polygons, rectangles and ellipses. All marker attributes work, and the viewport clips |
Structure
| SVG feature | State | Notes |
|---|---|---|
g, defs, use, symbol, nested svg |
Expanded | Placement, viewBox and viewport clipping are kept, and overflow is honored |
viewBox, preserveAspectRatio |
Expanded | One wrapper transform |
No width, height or viewBox |
Expanded | The canvas is the extent of the content, as in resvg |
| Files that are not UTF-8 | Expanded | UTF-16 and the encodings named in Importing SVG |
transform, CSS transform, transform-origin |
Expanded | transform-box other than view-box is a gap |
switch, systemLanguage, requiredExtensions |
Expanded | The language is English |
<style> rules |
Expanded | Types, ids, classes, attribute selectors and :first-child, joined by descendant and child combinators, with summed specificity. Sibling combinators and other pseudo-classes are skipped |
image with PNG or JPEG |
Expanded | From a data URI or a file, with preserveAspectRatio, a clip for slice, opacity, transform, clip and mask |
image with SVG |
Expanded | The inner document is imported with its own ids, styles and gradients and placed like a bitmap, with preserveAspectRatio, a clip to its canvas and a clip for slice. Animation inside it is drawn as the static frame |
image with GIF, WebP or .svgz |
Gap | Reported. MSX holds PNG and JPEG, and these would need a decoder and a PNG transcode |
context-fill, context-stroke |
Partial | Colors, opacity and nesting through use and markers work. A gradient is fitted to the shape painted, not to the context element, and a pattern on a stroke is a gap |
foreignObject |
Gap | Reported |
animateTransform of translate, scale and rotate, animate of opacity, x, y, cx, cy, r on an unstroked circle and the opacity of a single paint, with begin, dur, repeats, end, fill, values, keyTimes, calcMode and keySplines |
Expanded | Baked into MSX tracks on one scene timeline, with a wrapper group or layer per animation. See Importing SVG |
set of the same attributes, set and animate of visibility and display, animateMotion with path, mpath, values, keyPoints and rotate |
Expanded | A constant track, an opacity layer that shows or hides the element, and sampled translate and rotate tracks. See Importing SVG |
animate of colors, paths, sizes and dash offsets, skewX and skewY, animateColor, animateMotion with calcMode discrete or spline, begin on an event |
Gap | Reported, the static frame is drawn. MSX tracks have only translate, scale, rotate, opacity and z-index channels |
CSS animation and @keyframes with transform (translate, scale and rotate), opacity, fill-opacity and stroke-opacity |
Expanded | Baked into tracks like the SMIL animations, with delay, iterations, direction, fill mode, cubic-bezier(), steps() and keyword easing, and transform-origin with transform-box: fill-box. See Importing SVG |
CSS animation with paused, skews, matrices, mismatched transform lists, or other keyframe properties |
Gap | Reported, the static frame is drawn |
Text
| SVG feature | State | Notes |
|---|---|---|
text, tspan with positions, anchor, size and weight |
Native | A tspan with its own position becomes its own text element |
font-family |
Not read | Text uses the embedded DejaVu Sans subset |
font-style, text-decoration, letter-spacing, word-spacing, writing-mode |
Gap | Reported |
| Different styles inside one line | Gap | The style of the line start is used |
textPath |
Gap | |
dominant-baseline |
Native | Kept in the binary from version 3 on |
Renderers
| Behavior | SVG | CPU | GPU |
|---|---|---|---|
| Style inherited from a group | Yes | No | No |
viewbox block |
Yes | No | No |
| Layer effects | All | All | Blur only |
| Edge antialiasing | Yes | Yes | No |
Imported files do not depend on the rows marked No, because the importer writes explicit style on every shape and a single wrapper transform.
Order of work
The remaining gaps share a few causes, so they are closed in this order.
- Done: a clip path on layers. It closes
clip-pathand thesymboland nestedsvgviewport clipping. What is left of it is the clip on a clip path child and the basic shapes. Masks followed on the same layer machinery and are done too. - Done: gradient units, a gradient matrix, spread modes, focal points and
frin the format (binary version 3). - Patterns. Done for fills by tile expansion in the importer. What is left is a real pattern def in the format, which would also give strokes and avoid one group per tile.
- Done: markers, expanded by the importer into copies at the vertices.
- Done for PNG, JPEG and SVG images. What is left is GIF, WebP and
.svgz, which need a decoder. - Done for blur, drop shadow and offset. What is left needs new effect kinds: a blur per axis, flood, color matrix and the compositing primitives, and primitive regions.
- Text styling, then
textPath. - Done: a binary version 3 with slots for
fill_opacity,stroke_opacityanddominant_baseline, written only for a scene that uses one. CPU and GPU now honor the two opacities. - Done for SMIL transforms and opacity, and the writer now writes animated scenes. CSS
@keyframesfollowed.set,animateMotionandsteps()followed. What is left is the properties that have no track channel yet, such as fill color and dash offset.