Draft Upgrade: Difference between revisions
No edit summary |
(Marked this version for translation) |
||
Line 1: | Line 1: | ||
<translate> |
<translate> |
||
<!--T:1--> |
|||
{{GuiCommand|Name=Draft Upgrade|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Upgrade|Shortcut=U P|SeeAlso=[[Draft Downgrade]]}} |
{{GuiCommand|Name=Draft Upgrade|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Upgrade|Shortcut=U P|SeeAlso=[[Draft Downgrade]]}} |
||
==Description== |
==Description== <!--T:2--> |
||
<!--T:3--> |
|||
This tool upgrades selected objects in different ways. If no object is selected, you will be invited to select one. |
This tool upgrades selected objects in different ways. If no object is selected, you will be invited to select one. |
||
Line 10: | Line 12: | ||
<translate> |
<translate> |
||
==How to use== |
==How to use== <!--T:4--> |
||
<!--T:5--> |
|||
# Select one or more objects you wish to upgrade |
# Select one or more objects you wish to upgrade |
||
# Press the {{KEY|[[Image:Draft Upgrade.png|16px]] [[Draft Upgrade]]}} button or press {{KEY|U}} then {{KEY|P}} keys |
# Press the {{KEY|[[Image:Draft Upgrade.png|16px]] [[Draft Upgrade]]}} button or press {{KEY|U}} then {{KEY|P}} keys |
||
==Options== |
==Options== <!--T:6--> |
||
<!--T:7--> |
|||
The selected objects are modified/upgraded according to the following conditions (in order): |
The selected objects are modified/upgraded according to the following conditions (in order): |
||
* if there are more than one face in the selection, the faces are merged (union) |
* if there are more than one face in the selection, the faces are merged (union) |
||
Line 24: | Line 28: | ||
* if none of the above is possible, a compound object is created |
* if none of the above is possible, a compound object is created |
||
==Scripting== |
==Scripting== <!--T:8--> |
||
<!--T:9--> |
|||
The upgrade tool can be used from python scripts and [[macros]] like this: |
The upgrade tool can be used from python scripts and [[macros]] like this: |
||
Line 34: | Line 39: | ||
<translate> |
<translate> |
||
<!--T:10--> |
|||
* Upgrades the given object(s) (can be an object or a list of objects). |
* Upgrades the given object(s) (can be an object or a list of objects). |
||
* If delete is True, old objects are deleted. |
* If delete is True, old objects are deleted. |
||
Line 39: | Line 45: | ||
* Returns a dictionnary containing two lists, a list of new objects and a list of objects to be deleted |
* Returns a dictionnary containing two lists, a list of new objects and a list of objects to be deleted |
||
<!--T:11--> |
|||
Some of the operations of the Upgrade tool can also be made with the [[Part Fuse]] or [[Draft Wire]] tools. |
Some of the operations of the Upgrade tool can also be made with the [[Part Fuse]] or [[Draft Wire]] tools. |
||
<!--T:12--> |
|||
Example: |
Example: |
||
Revision as of 16:20, 13 February 2014
Draft Upgrade |
Menu location |
---|
Draft -> Upgrade |
Workbenches |
Draft, Arch |
Default shortcut |
U P |
Introduced in version |
- |
See also |
Draft Downgrade |
Description
This tool upgrades selected objects in different ways. If no object is selected, you will be invited to select one.
How to use
- Select one or more objects you wish to upgrade
- Press the Draft Upgrade button or press U then P keys
Options
The selected objects are modified/upgraded according to the following conditions (in order):
- if there are more than one face in the selection, the faces are merged (union)
- if there is only one face in the selection, nothing is done
- if there is only one open wire in the selection, it gets closed
- if there are only edges in the selection, all edges are joined into a wire (closed if possible)
- if none of the above is possible, a compound object is created
Scripting
The upgrade tool can be used from python scripts and macros like this:
Draft.upgrade(objects, delete=False, force=None)
- Upgrades the given object(s) (can be an object or a list of objects).
- If delete is True, old objects are deleted.
- The force attribute can be used to force a certain way of upgrading. It can be: makeCompound, closeGroupWires, makeSolid, closeWire, turnToParts, makeFusion, makeShell, makeFaces, draftify, joinFaces, makeSketchFace, makeWires
- Returns a dictionnary containing two lists, a list of new objects and a list of objects to be deleted
Some of the operations of the Upgrade tool can also be made with the Part Fuse or Draft Wire tools.
Example:
import Draft
mycircle = Draft.makeCircle(2)
face1 = Draft.upgrade([mycircle],True)