User Guide Cancel

Ribbon path | Substance 3D Painter

Last updated on Nov 18, 2025

Substance 3D home
Home
Getting Started
1. Getting Started overview
2. Activation and licenses
3. System requirements
4. Project creation
5. Export
  1. Export overview
  2. Export window
  3. Output templates
    1. Output templates overview
    2. Default Output templates
    3. Creating Output templates
6. Glossary
Interface
1. Interface overview
2. Assets
3. Substance 3D Assets
4. Color picker
5. Display settings
6. History
7. Layer stack
8. Main menu
9. Project configuration
10. Properties
11. Settings
12. Shader settings
  1. Shader settings overview
  2. Updating a shader
13. Texture Set
14. Toolbars
15. Viewport
16. Miscellaneous
Painting
1. Painting overview
2. Paint tools
3. Path tools
  1. Path tool overview
  2. Paint along path
  3. Ribbon path
  4. Filled path
  5. Erase along path
  6. Smudge along path
4. Straight line
5. Lazy mouse
6. Symmetry
7. Fill projections
8. Presets
  1. Presets overview
  2. Creating and saving presets
  3. Creating particles presets
  4. Photoshop brush presets
9. Dynamic strokes
10. Advanced channel painting
11. Vector graphic (.svg & .ai)
12. Text resource
Effects
1. Effects overview
2. Generator
3. Paint
4. Fill
5. Levels
6. Compare Mask
7. Filter
8. Anchor Point
Baking
Content
1. Creating custom effects
2. Importing assets
Features
1. Automatic resource update
2. Automatic UV Unwrapping
3. Physical size
4. Smart Materials and Masks
5. Subsurface Scattering
6. Dynamic Material Layering
7. UV Reprojection
8. UV Tiles
  1. UV Tiles overview
  2. Image Sequence
9. Color Management
10. Post Processing
11. Iray Renderer
12. Plugins
13. Sparse Virtual Textures
14. Custom Shaders
15. SpaceMouse® by 3Dconnexion
16. Universal Scene Description (USD)
17. Send to
Technical Support
1. Performance Guidelines
2. Configuring Pens and Tablets
3. Exporting the log file
4. Exporting a DXDiag
5. Technical issues
6. Workflow Issues
  1. Export Issues
    1. My exported opacity map is totally black
    2. Texture dilation or Padding
  2. Tools Issues
    1. Normal map looks incorrect
    2. Paint Tool bleeds on other UV islands
  3. Project Issues
  4. Library Issues
    1. Thumbnails in the shelf look incorrect
    2. Error when importing a Font
  5. Viewport Issues
    1. Mesh faces disappear when looking at them from behind
    2. Viewports and textures are blurry or lack sharpness
  6. Plugins Issues
    1. Substance Source plugin doesn't load
  7. License Issues
    1. Maintenance is expired dialog on startup
Pipeline and integration
1. Installation and preferences
2. Configuration
3. Resource management
Scripting and development
1. Scripts and plugins
  1. Creating a Javascript plugin
  2. Remote control with scripting
2. Shader API Reference
  1. Shader API overview
  2. Changelog - Shader API
  3. Libraries - Shader API
  4. Parameters - Shader API
  5. Shaders - Shader API
Release notes
1. Release notes overview
2. All Changes
3. Version 11.1
4. Version 11.0
5. Version 10.1
6. Old versions

Ribbon path

The Ribbon path tool allows you to create patterns that deform along a curve defined by points on the surface of the 3D model. The Ribbon can also be used to write text along a curve.

The Ribbon tool can be selected from the Path tool menu in the toolbar:

Or via the Path type button:

Overview

The Ribbon path tool differ from the Paint along path tool in how it draw images and materials.

While with the Paint/Brush based tool an image is repeated multiple times on a path, with the Ribbon the image is repeated along the path and deformed to follow its curves. Individual component of a Paint brush are called stamps, while those in the Ribbon are called patches.

Settings

Size

Parameter	Description
Stroke width	Control the global width of the current stroke.

Opacity

Parameter	Description
Stroke opacity	Control the final opacity of the current stroke.

Stroke

