Curves SketchOnSurface: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
No edit summary
 
(20 intermediate revisions by 5 users not shown)
Line 2: Line 2:
{{UnfinishedDocu{{#translation:}}}}
{{UnfinishedDocu{{#translation:}}}}
<translate>
<translate>

<!--T:1-->
<!--T:1-->
{{Docnav
{{Docnav
|[[Curves_IsoCurve|IsoCurve]]
|
|[[Curves_ProfileSupport|ProfileSupport]]
|
|[[Curves_Workbench|Curves]]
|
|IconL=Curves_IsoCurve.svg
|
|IconR=Curves_ProfileSupport.svg
|
|IconC=Curves_workbench_icon.svg
|
}}
}}


Line 15: Line 16:
{{GuiCommand
{{GuiCommand
|Name=Curves SketchOnSurface
|Name=Curves SketchOnSurface
|MenuLocation=Curves → Sketch on Surface
|MenuLocation=Surfaces → Sketch on Surface
|Workbenches=[[Curves Workbench|Curves]]
|Workbenches=[[Curves_Workbench|Curves]]
|SeeAlso=
}}
}}


Line 23: Line 23:


<!--T:13-->
<!--T:13-->
This tool maps a sketch onto a face.
This tool maps a sketch onto an arbitrary curved face, like a label on a bottle.
The sketch must be actually attached to a face (see Sketch.Support).
The sketch must be actually attached to a face (see Sketch.Support).
The {{incode|Map}} mode of the sketch has no effect on the result.
The {{incode|Map}} mode of the sketch has no effect on the result.
Line 29: Line 29:
<!--T:12-->
<!--T:12-->
[[File:Curves_SketchOnSurface_demo.png|600x400px]]
[[File:Curves_SketchOnSurface_demo.png|600x400px]]
{{Caption|Above: shows the {{incode|Sketch_on_surface}} object applied to the cylinder face (left) and the source sketch in edit mode (right)}}
{{Caption|Above: shows the {{incode|Sketch_On_Surface}} object applied to the cylinder face (left) and the source sketch in edit mode (right)}}


==Usage== <!--T:4-->
==Usage== <!--T:4-->


<!--T:5-->
<!--T:5-->
# Switch to the [[Image:Curves_workbench_icon.svg|24px]] [[Curves Workbench|Curves]] workbench (you may need to install it via the [[Image:AddonManager.svg|24px]] [[Addon Manager]]
# Switch to the [[Image:Curves_workbench_icon.svg|24px]] [[Curves_Workbench|Curves]] workbench (install from [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Addon Manager]] is necessary, if not previously installed)
# There are 2 methods to use the SketchOnSurface tool:
# There are 2 methods to use the SketchOnSurface tool:
#; You already have a sketch that you want to map on a face:
#; You already have a sketch that you want to map on a face:
## Attach the sketch to the target face.
## Attach the sketch to the target face:
##* In the attachment dialog selet the face
## Edit the sketch and add a Construction (blue) rectangle around the geometries.
##* This rectangle will be the parametric bounds of the face.
##* Set the mode to Deactivated while leaving the face as the first reference
##* Close the Attachment dialog
##* Set Placement.z=0
## Edit the sketch and add a Construction (blue) rectangle around the geometries. This rectangle will be the parametric bounds of the face.
## Exit edit mode.
## Exit edit mode.
## Select the sketch and activate SketchOnSurface by either:
## Select the sketch.
## Activate SketchOnSurface by either:
### Pressing on the [[Image:Curves_SketchOnSurface.svg|24px]] button
##* Pressing on the [[Image:Curves_SketchOnSurface.svg|24px]] button
### Using the {{MenuCommand|Curves → Sketch on Surface}} entry in the Curves menu
##* Using the {{MenuCommand|Surfaces → Sketch on Surface}} entry in the Curves menu
#; You have no sketch to map yet:
#; You have no sketch to map yet:
## Select the target face in the [[3D view]]
## Select the target face in the [[3D_view|3D view]]
## Activate SketchOnSurface by either:
## Activate SketchOnSurface by either:
### Pressing on the [[Image:Curves_SketchOnSurface.svg|24px]] button
##* Pressing on the [[Image:Curves_SketchOnSurface.svg|24px]] button
### Using the {{MenuCommand|Curves → Sketch on Surface}} entry in the Curves menu
##* Using the {{MenuCommand|Surfaces → Sketch on Surface}} entry in the Curves menu
## A Sketch_On_Surface object appears in the [[Tree_view|Tree view]].
##: A default sketch will be created and attached to this face.
##: A SketchOnSurface object will be created upon this sketch.
## Expand this object to make the Mapped_Sketch appear below.
## Edit the sketch and add geometries inside the blue construction bounds.
## Edit the sketch and add geometries inside the blue construction bounds.
## A SketchOnSurface object will be created on the surface of your object based on this sketch.


==Options== <!--T:6-->
==Options== <!--T:15-->

<!--T:6-->
* Fill Extrusion: When the Thickness value is not null, this will generate lofting faces (the blue faces in the above screenshot).
* 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 closed wires of the mapped shapes into faces (the red 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 offset the mapped shapes above or behind the target face.
* 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 create a second set of shapes, that will be offset by the given value from the first ones.
* Thickness: If not null, this will give thickness to the surfaces created above.


==Properties== <!--T:7-->
==Notes== <!--T:17-->


==Limitations== <!--T:8-->
<!--T:8-->
It is assumed that all geometry in the sketch is enclosed within the blue construction frame. This includes all other construction geometry, as well as the visible internal geometry of complex curves (Bezier, Ellipse). If this is not the case the bounding box of the sketch will be larger than the construction frame and the final mapping will be scaled down accordingly. If required [[Sketcher_RestoreInternalAlignmentGeometry|hide the internal geometry]] that is not fully inside the construction frame.

==Properties== <!--T:7-->


==Scripting== <!--T:14-->
==Scripting== <!--T:14-->



<!--T:9-->
<!--T:9-->
{{Docnav
{{Docnav
|[[Curves_IsoCurve|IsoCurve]]
|
|[[Curves_ProfileSupport|ProfileSupport]]
|
|[[Curves_Workbench|Curves]]
|
|IconL=Curves_IsoCurve.svg
|
|IconR=Curves_ProfileSupport.svg
|
|IconC=Curves_workbench_icon.svg
|
}}
}}



Latest revision as of 11:26, 16 March 2024

Other languages:

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

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more 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

Menu location
Surfaces → Sketch on Surface
Workbenches
Curves
Default shortcut
None
Introduced in version
-
See also
None

Description

This tool maps a sketch onto an arbitrary curved 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.

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

Usage

  1. Switch to the Curves workbench (install from Addon Manager is necessary, if not previously installed)
  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:
      • In the attachment dialog selet the face
      • Set the mode to Deactivated while leaving the face as the first reference
      • Close the Attachment dialog
      • Set Placement.z=0
    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.
    5. Activate SketchOnSurface by either:
      • Pressing on the button
      • Using the Surfaces → 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:
      • Pressing on the button
      • Using the Surfaces → Sketch on Surface entry in the Curves menu
    3. A Sketch_On_Surface object appears in the Tree view.
    4. Expand this object to make the Mapped_Sketch appear below.
    5. Edit the sketch and add geometries inside the blue construction bounds.
    6. A SketchOnSurface object will be created on the surface of your object based on this sketch.

Options

  • 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.

Notes

It is assumed that all geometry in the sketch is enclosed within the blue construction frame. This includes all other construction geometry, as well as the visible internal geometry of complex curves (Bezier, Ellipse). If this is not the case the bounding box of the sketch will be larger than the construction frame and the final mapping will be scaled down accordingly. If required hide the internal geometry that is not fully inside the construction frame.

Properties

Scripting