Difference between revisions of "Part ProjectionOnSurface"

From FreeCAD Documentation
Jump to navigation Jump to search
(The image does not need to be translated)
(Updated Docnav.)
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
<languages/>
 
<languages/>
{{UnfinishedDocu{{#translation:}}}}
 
 
<translate>
 
<translate>
  
Line 6: Line 5:
 
{{Docnav
 
{{Docnav
 
|[[Part_Thickness|Thickness]]
 
|[[Part_Thickness|Thickness]]
|[[Part_CompCompoundTools|CompCompoundTools]]
+
|[[Part_EditAttachment|Attachment]]
|[[Part_Module|Part]]
+
|[[Part_Workbench|Part]]
 
|IconL=Part_Thickness.svg
 
|IconL=Part_Thickness.svg
 +
|IconR=Part_EditAttachment.svg
 
|IconC=Workbench_Part.svg
 
|IconC=Workbench_Part.svg
|IconR=Part_CompCompoundTools.png
 
 
}}
 
}}
 
  
 
<!--T:2-->
 
<!--T:2-->
Line 18: Line 16:
 
|Name=Part ProjectionOnSurface
 
|Name=Part ProjectionOnSurface
 
|MenuLocation=Part → Create projection on surface...
 
|MenuLocation=Part → Create projection on surface...
|Workbenches=[[Part Module|Part]]
+
|Workbenches=[[Part_Workbench|Part]]
|SeeAlso=
 
 
|Version=0.19
 
|Version=0.19
 
}}
 
}}
Line 26: Line 23:
  
 
<!--T:4-->
 
<!--T:4-->
[[Part_ProjectionOnSurface|Part ProjectionOnSurface]] is used to project a [[Shape|Shape]] on top of a surface from another [[Shape|Shape]]; this can be used to project a logo or text message (see {{Button|[[File:Draft_ShapeString.svg|16px]] [[Draft_ShapeString|Draft ShapeString]]}}) onto curved surfaces to create interesting effects.
+
{{Button|[[File:Part_ProjectionOnSurface.svg|16px]] [[Part_ProjectionOnSurface|Part ProjectionOnSurface]]}} is used to project a [[Shape|Shape]] on top of a face from another object; this can be used to project a logo or textual object (see {{Button|[[File:Draft_ShapeString.svg|16px]] [[Draft_ShapeString|Draft ShapeString]]}}) onto different surfaces to create interesting effects.
  
 
<!--T:5-->
 
<!--T:5-->
This tool can project the entire face, or only a wire or edge of a [[Shape|Shape]]. The result can be a new face or wire on the surface, or even a projection solid, which can be used in a [[Part_Cut|boolean cut]].
+
Given a source [[Shape|Shape]], this tool can project edges, wires (closed edges), or entire faces from it; the result can be new edges, new wires, new faces, or even new extruded solids which can be used in [[File:Part_Boolean.svg|24px]] [[Part_Boolean|boolean operations]] for effects such as engraving or stamping.
  
 
</translate>
 
</translate>
[[image:Part ProjectionOnSurface1.png|300px]] [[image:Part ProjectionOnSurface2.png|300px]]
+
[[Image:Part_ProjectionOnSurface1.png|300px]] [[Image:Part_ProjectionOnSurface2.png|300px]]
 
<translate>
 
<translate>
  
 
<!--T:7-->
 
<!--T:7-->
{{Caption|Projection on a curved surface}}
+
{{Caption|Projection of a logo on a curved surface.}}
  
 
==Usage== <!--T:8-->
 
==Usage== <!--T:8-->
  
 
<!--T:9-->
 