Parameter	Description
Image orientation	Define the direction of the input image. This direction control how the image is placed on the path.
Flip image	Flip the image along the axis/width of the path.
Corner	Define how sharp corners (split tangents) should appear on the path. Possible behaviors are: Miter join: sharp/pointy corner Round join: smooth/round corner Bevel join: square/flat corner Cut join: start the path again. This mode will create a new path with dedicated start/end sections. Below are what the corners look like, in order:
Omit ends when closed	If enabled, the start/end sections will be removed when a path is closed to make a continous loop. This applies to both stretch offsets and dynamic strokes.

Stretching & Tiling

The Ribbon path can use two different modes to control how an image is repeated and stretched along a path:

Stretch along path: (default) the image repeated along the path will be stretched to fit the path length
Keep aspect ratio: the image repeated along the path will have its aspect ratio preserved. If the image is too long compared to the path it will be cropped.

Stretch along path

Parameter	Description
Stretch between offsets only	If enabled, keeps the start and the end sections of an image intact while stretching the middle. Use the Start offset and End offset parameters to defined the size of these sections. The middle section will be automatically computed based on the start/end.
Tiling mode	Define how an image is repeated along the path. Possible values are: None: the image will not be repeated. It will be stretched along the whole path. Auto: (default) the image is automatically repeated a certain number of times based on its size and the stroke width. Custom: the imaged is repeated by the number of times defined by the Tiling amount parameter.
Tiling amount	Specify how many times an image is repeated in Custom tiling mode.
Mirror every 2nd tile	Flip the image used along the length of the path every second repetition.
Aspect ratio factor	Stretch or squeeze the current image aspect ratio.

Keep aspect ratio

Parameter	Description
Ratio	Define how the image is scaled while preserving its ratio: Fit to path width: (default) Scale the image to fit the path width. This can result in the image being cropped if too long. Fit to path length: Adapt the image's dimension so that an exact number fits along the path while approximately keeping the aspect ratio.
Remove clipped tiles	If enabled, will remove repetitions along the path that cannot be fully visible (if they are cropped). This setting is disabled if the Ratio setting is set to Fit to path length.
Tiling mode	Define how an image is repeated along the path. Possible values are: None: the image will not be repeated. It will be stretched along the whole path. Auto: (default) the image is automatically repeated a certain number of times based on its size and the stroke width. Custom: the imaged is repeated by the number of times defined by the Tiling amount parameter.
Mirror every 2nd tile	Flip the image used along the length of the path every second repetition.
Alignment	Define where the image should start along the path. Possible values are: Align at start: the image is drawn starting from the first point on the path. Align at center: the image is drawn in the middle of the path. Align at end: the image is drawn starting from the last point on the path.
Aspect ratio factor	Stretch or squeeze the current image aspect ratio.

Channel blending

This section controls the blending result for when the path overlaps itself.

Parameter	Description
Alpha	Control how the Alpha section of the Ribbon path is blended in regions where it overlaps itself, which affects the intensity of the blending of all the other channels. Possible values are: Normal: uses the alpha of the topmost segment. Lighten (Max): (default) uses the maximum alpha value, preserving the most opaque segment. Linear dodge (Add): adds the alpha of the segments to accumulate them together, resulting in a more saturated value.
Normal	Define how the Normal channel is blended in regions where the path overlaps itself. Possible values are: Normal: uses the result of the topmost segment. Normal map combine: (default) combine the segments with equal intensity. Normal map details: consider the topmost segment as additional details while bottom regions will preserve their intensity. This setting is separate from the Normal blending mode defined for the whole layer, which is applied after the path's own self-overlap blending. Note: this setting is disabled if the channel is a uniform color. It is compatible only with bitmaps and Substance resources.
Height	Define how the Height channel is blended in regions where the path overlaps itself. Possible values are: Normal: uses the result of the topmost segment. Linear dodge (Add): adds segments together while preserving their original intensity. Darken (Min): keep only the darkest/lowest value of the overlapping segments. Light (Max): (default) keep the lightest/highest value of the overlapping segments. Screen: similar to Linear Doge, but gives a less saturated result. This setting is separate from the Height blending mode defined for the whole layer, which is applied after the path's own self-overlap blending. Note: this setting is disabled if the channel is a uniform color. It is compatible only with bitmaps and Substance resources.