App Link/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Voir Part Feature pour plus d'informations.")
No edit summary
 
(48 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduction ==
== Introduction ==


[[File:Link.svg|32px]]
Un [[App_Link/fr|App Link]], ou formellement un {{incode|App::Link}}, est un élément qui renvoie une référence à un autre objet du document ou à un document externe. Cet objet a été introduit dans la version 0.19 afin de réutiliser des objets créés précédemment, ce qui est très utile pour créer des assemblages.


Un [[App_Link/fr|App Link]], ou formellement un {{incode|App::Link}}, est un type d'objet qui fait référence ou lie à un autre objet dans le même document ou dans un autre document. Il est spécialement conçu pour dupliquer efficacement un seul objet plusieurs fois, ce qui permet de créer des [[assembly/fr|assemblages]] complexes à partir de sous-assemblages plus petits et de plusieurs composants réutilisables tels que des vis, des écrous et des éléments de fixation similaires.
Lorsqu'une copie normale d'un objet est créée (par exemple avec [[Part SimpleCopy/fr|Part Copie simple]]), un nouvel objet complet avec sa forme topologique est dupliqué, ce qui consomme beaucoup de mémoire. App Link est utilisé pour réutiliser les données existantes d'un objet existant, il n'est donc pas nécessaire de créer un nouvel objet entier. Cela améliore la gestion des copies, en particulier dans le contexte d'assemblage mécanique où de nombreux doublons peuvent être nécessaires, ou lorsqu'il est nécessaire d'importer des assemblages plus petits dans des assemblages plus grands.


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

{{Caption|Diagramme simplifié des relations entre les objets centraux dans Freecad}}


== Utilisation ==
== Utilisation ==


Voir [[Std_LinkMake/fr#Utilisation|Std Créer un lien]].
* Les App Links peuvent être créés en appuyant sur {{Button|[[File:Std_LinkMake.svg|16px]] [[Std_LinkMake/fr|LinkMake]]}}.

Un [[App_Link/fr|App Link]] est un objet interne. Il est donc principalement destiné à être utilisé par les développeurs lors du développement d'établissements d'assemblage. Par exemple, les établis Assembly3 et Assembly4 utilisent cet objet. Voir [[External workbenches/fr|Ateliers externes]].


== Propriétés ==
== Propriétés ==


Voir [[Std_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]].
Voir [[Property/fr|Propriétés]] pour tous les types de propriétés que les objets scriptés peuvent avoir.

Un objet {{incode|App::Link}} n'est pas dérivé d'un [[Part_Feature/fr|Part Feature]], cependant, si le lien fait référence à un objet externe, il affichera les propriétés de ce dernier.

Ce sont les propriétés disponibles dans l'[[property editor/fr|Éditeur de propriétés]] pour un {{incode|App::Link}} vide.

=== Données ===

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

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

=== Vue ===

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

== Création de scripts ==

{{Emphasis|Voir aussi:}} [[FreeCAD Scripting Basics/fr|Débuter avec les scripts]] et [[scripted objects/fr|Objets créés par script]].

Voir [[Part_Feature/fr|Part Feature]] pour plus d'informations.

An App Link is created with the {{incode|addObject()}} method of the document.
{{Code|code=
import FreeCAD as App

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

== Lecture complémentaire ==

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/fr}}
{{Document_objects_navi{{#translation:}}}}
{{Userdocnavi/fr}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 09:04, 22 February 2022

Introduction

Un App Link, ou formellement un App::Link, est un type d'objet qui fait référence ou lie à un autre objet dans le même document ou dans un autre document. Il est spécialement conçu pour dupliquer efficacement un seul objet plusieurs fois, ce qui permet de créer des assemblages complexes à partir de sous-assemblages plus petits et de plusieurs composants réutilisables tels que des vis, des écrous et des éléments de fixation similaires.

Diagramme simplifié des relations entre les objets centraux dans Freecad

Utilisation

Voir Std Créer un lien.

Propriétés

Voir Std Créer un lien.