App Link/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(26 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduzione ==
== Introduzione ==
Line 5: Line 6:
[[File:Link.svg|32px]]
[[File:Link.svg|32px]]


Un [[App_Link/it|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.


[[File:FreeCAD_core_objects.svg|800px]]
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.

{{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}}:

== Inheritance ==

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

{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|App::Link}} object is a core component of the system, it does not depend on any workbench, but it can be used with most objects created in all workbenches.}}

== 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"
}}

== Ulteriori letture ==

L'oggetto App Link è stato introdotto dopo 2 anni di sviluppo e prototipazione. Questo componente è stato pensato e sviluppato quasi da solo dall'utente {{Emphasis|realthunder}}. Le motivazioni e le implementazioni progettuali alla base di questo progetto sono descritte nella sua pagina GitHub, [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link Link]. Per realizzare questa funzione, sono state apportate diverse modifiche fondamentali a FreeCAD; anche queste sono state ampiamente documentati in [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes].

Il progetto App Link è iniziato dopo che la riprogettazione di [[PartDesign Workbench/it|PartDesign]] è stata completata nella versione 0.17. La cronologia di App Link può essere ricostruita dalle discussioni nel forum:
* [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)


Alla fine, sono avvenute la richiesta di pull e l'unione:
* [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/it}}
{{Document_objects_navi{{#translation:}}}}
{{Userdocnavi/it}}
{{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.