librsvg bugs

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search

Wikimedia Commons currently uses librsvg 2.50.3[1] for rendering images. It's a fast renderer (compared to Inkscape or Apache Batik), but its results are unreliable. There is a discussion about re-evaluating the SVG renderer on phab:T40010.

Some files may be fixed now. If there are any files that were uploaded earlier and have an error in displaying, you can try purging the file to force a re-render. You should check all the resolutions, since the bugs can show up differently in different resolutions.

If you see a buggy image, tag it with {{Rsvg bug}}. This puts it in Category:Pictures showing a librsvg bug. Some more bugs are reported at Commons:Commons SVG Checker#Checks.

Version history on Wikimedia
Version Usage on Wikimedia
number Release date[2] begin end
2.3.93[3] 2006[4]
2.14.0[4] 2006[4] at least 2007[5]
2.40.16[6] 2016-06 2016[6] 2017[7]
2.40.18[7] 2017-07 2017[7] 2019[8]
2.40.20-3[9] 2017-12 2019[8] 2020[10]
2.40.21[11] 2020-02 2020[10] 2023-05-16[1]
2.44.10[1] 2018-12 2023-05-16[1] 2024-06-06[12]
2.50.0 2020-09
2.50.3 2024-06-06[12]
2.50.7 2021-06[13]
2.52.0 2021-09
2.58.0 2024-03

Rendering of text

[edit]

Hairline cracks

[edit]

phab:T20936: This bug appears also in modern browsers on zooming levels.

White gap visible at odd px sizes (299px)
Same pic 1px larger rendered (300px)

An workaround can be the using of merge path.

Pattern

[edit]

phab:T20463: The libRSVG's handling of SVG pattern is only rudimentary. Some fixed examples (bug in file history):

Marker

[edit]

The presentation of markers is in different viewers implemented differently. The origin point varies. Inkscape shows the boundaries incorrectly.

Code of 3) use the translate attribute.

<circle id="circle3" transform="translate(20, 20)" stroke="rgb(0%, 70%, 0%)" cx="0" cy="0" r="20"/>
<marker id="marker3" refX="20" refY="20" viewBox="0 0 40 40"
    markerUnits="userSpaceOnUse" markerWidth="40" markerHeight="40">
  <use xlink:href="#circle3"/>  
</marker> 
<line x1="130" x2="270" y1="180" y2="180" marker-start="url(#marker3)" marker-end="url(#marker3)"/>
</svg>

Note that orient="auto-start-reverse" is not implemented in SVG 1.1.

List of outstanding SVG bugs

[edit]

Incomplete (please add missing ones e.g. from https://phabricator.wikimedia.org/tag/wikimedia-svg-rendering/)

Can be solved using svgworkaroundbot.toolforge.org

[edit]

Solution not yet determined

[edit]

References

[edit]