Part ProjectionOnSurface: Difference between revisions

From FreeCAD Documentation
(Better description of the usage.)
(More information on the projection direction)
Line 48: Line 48:
#* {{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.
#* {{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.
#* {{Button|Add edge}}: select a source edge. The tool will only project the selected edge.
#* {{Button|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|3D view]]. If you wish to deselect it, hold {{Button|Ctrl}} and pick the same element again.
#* 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.
#* When you are satisfied with your selection, press the same {{Button|Add ...}} button again.
#* When you are satisfied with your selection, press the same {{Button|Add...}} button to leave the selection mode.
# Then click on the specific radiobutton to choose the type of projection shape to create.
# Then click on the specific radiobutton to choose the type of projection shape to create.
#* {{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.
#* {{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}}.
#* {{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 will be created as projection; if you selected "edges", only those edges will be created as projection.
#* {{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.
#* {{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 "face", only the edges will be created as projection.
#* {{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.
# Press the {{Button|OK}} to complete the operation and produce the new projection object.
# Press the {{Button|OK}} to complete the operation and produce the new projection object.


Notes:
Notes:
* The projection direction is automatically taken from the camera direction in the [[3D_view|3D view]] at the moment the tool is launched.
# Extrude height is the value the solid is extrude along the reversed projection direction.
* To change the direction, move the camera, and press {{Button|Get current camera direction}}. However, this 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.
# Solid depth is the value the projection object is moved along the projection 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.
# The projection direction
#* When entering the function, the current camera direction is used for the projection direction
#* To change the direction, use the camera direction to get your projection direction and press "Get current camera direction"
#* Or press {{KEY|X:}},{{KEY|Y:}},{{KEY|Z:}} to toggle the direction x=1,x=-1,y=1,y=-1,z=1,z=-1


==Options== <!--T:10-->
==Options== <!--T:10-->

# Extrude height is the value the solid is extrude along the reversed projection direction.
# Solid depth is the value the projection object is moved along the projection direction.


<!--T:11-->
<!--T:11-->

Revision as of 02:26, 17 August 2020

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.


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 is used to project a Shape on top of a surface from another Shape; this can be used to project a logo or text message (see Draft ShapeString) onto curved surfaces to create interesting effects.

This tool can project the entire face, or only a wire or edge of a Shape. The result can be a new face or wire on the surface, or even a projection solid, which can be used in a boolean cut.

Projection 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 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.
    • 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.
    • 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: 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. However, this 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.
  • 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.

Options

  1. Extrude height is the value the solid is extrude along the reversed projection direction.
  2. Solid depth is the value the projection object is moved along the projection direction.
  1. Extrude height
    • The height value a valid projection solid is extruded along the reversed projection direction
  2. Solid depth
    • The depth value a valid projection object is moved along the projection direction
  3. 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

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

If this happens:

  1. Check if your starting face is valid.
  2. Check if the projection direction is valid. (Can the face be projected to surface? Or does it not hit the surface?)
  3. Try to use the "Show edges" option. Are the edges projected well? Try to create a face with the edges by hand.

Links

Examples