<!--T:9-->
# Select the face you want to project to.
+
# Make sure you have at least two objects in your document; the "source" object that you wish to project, and the "target" object where the projection will be made.
# The projection direction
+
# Click on {{Button|[[File:Part ProjectionOnSurface.svg|16px]] [[Part_ProjectionOnSurface|Projection on surface]]}} to launch a [[task_panel|task panel]] with various options.
#* When entering the function, the current camera direction is used for the projection direction
+
# Click on {{Button|Select projection surface}}, and then click on the "target" surface where the projection will be created.
#* To change the direction, use the camera direction to get your projection direction and press "Get current camera direction"
+
# Then click on the specific button to choose the type of subelement that you want to add to your projection object.
#* Or press {{KEY|X:}},{{KEY|Y:}},{{KEY|Z:}} to toggle the direction x=1,x=-1,y=1,y=-1,z=1,z=-1
+
#* {{Button|Add face}}: select a source face.
# Choose what kind of shape you want to add to your projection object.
+
#* {{Button|Add wire}}: select a source edge. The tool will extract the entire wire to which the edge belongs. For example, by choosing a single edge of a polygon, it will project the entire polygon.
#* Add Face: Select a face you want to add.
+
#* {{Button|Add edge}}: select a source edge. The tool will only project the selected edge.
#* Add wire: Select a edge. The algorithm takes the wire the edge belongs to and adds it to the projection object.
+
#* Once a button is depressed, pick a subelement in the [[3D_view|3D view]]. If you wish to deselect it, pick the same element again.
#* Add edge: Select a edge. The selected edge is added to the projection object.
+
#* When you are satisfied with your selection, press the same {{Button|Add...}} button to leave the selection mode.
# Choose the what kind of shape you like to create.
+
# Then click on the specific radiobutton to choose the type of projection shape to create.
#* Show all: Shows if possible the projected solid object.
+
#* {{RadioButton|TRUE|Show all}}: it will show all types of closed wires and edges on the target surface. If a "face" subelement was selected in the previous step, a preview of a solid object extruded from the projection will be shown, depending on the value of {{MenuCommand|Extrude height}}.
#* Show faces: Shows if possible the projected face object.
+
#* {{RadioButton|TRUE|Show faces}}: it will show a preview of a filled face on the target surface. This will only work if you selected a "face" subelement in the previous step; if you selected a closed "wire", only the edges (no face) will be created as projection; if you selected "edges", only those edges will be created as projection.
#* Show edges: Shows the projected edge object.
+
#* {{RadioButton|TRUE|Show edges}}: it will show a preview of the edges on the target surface. This will work whether you added a "face", "wire", or "edge" subelement in the previous step; even if you added a filled "face", only the edges will be created as projection.
# Extrude height is the value the solid is extrude along the reversed projection direction.
+
# Press the {{Button|OK}} to complete the operation and produce the new projection object.
# Solid depth is the value the projection object is moved along the projection direction.
+
 
# When you are finish with the projection object hit {{Button|OK}} and the projection object is created.
+
<!--T:21-->
 +
Notes:
 +
* The projection direction is automatically taken from the camera direction in the [[3D_view|3D view]] at the moment the tool is launched.
 +
* To change the direction, move the camera, and press {{Button|Get current camera direction}}.
 +
* Alternatively press the {{Button|X:}}, {{Button|Y:}}, or {{Button|Z:}} buttons to set the projection direction to the main global axes, +X, -X, +Y, -Y, +Z, or -Z.
 +
* However, do notice that changing the projection direction won't automatically update the projection preview; in order to do this, you must re-select the geometry by pressing the {{Button|Add...}} buttons and picking the subelements again.
  
 
==Options== <!--T:10-->
 
==Options== <!--T:10-->
  
 
<!--T:11-->
 
<!--T:11-->
# Extrude height
+
* {{MenuCommand|Extrude height}}: it is the height of the solid shape that is created by extruding the projected face, from the target surface and along the negative of the projection direction. For example, if the projection direction is along +Y {{Value|(0, 1, 0)}}, the extrusion will be created in the direction -Y {{Value|(0, -1, 0)}}. This solid extrusion will only be created if the subelement selected was a closed face, by pressing the {{Button|Add face}} button, and by choosing the {{RadioButton|TRUE|Show all}} option.
#* The height value a valid projection solid is extruded along the reversed projection direction
+
* {{MenuCommand|Solid depth}}: it is the distance that the projection object is moved along the projection direction. Negative values will displace the object in the opposite direction; this allows creating a projection that is offset from the target surface.
# Solid depth
 
#* The depth value a valid projection object is moved along the projection direction
 
# Camera / projection direction
 
#* "Get current camera direction" sets the current camera view for the projection direction
 
#* X: toggle the projection direction between x=1 and x=-1
 
#* Y: toggle the projection direction between y=1 and y=-1
 
#* Z: toggle the projection direction between z=1 and z=-1
 
  
 
==Limitations== <!--T:12-->
 
==Limitations== <!--T:12-->
  
 
<!--T:13-->
 
<!--T:13-->
The projection algorithm sometimes is not able to create a valid projection face. If this happens a solid also can't be created.
+
The projection algorithm sometimes is not able to create a valid projection face. If this happens a solid extrusion won't be able to be created either.
  
 
<!--T:14-->
 
<!--T:14-->
 
If this happens:
 
If this happens:
# Check if your starting face is valid.
+
* Check if your source face is valid; try running the {{Button|[[File:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|CheckGeometry]]}} tool for clues.
# Check if the projection direction is valid. (Can the face be projected to surface? Or does it not hit the surface?)
+
* Check if the projection direction is valid. Can the source face be realistically projected onto the target surface? Would a straight projection hit the surface? Adjust the camera so that the source face is in front of the target surface, and try again.
# Try to use the "Show edges" option. Are the edges projected well? Try to create a face with the edges by hand.
+
* Try to use the {{RadioButton|TRUE|Show edges}} option. Are the edges projected correctly? Try to create a face with the edges by hand.
  
 
==Links== <!--T:15-->
 
==Links== <!--T:15-->
  
 
<!--T:16-->
 
