Vector Graphics (SVG) Resource

Substance 3D Designer supports a limited form of Vector Graphics, through the Scalable Vector graphics format. SVG files can be brought in as resources in different ways, to be used as resources for your graphs.

SVG files can be created or edited through the atomic SVG node, they can also be created by the UV to SVG baker.

Adobe Illustrator (.ai) files are currently unsupported.

SVG Storage

SVG storage depends on if they are Linked, or imported. Imported SVG files are embedded into the SBS file, requiring no external files like Bitmaps, and can be edited using the Vector editing tools.

SVG Attributes

SVG Resources in a package have a number of attributes that you can customize. Most attributes don't have a major purpose and are for library filters, but a minority affects rendering quality.

Attribute namePurpose
Identifierused for referencing inside packages. No reason to change this
File PathUsed to reference file on disk in SBS. Do not modify directly, used Relocate... functionality!
DescriptionUsed for library descriptions.
CategoryUsed for Library filters.
LabelUsed for Library filters.
AuthorUsed for Library filters.
Author URLUsed for Library filters.
TagsUsed for Library filters.
User DataOptional extra data, not used on bitmaps.
Show In LibraryDetermines if bitmap should be hidden in the Library View.
Vector Graphics QualityAffects rendering quality. Range is not linear, best quality is achieved at 0.5, beyond that it starts to optimize again.

SVG Authoring

Because only a limited set of functionality is supported, authoring SVG's is constrained.

In general the following is true:

SVG features

  • Only simple primitive shapes and paths are guaranteed to draw correctly.
  • Stroke is supported, but only results in 1px stroke, as stroke styling is ignored.
  • Dashed line styles will definitely break.
  • Text needs to be converted to paths/outline to be rendered.
  • Advanced features like gradients are not supported.
  • Style Elements for CSS properties are not supported.

Recommended export option for SVGs

Export options are slightly different for each applications:

Adobe Illustrator

Illustrator allows the most control over your SVG exports if you pay attention to the following options.

  • Use only Save As, not Export As!
  • SVG Profile does not matter much, though the Tiny profile will (mostly) default to settings that are definitely correct.
  • Fonts must be set to Convert to Outline to work.
  • CSS Properties should not be set to Style Elements, all other options will work.
  • Uncheck Preserve Illustrator Editing Capabilities.
  • Strokes will not work well, use Object > Path > Outline Stroke to get them to show up.
Artboards can affect the result of the SVG file generated. Some Illustrator file templates introduce multiple Artboards. Try to have only one, properly cropped artboard, and have it selected in the Artboard window when saving as SVG.

Inkscape

Inkscape saves natively as SVG, but with less control over the file format. Inkscape files will mostly work natively in the application, but with some limitations:

  • Strokes only show as 1px wide in Substance 3D Designer, use Path > Stroke to Path to get them to work, 
  • Text will not work, use Path > Object to Path to get text to work.

Photoshop

Photoshop has a very limited SVG exporter (File > Export >Export As..) that is currently unable to produce correct results for Substance 3D Designer. You can get your shape and path information, but Style is always saved as Elements, which is incompatible.

It can be used for simple black and white shape masks, where a solution is to extract the Alpha from the SVG using Alpha Split.

Alternatively a Photoshop-exported SVG can be Imported, which lets you then edit the style information natively inside the application.