Curves SketchOnSurface

From FreeCAD Documentation
Jump to navigation Jump to search
Other languages:
English • ‎français • ‎italiano

This documentation is not finished. Please help and contribute documentation.

Gui Command explains how tools should be documented. See Draft ShapeString for an example of a well documented tool. Browse Category:UnfinishedDocu to see incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Curves SketchOnSurface.svg Curves SketchOnSurface

Menu location
Curves → Sketch on Surface
Default shortcut
Introduced in version
See also


This tool maps a sketch onto a face, like a label on a bottle. The sketch must be actually attached to a face (see Sketch.Support). The Map mode of the sketch has no effect on the result.

Curves SketchOnSurface demo.png

Above: shows the Sketch_on_surface object applied to the cylinder face (left) and the source sketch in edit mode (right)


  1. Switch to the Curves workbench icon.svg Curves workbench (you may need to install it via the AddonManager.svg Addon Manager
  2. There are 2 methods to use the SketchOnSurface tool:
    You already have a sketch that you want to map on a face
    1. Attach the sketch to the target face.
    2. Edit the sketch and add a Construction (blue) rectangle around the geometries.
      • This rectangle will be the parametric bounds of the face.
    3. Exit edit mode.
    4. Select the sketch and activate SketchOnSurface by either:
      1. Pressing on the Curves SketchOnSurface.svg button
      2. Using the Curves → Sketch on Surface entry in the Curves menu
    You have no sketch to map yet
    1. Select the target face in the 3D view
    2. Activate SketchOnSurface by either:
      1. Pressing on the Curves SketchOnSurface.svg button
      2. Using the Curves → Sketch on Surface entry in the Curves menu
      A "Sketch on surface" object appears in the Combo view.
      Click on this object to make "Mapped sketch" appear below.
      Click on the space bar to make "Mapped sketch" active. With a double click on "Mapped sketch", a blue frame appears. The given dimensions of the blue frame are corresponding to the surface of the object on which you want to map your sketch. The sketch will be placed perpendicular to the surface to be covered.
      Draw a SketchOnSurface object on this sketch, the blue frame, like a usual sketch and constrain it 100% (recommended).
      Close the sketch - important.
      A SketchOnSurface object will be created upon this sketch on the surface of your object.
    3. Edit the sketch and add geometries inside the blue construction bounds.


  • Fill Extrusion: When the Thickness value is not null, this will generate lofting faces (the blue faces in the above screenshot).
  • Fill Faces: This will fill all the geometrical figures closed in faces (the red faces in the above screenshot).
  • Offset: This will push the shapes mapped above into the target face. Do not put an offset greater than the thickness, it makes the face disappear on the inside.
  • Thickness: If not null, this will give thickness to the surfaces created above.



The blue construction lines of the sketch are part of the sketch even if they are not visible when the sketch is closed and even if the blue lines exceed the blue construction frame. The complete sketch will automatically scale so that it is no larger than the area to be covered.