SolidWorks Wrap Feature — Emboss, Scribe, and Deboss: When Each Mode Fails and Why

The Wrap feature works instantly or fails with a cryptic error, with little indication of which outcome you’ll get until you click OK. Three modes — Emboss, Deboss, Scribe — fail in different ways and for different geometric reasons. Knowing which one applies to your geometry, and why the others will fail, stops the rebuild-error loop before it starts.

What the Three Modes Actually Do

All three Wrap modes start with a sketch on a flat plane and project that sketch geometry onto a curved or non-planar face. The divergence is what happens to the geometry after it lands.

Emboss extrudes the sketch profile outward from the target surface, adding material above it. If you’re wrapping text onto a cylindrical cap, Emboss makes the letters stand proud. The operation is geometrically equivalent to a surface-following boss extrusion: an offset surface is computed at the specified depth, and the material between the source surface and the offset becomes the added body.

Deboss does the inverse — removes material by sinking the sketch profile into the surface. Equivalent to a surface-following extruded cut.

Scribe splits the target face along the projected sketch contour without adding or removing material. The result is new face boundaries at the sketch profile shape, but no change to the solid geometry. Surface topology changes; shape does not. It’s the closest to what Split Line does, except Scribe follows the surface curvature when wrapping rather than projecting straight down.

Two Methods: Analytical and Spline Surface

The PropertyManager exposes two wrap methods. This is where most failures originate.

Analytical method — the original method, still the default — can only wrap onto planar, cylindrical, or conical faces. The constraint is strict: the sketch plane must be tangent to the target face. For a cylinder, this means the sketch plane must touch the cylindrical surface at exactly one generator line. If it’s offset or angled, SolidWorks throws an error before computing anything.

Analytical projection works by unrolling the target surface (planar, cylindrical, and conical faces have exact analytic inversions), placing the sketch flat, then re-rolling. This is exact for those surface types and produces clean, dimensionally accurate results.

Spline Surface method (introduced in SolidWorks 2017) wraps onto any surface by computing a parameterized surface mapping — numerically, not analytically. It handles freeform NURBS surfaces, compound blends, and any topology the Analytical method rejects. The tradeoff: the “Accuracy” slider appears in the PropertyManager, and at low accuracy settings, fine sketch details will be approximated.

The diagnostic rule is simple: if Analytical errors, switch to Spline Surface. If Spline Surface also errors, the problem is in the sketch geometry or the target surface topology, not the method.

Why Emboss and Deboss Fail More Often Than Scribe

Emboss and Deboss require computing an offset surface — a surface parallel to the target face, displaced by the feature depth. This is where most failures occur, and it’s the same class of problem that causes fillets to fail on complex geometry (see SolidWorks vs Inventor vs FreeCAD fillet kernel differences for how offset surface computation varies across kernels).

An offset surface fails to compute when:

1. The feature depth exceeds the minimum radius of curvature. If you’re embossing onto a convex surface with a 3mm radius of curvature, and you specify a depth of 4mm, the offset surface folds through itself. SolidWorks fails with “Wrap Feature — could not compute offset surface” or a similar message. The offset would require the surface to invert, which Parasolid refuses to produce as a valid B-Rep.

2. The offset surface intersects adjacent geometry. If the wrapped feature is near an existing edge, the offset surface may break outside the solid’s bounding volume. The result is a self-intersecting offset, which Parasolid refuses to boolean with the existing body. This is particularly common when wrapping near fillets or close to a part boundary.

3. Faces with inflection points. If the target face transitions from concave to convex — an “S” curve in cross-section — the offset surface crosses itself at the inflection region. The Analytical method can’t handle this at all; Spline Surface sometimes succeeds with high accuracy settings, but often fails too.

Scribe avoids all of these. Because Scribe only splits faces — it never offsets — there’s no depth computation that can fail. Scribe succeeds on any surface where the sketch can be cleanly projected. The only Scribe failure mode is when the projected contour passes through an existing edge vertex at an angle the kernel can’t resolve. Even then, splitting the sketch at those locations and scribing in two separate features usually resolves it.

The Tangency Requirement — Why Your Sketch Plane Matters

For the Analytical method, the sketch plane must be tangent to the target face, not offset from it.

For a cylinder: the sketch plane must pass through (or be parallel to) the cylinder’s axis and touch the cylindrical surface at one generator line. “Offset from Front Plane by 50mm” when the cylinder radius is 55mm works — the plane is tangent. “Offset by 60mm” means the plane intersects the cylinder — tangency is lost, and SolidWorks errors immediately.

For a cone: the sketch plane must be tangent to the conical surface. A plane through the cone’s apex works; a parallel offset does not.

The Spline Surface method relaxes this — the sketch plane can be offset from the target surface and SolidWorks computes the projection numerically.

The Emboss/Deboss Grayed-Out Problem

If Emboss and Deboss appear grayed out in the Wrap PropertyManager, you’re on the Analytical method and the selected face is not a valid Analytical target — it’s not planar, cylindrical, or conical, or the sketch plane is not tangent.

Fix: switch to the Spline Surface method. The radio button is in the Method section of the PropertyManager. Once Spline Surface is selected, Emboss and Deboss become available for any face type.

This is the single most common Wrap question in forums. The gray-out is not a bug — it’s the Analytical method correctly refusing a geometry type it can’t handle. The UI doesn’t make this obvious.

Scribe for Laser Engraving and Surface Marking

Scribe is the right Wrap mode for laser engraving workflows on sheet metal.

Laser machines that read SolidWorks flat pattern DXF files treat all closed contours as cut paths by default. If you Emboss text onto a sheet metal part, the flat pattern DXF shows the embossed text as a set of polygonal closed contours — which the laser software interprets as through-cuts, producing cut-out letters rather than engraved marks.

