Freestyle SVG Exporter

An example of an SVG result produced by the Freestyle SVG Exporter.

This add-on can be enabled via User Preferences ‣ Add-ons ‣ Render ‣ Freestyle SVG Exporter.The GUI for the exporter should now be visible in the render tab of the Properties editor.The exported file is written to the default output pathProperties editor ‣ Render ‣ Output.

Reference

Freestyle SVG Export panel.

• Mode
• Option between Frame and Animation. Frame will render a single frame,Animation will bundle all rendered frames into a single .svg file.
• By default the exporter will not take invisible vertices into account and export them like they are visible.Some stroke modifiers, like Blueprint, mark vertices as invisible to achieve a certain effect. Enabling thisoption will make the paths split when encountering an invisible vertex, which leads to a better result.
• Fill Contours
• The contour of objects is filled with their material color.

This feature is somewhat unstable — especially with animations.

• Stroke Cap Style

• Defines the style the stroke caps will have in the SVG output.

  • Mitter
  • Round
  • Corners are smoothed.
  • Bevel
  • Corners are beveled.

Reference

Because the representation of Freestyle strokes and SVG path objects is fundamentally different, a one-on-onetranslation between Freestyle and SVG is not possible. The main shortcoming of SVG compared to Freestyle is thatFreestyle defines style per-point, where SVG defines it per-path. This means that Freestyle can produce much morecomplex results that are impossible to achieve in SVG.

The properties (no modifiers applied) that can be exported are:

• Base color
• Base alpha
• Dashes

The exporter supports the creation of SVG animations. When the Mode is set to Animation, all frames from a render —one when rendering a frame (F12)or all when rendering an animation (Shift-F12) — are saved into a single file.Most modern browsers support the rendering of SVG animations.

An SVG animation rendered with the exporter.

Fills are colored areas extracted from a Freestyle render result. Specifically, they are defined by a combination ofthe Contour and External Contour edge type, combined with some predicates. The fill result can be unexpected,when the SVG renderer cannot correctly draw the path that the exporter has generated.This problem is extra apparent in animations.

Fills support holes and layering. When using layers, the exporter tries to render objects with the same material asthe patch. The exporting of fills and especially the order in which they are layered is by no means perfect.In most cases, these problems can be easily solved in Inkscape or a text editor.