Part Offset2D/it: Difference between revisions

From FreeCAD Documentation
(Created page with "Part: Offset 2D")
 
No edit summary
 
(80 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>

{{Docnav/it
|[[Part_Offset/it|Offset 3D]]
|[[Part_Thickness/it|Spessore]]
|[[Part_Workbench/it|Part]]
|IconL=Part_Offset.svg
|IconR=Part_Thickness.svg
|IconC=Workbench_Part.svg
}}

{{GuiCommand/it
|Name=Part Offset2D
|Name/it=Part Offset 2D
|MenuLocation=Parte → Offset 2D...
|Workbenches=[[Part_Workbench/it|Part]]
|Version=0.17
|SeeAlso=[[Part_Offset/it|Part Offset 3D]], [[Part_Thickness/it|Part Spessore]], [[Draft_Offset/it| Draft Offset]]
}}

<span id="Description"></span>
==Descrizione==

Lo strumento [[Image:Part_Offset2D.svg|24px]] '''Part Offset 2D''' costruisce una polilinea, parallela alla polilinea originale, ad una certa distanza da essa. Oppure ingrandisce/rimpicciolisce una faccia planare, in modo simile.


La polilinea/faccia deve essere planare. In un oggetto ci possono essere più contorni, non necessariamente complanari.
{{GuiCommand|Name=Part Offset2D|MenuLocation=Part → 2D Offset|Workbenches=[[Part Module|Part]]|SeeAlso=[[Part_Offset|Part Offset]], [[Part_Thickness|Part Thickness]], [[Draft_Offset|Draft Offset]]}}


[[image:Part Offset2D Demo.png|600px]]
[[image:Part Offset2D Demo.png|600px]]


<span id="Usage"></span>
==Description==
==Utilizzo==
Part 2D Offset constructs a wire, parallel to the original wire, at a certain distance from it. Or enlarges/shrinks a planar face, similarly.


# Selezionare un oggetto da sfalsare.
The wire/face must be planar. There can be multiple wires in one object, not necessarily coplanar.
# Premere il pulsante {{Button|[[Image:Part_Offset2D.svg|16px]] [[Part_Offset2D/it|Offset 2D]]}}.
# Impostare l'offset nel [[Task_panel/it|Pannello Azioni]].
# Premere {{Button|OK}}.


<span id="Notes"></span>
==How to use==
==Note==
# Select an object to offset
# Invoke Part Offset2D command.
# Set up the offset in Task Panel, and accept the dialog.


* Gli oggetti [[App_Link/it|App Link]] collegati ai tipi di oggetto appropriati e i contenitori [[App_Part/it|App Part]] con gli oggetti visibili appropriati all'interno possono essere utilizzati anche come oggetti di origine. {{Version/it|0.20}}
A 2D Offset parametric object is created. Original objects are switched to wireframe display mode.


<span id="Known_issues"></span>
==Properties==
==Problemi noti==


* La maggior parte delle modalità non predefinite funziona solo con OCC 7.0.0 o superiori.
{{TitleProperty|Offset}}
* {{PropertyData|Source}}: Link to original shape


* Questo strumento può mandare in crash FreeCAD (vedere il punto successivo). In Windows, questi incidenti vengono convertiti in eccezioni e in genere non causano la chiusura di FreeCAD; su altri OS può capitare. Quindi, si consiglia di salvare i progetti prima di tentare di utilizzare lo strumento. Neanche le ellissi vengono gestite.
* {{PropertyData|Value}} The distance to enlarge the wire/face by. If negative, the wire/face is shrunk instead.


* Allargando delle facce con fori circolari di una quantità sufficiente a chiudere i fori, si verifica un crash (OCC 7.0.0). Il problema sembra essere specifico per cerchi; le altre forme sembrano chiudersi in modo corretto.
* {{PropertyData|Mode}} ("Pipe" or "Skin"): sets how non-closed wires are processed. If "Pipe", the wire is outlined as if it was an extremely thin closed contour. If "Skin", an open wire is created.


* Quando si applica l'offset a cerchi che hanno un posizionamento diverso da zero, il risultato può essere posizionato in modo sbagliato. (OCC 7.0.0)
[[image:Part Offset2D Mode.png|600px]]


* Quando si applica l'offset ai cerchi, a volte essi sono scalati in direzione inattesa (per esempio verso l'interno anziché verso l'esterno). (OCC 7.0.0)
* {{PropertyData|Join}} ("Arc", "Tangent", "Intersection"): sets the behavior around kinks. If "Arc", offset segments are connected with an arc of circle, centered at the vertex. "Tangent" is unsupported on OCC7.0.0. "Intersection": offset segments are extended till they intersect.


* Fill="true" non funziona quando si trattano collettivamente dei contorni aperti in modalità "Skin"
[[image:Part Offset2D Join.png|600px]]


* La modalità di unione "Tangent" non funziona (OCC 7.0.0)
* {{PropertyData|Intersection}} ("false", "true"): sets if multiple wires are treated collectively or independently. If "false", wires are offset independently, intersections between resulting wires are ignored. If "true", the wires are offset in collective manner.


* L'offeset di contorni composti da un singolo segmento non è supportato (perché un segmento non definisce un piano). I contorni composti da una singola linea non possono neanche essere trattati in un offset collettivo.
[[image:Part Offset2D Intersection.png|600px]]


<span id="Properties"></span>
Only wires within a compound are coupled. For example, if the structure is like compound(wire1, wire2, compound(wire3, wire4)), wire1 and wire2 will be treated collectively, but independently from wire3 and wire4. Likewise, wire3 and wire4 are treated collectively, but independently of wire1+wire2.
==Proprietà==


* {{PropertyData|Source}}: Link alla forma originale
Also, in collective mode, directions of wires are important, and influence direction of offset. This is in tight relationship with how holes in faces are treated.


* {{PropertyData|Value}}ː La distanza a cui allargare la faccia del contorno. Se è negativa, la faccia del contorno si restringe.
Wires being treated collectively must be coplanar. Wires being offset independently don't have to be coplanar.


* {{PropertyData|Mode}} ("Pipe" or "Skin"): Imposta il modo in cui vengono elaborati i contorni non chiusi. Se "Pipe", il contorno è delineato come se fosse un contorno chiuso estremamente sottile. Se "Skin", viene creato un contorno aperto.
* {{PropertyData|Fill}} ("false", "true"): if "true", the space between original wire/face and the offset is filled with a face.


[[image:Part Offset2D Fill.png|600px]]
:[[image:Part Offset2D Mode.png|600px]]


* {{PropertyData|Join}} ("Arc", "Tangent", "Intersection"): Imposta il comportamento nelle pieghe. Se "Arc", i segmenti dell'offset sono collegati con un arco di cerchio, centrato nel vertice. "Tangent" non è supportato con OCC7.0.0. "Intersection": i segmenti dell'offset sono estesi fino a quando non si intersecano.
==Known issues==


:[[image:Part Offset2D Join.png|600px]]
* Using the tool can crash FreeCAD (see next point). On Windows, these crashes are converted to exceptions and don't generally cause FreeCAD to close; on other OS'es it is not the case. So, it is advised to save project before attempting to use the tool.


* {{PropertyData|Intersection}} ("false", "true"): stabilisce se più contorni vengono trattati collettivamente o in modo indipendente. Se "false", i contorni sono trattati in modo indipendente, le intersezioni tra i contorni risultanti vengono ignorate. Se "true", i contorni sono trattati in modo collettivo.
* Enlarging faces with circular holes by an amount large enough to cause holes to close up, a crash occurs (OCC 7.0.0). The problem seems to be specific to circles; other shapes seem to close out properly.


:[[image:Part Offset2D Intersection.png|600px]]
* when offsetting circles that have non-zero Placement, the result is placed wrongly. (OCC 7.0.0)


:Sono accoppiati solo i contorni all'interno di un composto. Ad esempio, se la struttura è composto simile a (wire1, wire2, compound(wire3, wire4)), wire1 e wire2 sono trattati collettivamente, ma indipendentemente da wire3 e wire4. Allo stesso modo, wire3 e wire4 sono trattati collettivamente, ma indipendentemente da wire1+wire2.
* when offsetting circles, sometimes they are offset in unexpected direction (e.g. inward instead of outward). (OCC 7.0.0)


:Inoltre, in modalità collettiva, le direzioni dei contorni sono importanti, e la direzione influenza l'offset. Questo è in stretto rapporto con il modo in cui vengono trattati i fori nelle facce.
* Fill="true" doesn't work when collectively offsetting open wires in "Skin" mode


:I contorni da trattare collettivamente devono essere complanari. I contorni da trattare in modo indipendente possono anche non essere complanari.
* "Tangent" join mode doesn't work (OCC 7.0.0)


* {{PropertyData|Fill}} ("false", "true"): se "true", lo spazio tra la faccia del contorno primitivo e l'offset viene riempito con una faccia.
* Offsetting wires made of single line segment is not supported (because line segment doesn't define a plane). Single line segments cannot participate in collective offset either.


:[[image:Part Offset2D Fill.png|600px]]
==Scripting==


<span id="Scripting"></span>
The tool can by used in [[macros]] and from the python console by using the following function:
==Script==

Lo strumento può essere utilizzato nelle [[Macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando la seguente funzione:
{{code|code=
{{code|code=
f = App.ActiveDocument.addObject("Part::Offset2D", "Offset2D")
f = App.ActiveDocument.addObject("Part::Offset2D", "Offset2D")
Line 70: Line 99:
}}
}}


2D offset is also available as a method of Part.Shape. Example:
Offset 2D è anche disponibile come metodo di Part.Shape. Esempio:
{{code|code=
{{code|code=
import Part
import Part
Line 95: Line 124:
}}
}}


==Version==
The tool was introduced in FreeCAD v0.17.8350. Most of non-default modes will only work with OCC 7.0.0 or later.


{{Docnav/it
|[[Part_Offset/it|Offset 3D]]
|[[Part_Thickness/it|Spessore]]
|[[Part_Workbench/it|Part]]
|IconL=Part_Offset.svg
|IconR=Part_Thickness.svg
|IconC=Workbench_Part.svg
}}

{{Part Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}
<languages/>

Latest revision as of 17:27, 28 January 2024

Part Offset 2D

Posizione nel menu
Parte → Offset 2D...
Ambiente
Part
Avvio veloce
Nessuno
Introdotto nella versione
0.17
Vedere anche
Part Offset 3D, Part Spessore, Draft Offset

Descrizione

Lo strumento Part Offset 2D costruisce una polilinea, parallela alla polilinea originale, ad una certa distanza da essa. Oppure ingrandisce/rimpicciolisce una faccia planare, in modo simile.

La polilinea/faccia deve essere planare. In un oggetto ci possono essere più contorni, non necessariamente complanari.

Utilizzo

  1. Selezionare un oggetto da sfalsare.
  2. Premere il pulsante Offset 2D.
  3. Impostare l'offset nel Pannello Azioni.
  4. Premere OK.

Note

Problemi noti

  • La maggior parte delle modalità non predefinite funziona solo con OCC 7.0.0 o superiori.
  • Questo strumento può mandare in crash FreeCAD (vedere il punto successivo). In Windows, questi incidenti vengono convertiti in eccezioni e in genere non causano la chiusura di FreeCAD; su altri OS può capitare. Quindi, si consiglia di salvare i progetti prima di tentare di utilizzare lo strumento. Neanche le ellissi vengono gestite.
  • Allargando delle facce con fori circolari di una quantità sufficiente a chiudere i fori, si verifica un crash (OCC 7.0.0). Il problema sembra essere specifico per cerchi; le altre forme sembrano chiudersi in modo corretto.
  • Quando si applica l'offset a cerchi che hanno un posizionamento diverso da zero, il risultato può essere posizionato in modo sbagliato. (OCC 7.0.0)
  • Quando si applica l'offset ai cerchi, a volte essi sono scalati in direzione inattesa (per esempio verso l'interno anziché verso l'esterno). (OCC 7.0.0)
  • Fill="true" non funziona quando si trattano collettivamente dei contorni aperti in modalità "Skin"
  • La modalità di unione "Tangent" non funziona (OCC 7.0.0)
  • L'offeset di contorni composti da un singolo segmento non è supportato (perché un segmento non definisce un piano). I contorni composti da una singola linea non possono neanche essere trattati in un offset collettivo.

Proprietà

  • DatiSource: Link alla forma originale
  • DatiValueː La distanza a cui allargare la faccia del contorno. Se è negativa, la faccia del contorno si restringe.
  • DatiMode ("Pipe" or "Skin"): Imposta il modo in cui vengono elaborati i contorni non chiusi. Se "Pipe", il contorno è delineato come se fosse un contorno chiuso estremamente sottile. Se "Skin", viene creato un contorno aperto.
  • DatiJoin ("Arc", "Tangent", "Intersection"): Imposta il comportamento nelle pieghe. Se "Arc", i segmenti dell'offset sono collegati con un arco di cerchio, centrato nel vertice. "Tangent" non è supportato con OCC7.0.0. "Intersection": i segmenti dell'offset sono estesi fino a quando non si intersecano.
  • DatiIntersection ("false", "true"): stabilisce se più contorni vengono trattati collettivamente o in modo indipendente. Se "false", i contorni sono trattati in modo indipendente, le intersezioni tra i contorni risultanti vengono ignorate. Se "true", i contorni sono trattati in modo collettivo.
Sono accoppiati solo i contorni all'interno di un composto. Ad esempio, se la struttura è composto simile a (wire1, wire2, compound(wire3, wire4)), wire1 e wire2 sono trattati collettivamente, ma indipendentemente da wire3 e wire4. Allo stesso modo, wire3 e wire4 sono trattati collettivamente, ma indipendentemente da wire1+wire2.
Inoltre, in modalità collettiva, le direzioni dei contorni sono importanti, e la direzione influenza l'offset. Questo è in stretto rapporto con il modo in cui vengono trattati i fori nelle facce.
I contorni da trattare collettivamente devono essere complanari. I contorni da trattare in modo indipendente possono anche non essere complanari.
  • DatiFill ("false", "true"): se "true", lo spazio tra la faccia del contorno primitivo e l'offset viene riempito con una faccia.

Script

Lo strumento può essere utilizzato nelle macro e dalla console Python utilizzando la seguente funzione:

f = App.ActiveDocument.addObject("Part::Offset2D", "Offset2D")
f.Source =  #some object
f.Value = 10.0

Offset 2D è anche disponibile come metodo di Part.Shape. Esempio:

import Part
circle = Part.Circle().toShape()
enlarged_circle = circle.makeOffset2D(10.0)
Part.show(circle)
Part.show(enlarged_circle)
# makeOffset2D(offset, join = 0, fill = False, openResult = false, intersection = false)
# 
# * offset: distance to expand the shape by. 
# 
# * join: method of offsetting non-tangent joints. 0 = arcs, 1 = tangent, 2 =
# intersection
# 
# * fill: if true, the output is a face filling the space covered by offset. If
# false, the output is a wire/face.
# 
# * openResult: True for "Skin" mode; False for Pipe mode. 
# 
# * intersection: collective offset
# 
# Returns: result of offsetting (wire or face or compound of those). Compounding
# structure follows that of source shape.