Scribe, by contrast, projects the sketch as split edges on the flat pattern surface. When exported to DXF, Scribe contours appear as distinct line and arc entities on the sheet face, separate from the outer profile. Laser software that reads DXF layers can be configured to interpret these entities as engraving paths (mark operation) rather than cut paths.

The workflow for DXF-ready surface-marked sheet metal:

1. Create the Wrap Scribe feature on the 3D part (Spline Surface method if the face has any compound curvature)
2. The Scribe lines appear on the flat pattern configuration
3. Export the flat pattern DXF with Scribe entities assigned to a distinct layer — e.g., ENGRAVE — separate from the profile layer (CUT)
4. In the laser software, map the ENGRAVE layer to a mark operation rather than a through-cut

For controlling which entities land on which DXF layer, the DXF entity export settings in SolidWorks explains the layer assignment options in the ExportFlatPatternView options dialog.

One caveat: Wrap Scribe on sheet metal flat patterns is functional but version-sensitive. Test with your specific SolidWorks version and laser software before committing to this workflow on production parts — the behavior of Scribe entities in DXF export has changed across releases.

Text on Curved Surfaces — When Wrap Breaks

Wrapping text on compound curves (spheres, blended transitions between faces) consistently fails because:

1. SolidWorks text sketch entities include very short curve segments at letter corners. When wrapped, these create near-degenerate geometry that Parasolid rejects.
2. The sketch-to-face projection places vertices very close together at high-curvature regions, triggering tolerance violations in the boolean operation.

Strategies that work reliably:

Convert text to sketch segments before wrapping. Right-click the text sketch and select “Dissolve Sketch” or use “Convert Entities” to break font curves into editable geometry. Then manually remove segments shorter than ~0.1mm and merge nearby coincident points. Cleaner input geometry produces fewer degenerate results.

Use Scribe instead of Emboss for text. Scribe avoids the offset computation entirely, so degenerate short segments that would cause Emboss to fail are handled more gracefully.

Increase Spline Surface accuracy. The Accuracy slider in the PropertyManager controls the resolution of the numerical surface mapping. Higher accuracy reduces approximation error on complex letter shapes — at the cost of rebuild time.

Split per character. Apply one Wrap feature per letter or word. This isolates failures to specific characters (usually capital ‘I’, thin serifs, or tight curves), making debugging manageable without re-running the entire text block.

The Flat Pattern Caveat for Embossed Sheet Metal

Wrap Emboss and Deboss on sheet metal parts produce 3D formed geometry that cannot be flattened. The Flat Pattern operation unfolds bends using gauge table bend allowances, but formed features — lances, louvers, Wrap Emboss geometry — are excluded from the unfold process. On the flat pattern, the embossed region appears as a hole or is suppressed.

This is expected behavior, not a bug. Sheet metal embossed features are classified as “formed” and are shown suppressed or replaced with their flat footprint in the flat pattern, depending on your configuration and the forming tool setup.

If you need the embossed feature’s projected footprint in the DXF flat pattern, the workaround is to sketch the footprint manually on the flat pattern configuration and export it as a reference entity — or use a Wrap Scribe feature to mark the region instead, which does appear correctly in the flat pattern without the formed-feature suppression. For context on the full flat-to-DXF pipeline, see how SolidWorks creates flat pattern DXF exports.

API Access: IWrapFeatureData

For automating Wrap feature creation or reading wrap parameters from existing models, the interface is IWrapFeatureData, obtained via IFeature.GetSpecificFeature2() on any feature whose type name is "WrapSketch".

Key properties on IWrapFeatureData:

The meters trap applies to WrapThickness — SolidWorks API always uses meters regardless of document units. A 2mm Emboss is stored as 0.002. For the full list of API methods affected by this trap, see SolidWorks VBA API: the meters trap.

To iterate Wrap features in a part:

IFeature feat = (IFeature)part.FirstFeature();
while (feat != null)
{
    if (feat.GetTypeName2() == "WrapSketch")
    {
        IWrapFeatureData wrapData = (IWrapFeatureData)feat.GetSpecificFeature2();
        int wrapType = wrapData.WrapType; // 0=Emboss, 1=Deboss, 2=Scribe
        int method = wrapData.WrapMethod; // 0=Analytical, 1=Spline Surface
        double depthMm = wrapData.WrapThickness * 1000.0;
        Debug.WriteLine($"{feat.Name}: type={wrapType} method={method} depth={depthMm:F3}mm");
    }
    feat = (IFeature)feat.GetNextFeature();
}

Note: GetTypeName2() returns "WrapSketch" for all three Wrap modes. The Emboss/Deboss/Scribe distinction is only in WrapType.

Diagnostic Workflow

When Wrap fails, work through this sequence:

1. Analytical method error? Switch to Spline Surface in the Method section. If that resolves it, you’re done — the face type wasn’t Analytical-compatible.

2. Spline Surface also fails? Check for inflection points on the target face. If the face transitions concave-to-convex, Emboss/Deboss offset computation will fail regardless of method. Switch to Scribe.

3. Scribe fails? The sketch contour likely passes through an existing edge vertex at an angle the kernel can’t split cleanly. Trim the sketch at the boundary and apply Scribe as two separate features joining at that point.

4. Emboss/Deboss grayed out? You’re on Analytical method. Switch to Spline Surface — both modes become available for any face type.

5. Text wrapping fails? Dissolve the text sketch to individual segments, remove degenerate short curves, switch to Scribe mode, increase accuracy, and split per character if needed.

6. Works in 3D but breaks flat pattern? Emboss/Deboss are formed features — they’re suppressed in the flat pattern by design. Use Scribe for surface marking that needs to appear in the flat pattern DXF.