<!--T:16-->
* "Project faces onto bended surface" [https://forum.freecadweb.org/viewtopic.php?f=9&t=33700 Forum thread]
+
* Forum thread: [https://forum.freecadweb.org/viewtopic.php?f=9&t=33700 Project faces onto bent surface]
  
 
==Examples== <!--T:17-->
 
==Examples== <!--T:17-->
Line 92: Line 87:
 
{{Docnav
 
{{Docnav
 
|[[Part_Thickness|Thickness]]
 
|[[Part_Thickness|Thickness]]
|[[Part_CompCompoundTools|CompCompoundTools]]
+
|[[Part_EditAttachment|Attachment]]
|[[Part_Module|Part]]
+
|[[Part_Workbench|Part]]
 
|IconL=Part_Thickness.svg
 
|IconL=Part_Thickness.svg
 +
|IconR=Part_EditAttachment.svg
 
|IconC=Workbench_Part.svg
 
|IconC=Workbench_Part.svg
|IconR=Part_CompCompoundTools.png
 
 
}}
 
}}
  

Latest revision as of 07:33, 3 September 2021

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎русский
Arrow-left.svg Previous: Part Thickness.svg Thickness
Next: Attachment Part EditAttachment.svg Arrow-right.svg

Part ProjectionOnSurface.svg Part ProjectionOnSurface

Menu location
Part → Create projection on surface...
Workbenches
Part
Default shortcut
None
Introduced in version
0.19
See also
None

Description

Part ProjectionOnSurface.svg Part ProjectionOnSurface is used to project a Shape on top of a face from another object; this can be used to project a logo or textual object (see Draft ShapeString.svg Draft ShapeString) onto different surfaces to create interesting effects.

Given a source Shape, this tool can project edges, wires (closed edges), or entire faces from it; the result can be new edges, new wires, new faces, or even new extruded solids which can be used in Part Boolean.svg boolean operations for effects such as engraving or stamping.

Part ProjectionOnSurface1.png Part ProjectionOnSurface2.png

Projection of a logo on a curved surface.

Usage

  1. Make sure you have at least two objects in your document; the "source" object that you wish to project, and the "target" object where the projection will be made.
  2. Click on Part ProjectionOnSurface.svg Projection on surface to launch a task panel with various options.
  3. Click on Select projection surface, and then click on the "target" surface where the projection will be created.
  4. Then click on the specific button to choose the type of subelement that you want to add to your projection object.
    • Add face: select a source face.
    • Add wire: select a source edge. The tool will extract the entire wire to which the edge belongs. For example, by choosing a single edge of a polygon, it will project the entire polygon.
    • Add edge: select a source edge. The tool will only project the selected edge.
    • Once a button is depressed, pick a subelement in the 3D view. If you wish to deselect it, pick the same element again.
    • When you are satisfied with your selection, press the same Add... button to leave the selection mode.
  5. Then click on the specific radiobutton to choose the type of projection shape to create.
    • RadioButtonTrue.svg Show all: it will show all types of closed wires and edges on the target surface. If a "face" subelement was selected in the previous step, a preview of a solid object extruded from the projection will be shown, depending on the value of Extrude height.
    • RadioButtonTrue.svg Show faces: it will show a preview of a filled face on the target surface. This will only work if you selected a "face" subelement in the previous step; if you selected a closed "wire", only the edges (no face) will be created as projection; if you selected "edges", only those edges will be created as projection.
    • RadioButtonTrue.svg Show edges: it will show a preview of the edges on the target surface. This will work whether you added a "face", "wire", or "edge" subelement in the previous step; even if you added a filled "face", only the edges will be created as projection.
  6. Press the OK to complete the operation and produce the new projection object.

Notes:

  • The projection direction is automatically taken from the camera direction in the 3D view at the moment the tool is launched.
  • To change the direction, move the camera, and press Get current camera direction.
  • Alternatively press the X:, Y:, or Z: buttons to set the projection direction to the main global axes, +X, -X, +Y, -Y, +Z, or -Z.
  • However, do notice that changing the projection direction won't automatically update the projection preview; in order to do this, you must re-select the geometry by pressing the Add... buttons and picking the subelements again.

Options

  • Extrude height: it is the height of the solid shape that is created by extruding the projected face, from the target surface and along the negative of the projection direction. For example, if the projection direction is along +Y (0, 1, 0), the extrusion will be created in the direction -Y (0, -1, 0). This solid extrusion will only be created if the subelement selected was a closed face, by pressing the Add face button, and by choosing the RadioButtonTrue.svg Show all option.
  • Solid depth: it is the distance that the projection object is moved along the projection direction. Negative values will displace the object in the opposite direction; this allows creating a projection that is offset from the target surface.

Limitations

The projection algorithm sometimes is not able to create a valid projection face. If this happens a solid extrusion won't be able to be created either.

If this happens:

  • Check if your source face is valid; try running the Part CheckGeometry.svg CheckGeometry tool for clues.
  • Check if the projection direction is valid. Can the source face be realistically projected onto the target surface? Would a straight projection hit the surface? Adjust the camera so that the source face is in front of the target surface, and try again.
  • Try to use the RadioButtonTrue.svg Show edges option. Are the edges projected correctly? Try to create a face with the edges by hand.

Links

Examples

Arrow-left.svg Previous: Part Thickness.svg Thickness
Next: Attachment Part EditAttachment.svg Arrow-right.svg