App Link/it: Difference between revisions

From FreeCAD Documentation
(Created page with "Un App Link viene creato con il metodo {{incode|addObject()}} del documento.")
No edit summary
 
(35 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduzione ==
== Introduzione ==


[[File:Link.svg|32px]]
Un [[App_Link|App Link]], o formalmente un {{incode|App::Link}}, è un elemento che restituisce un riferimento a un altro oggetto nel documento o in un documento esterno. Questo oggetto è stato introdotto in v0.19 per riutilizzare oggetti precedentemente creati, che è molto utile per creare assiemi.


Un [[App_Link/it|App Link]], o formalmente un {{incode|App::Link}}, è un tipo di oggetto che fa riferimento o si collega a un altro oggetto, nello stesso documento o in un altro documento. È appositamente progettato per duplicare in modo efficiente un singolo oggetto più volte, il che aiuta nella creazione di [[assembly/it|assemblaggi]] complessi da sottoassiemi più piccoli e da più componenti riutilizzabili come viti, dadi e dispositivi di fissaggio simili.
Quando viene creata una copia regolare di un oggetto (ad esempio, con [[Part SimpleCopy/it|Crea una copia semplice]] di Part), viene duplicato un intero nuovo oggetto con la sua forma topologica, che consuma molta memoria. App Link viene utilizzato per riutilizzare i dati esistenti di un oggetto esistente, quindi non è necessario creare un intero nuovo oggetto; ciò migliora la gestione delle copie, in particolare nel contesto dell'assemblaggio meccanico in cui possono essere necessari molti duplicati o dove è richiesta l'importazione di assiemi più piccoli in assiemi più grandi.


[[File:Link.svg|32px]]
[[File:FreeCAD_core_objects.svg|800px]]

{{Caption|Diagramma semplificato delle relazioni tra gli oggetti principali in FreeCAD}}


== Utilizzo ==
== Utilizzo ==


* App Link può essere creato premendo {{Button|[[File:Std_LinkMake.svg|16px]] [[Std_LinkMake/it|Crea link]]}}.
Vedere la pagina [[Std_LinkMake/it#Utilizzo|Crea link]].

Un [[App_Link/it|App Link]] è un oggetto interno, quindi è principalmente destinato all'uso da parte degli sviluppatori durante lo sviluppo di ambienti di lavoro di assemblaggio. Ad esempio, Assembly3 e Assembly4 utilizzano questo oggetto. Vedere [[External workbenches/it|Ambienti esterni]].


== Proprietà ==
== Proprietà ==


Vedere [[Std_LinkMake/it#Proprietà|Crea link]].
Vedere [[Property/it|Proprietà]] per tutti i tipi di proprietà che possono avere gli oggetti con script.

Un oggetto {{incode|App::Link}} non deriva da una [[Part_Feature/it|Part Feature]], tuttavia, se il collegamento ha un riferimento a un oggetto esterno, mostra le proprietà di quest'ultimo oggetto.

Queste sono le proprietà disponibili nell'[[property editor/it|editor delle proprietà]] per un {{incode|App::Link}} vuoto.

=== Dati ===

{{TitleProperty|Link}}
* {{PropertyData|Linked Object}}:
* {{PropertyData|Link Transform}}:
* {{PropertyData|Placement}}:
* {{PropertyData|Show Element}}:
* {{PropertyData|Element Count}}:
* {{PropertyData|Scale}}:

{{TitleProperty|Base}}
* {{PropertyData|Label}}:

===Vista===

{{TitleProperty|Link}}
* {{PropertyView|Draw Style}}:
* {{PropertyView|Line Width}}:
* {{PropertyView|Override Material}}:
* {{PropertyView|Point Size}}:
* {{PropertyView|Selectable}}:
* {{PropertyView|Shape Material}}:

{{TitleProperty|Base}}
* {{PropertyView|On Top When Selected}}:
* {{PropertyView|Selection Style}}:
* {{PropertyView|Show In Tree}}:
* {{PropertyView|Visibility}}:

== Script ==

{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]], e [[scripted objects/it|script di oggetti]].

Vedere [[Part_Feature/it|Part Feature]] per le informazioni generali.

Un App Link viene creato con il metodo {{incode|addObject()}} del documento.
{{Code|code=
import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::Link", "Name")
obj.Label = "Custom label"
}}

== Further reading ==

The App Link object was introduced after 2 years of development and prototyping. This component was thought and developed almost single-handedly by user {{Emphasis|realthunder}}. The motivations and design implementations behind this project are described in his GitHub page, [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link Link]. In order to accomplish this feature, several core changes to FreeCAD were made; these were also extensively documented in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes].

The App Link project started after the redesign of the [[PartDesign Workbench|PartDesign Workbench]] was complete in v0.17. The history of App Link can be traced to some essential forum threads:
* [https://forum.freecadweb.org/viewtopic.php?f=19&t=21505 Why an object can only be inside one App::Part?] (March 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=21586 Introducing App::Link/XLink] (March 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=22216 Links] (May 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=23015 Realthunder Link implementation: Architecture discussion] (June 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=23419 PR #876: Link, stage one, context aware selection] (July 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=23626 Preview: Link, stage two, API groundwork] (July 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=25712 Assembly3 preview] (December 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=29542 Merging of my Link branch] (June 2018)


Finally, the pull request and merge happened:
* [https://forum.freecadweb.org/viewtopic.php?f=27&t=38621 App::Link: the big merge], old thread (July 2019), [https://github.com/FreeCAD/FreeCAD/pull/2350 pull request #2350] (the BIG merge), [https://github.com/realthunder/FreeCAD/tree/LinkMerge LinkMerge branch].
* [https://forum.freecadweb.org/viewtopic.php?f=8&t=37757 App::Link: the big merge], main thread (July 2019)
* [https://forum.freecadweb.org/viewtopic.php?p=329054#p329054 A simple path description of Link, 019, Link stage, Asm3, merge?] (August 2019)
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=39672 PR#2559: expose link and navigation actions], an introduction to the Link feature in 0.19 (September 2019).


{{Std_Base_navi{{#translation:}}}}
{{Std Base}}
{{Document_objects_navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 22:33, 27 September 2022

Introduzione

Un App Link, o formalmente un App::Link, è un tipo di oggetto che fa riferimento o si collega a un altro oggetto, nello stesso documento o in un altro documento. È appositamente progettato per duplicare in modo efficiente un singolo oggetto più volte, il che aiuta nella creazione di assemblaggi complessi da sottoassiemi più piccoli e da più componenti riutilizzabili come viti, dadi e dispositivi di fissaggio simili.

Diagramma semplificato delle relazioni tra gli oggetti principali in FreeCAD

Utilizzo

Vedere la pagina Crea link.

Proprietà

Vedere Crea link.