SVG Texture Layer

Create smooth-edged, precise shapes or use custom fonts in your materials with the SVG texture layer.

If the SVG is the first texture layer in a material, the resolution to generate the texture with is required.

Property	Description
Name	Text The name of the layer, helpful when automating during run-time with Snap rules.
SVG XML	Text The instructions to create this scalable vector graphic. See the page on the SVG element for examples. This must be well-formed XML.
Preload Font Stylesheet	Text If the SVG XML refers to a font, the stylesheet URL helps the user’s computer find it. Leave blank to refer to a font installed on the user’s computer. This is risky, as not all operating systems or workstations or phones have the same fonts installed. Enter the path to a stylesheet to refer to a web-based font. This is safer, as it will work well on all modern web browsers, regardless of operating system. Learn more about finding or creating a stylesheet URL, and using special fonts in other ways.
U-Scale V-Scale	A number that scales the material image relative to the face of the mesh. U represents the scale along one dimension of the surface, and V represents the scale at a perpendicular dimension.The number represents the number of times the entire image can be shown on the face in a given direction. For example, the material image would appear once across the top of a mesh with a UV scale of 1:1. The same material image would appear much smaller, six times over, if the UV scale were set to 3:2. (Three tiles of the image in one direction, and two tiles in the other direction, for a total of 6 tiles of the image on that surface).
U-Offset V-Offset	A vector that moves the projection of the UV map onto the surface of the mesh. U represents the position along one dimension of the surface, and V represents the position at a perpendicular dimension.
Angle	A number that rotates the projection of the UV map around the center of the mesh. For example, rotate a material of wooden floorboards to 45 degrees diagonal across the surface of the floor.
Pivot U Pivot V	A point around which the angle rotates.
U Alignment	How the SVG graphic should be aligned horizontally: left, center, or right.
V Alignment	How the SVG graphic should be aligned vertically: none, stretch, or contain.
Maintain Aspect Ratio	Set to true to ensure the SVG is not distorted across a 2D plane.
Tile	Set to true to have the SVG image used as a pattern which repeats as necessary to fill the surface this material is applied to.
Colorize Colorize With	Turn Colorize on to reveal the Colorize With field. Color this texture with a chosen color. Does not affect luminosity.
Blending Mode	See https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
Texture Strength	How strongly the given texture layer affects the entire texture

Example: using a custom font in an SVG texture

First, learn how to use fonts in Epicor CPQ. That will show you how to find three pieces of information that will help your font work in your annotation: the font name, the stylesheet URL, and the font URL.

In this example, we will use two fonts available publicly from Google fonts: “Shadows Into Light” and “Lobster”. Using the Google Fonts tool, we create a CSS stylesheet URL that can help any computer find those two fonts:

Example Stylesheet

                https://fonts.googleapis.com/css2?family=Lobster&family=Shadows+Into+Light&display=swap  
            

We also created a simple SVG graphic that uses these two fonts:

Example SVG graphic

                <svg xmlns="http://www.w3.org/2000/svg"width="400"height="150" font-size="24"text-anchor="middle"><text font-family="Shadows Into Light"x="190"y="59.92">This is Shadows Into Light font</text><text
                font-family="Lobster"x="190"y="112.92">This is Lobster font</text></svg>
            

1. Create a new material.

2. Set the name to “GoogleFonts”

3. No other properties of this material need to be adjusted for our example.

4. In the “textures” list of properties for this material, add a new Color Fill - Albedo layer.

   1. Set the fill color to white (255,255,255,1).

   2. Set the render resolution pixel width to 1200, and height to 600. This will help ensure the SVG has enough space to render.

5. In the “textures” list of properties for this material, add a new SVG Texture - Albedo layer.

   1. Set the fill color to white (255,255,255,1).

   2. Set the SVG XML to the 8 lines of code above.
      When you tab out of this field (or otherwise move the focus elsewhere), you should see a thumbnail of the SVG image render below the SVG XML field. Note the thumbnail shows the text, but not in the correct font.

   3. Set the preload font stylesheet to the 1 line of stylesheet reference above.
      When you tab out of this field (or otherwise move the focus elsewhere), you should see the fonts appear in the thumbnail.

   4. Set the U scale and V scale to 1.

   5. Set the U-Fit and V-Fit to Stretch.
      

6. Create a simple plane.

7. Apply the “google fonts” material to the plane.

8. See your SVG graphic appear on the plane. The two fonts appear within the graphic.