App Link/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Enfin, le PR (pull request) et la fusion ont eu lieu: * [https://forum.freecadweb.org/viewtopic.php?f=27&t=38621 App::Link: the big merge], vieux fil (Juillet 2019), [https://...")
No edit summary
 
(43 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 crées par script 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.

Un App Linkn est créé avec la méthode {{incode|addObject()}} du document.
{{Code|code=
import FreeCAD as App

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

== Lecture complémentaire ==

L'objet App Link a été a été introduit après 2 ans de développement et de prototypage. Ce composant a été pensé et développé presque à lui seul par l'utilisateur {{emphasis|realthunder}}. Les motivations et les implémentations de conception derrière ce projet sont décrites dans sa page GitHub, [https://github.com/realthunder/FreeCAD_assembly3/wiki/Link Link]. Afin de réaliser cette fonctionnalité, plusieurs modifications essentielles à FreeCAD ont été apportées. Celles-ci sont également largement documentés dans [https://github.com/realthunder/FreeCAD_assembly3/wiki/Core-Changes Core-Changes].

Le projet App Link a démarré une fois la refonte de l'[[PartDesign Workbench/fr|Atelier PartDesign]] fut terminée en v0.17. L'histoire d'App Link peut être reliée à certains fils de discussion essentiels du forum:
* [https://forum.freecadweb.org/viewtopic.php?f=19&t=21505 Why an object can only be inside one App::Part?] (Mars 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=21586 Introducing App::Link/XLink] (Mars 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=22216 Links] (Mai 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=23015 Realthunder Link implementation: Architecture discussion] (Juin 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=23419 PR #876: Link, stage one, context aware selection] (Juillet 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=23626 Preview: Link, stage two, API groundwork] (Juillet 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=20&t=25712 Assembly3 preview] (Décembre 2017)
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=29542 Merging of my Link branch] (Juin 2018)


Enfin, le PR (pull request) et la fusion ont eu lieu:
* [https://forum.freecadweb.org/viewtopic.php?f=27&t=38621 App::Link: the big merge], vieux fil (Juillet 2019), [https://github.com/FreeCAD/FreeCAD/pull/2350 pull request #2350] (la GRAND fusion), [https://github.com/realthunder/FreeCAD/tree/LinkMerge LinkMerge branch].
* [https://forum.freecadweb.org/viewtopic.php?f=8&t=37757 App::Link: the big merge], fil principal (Juillet 2019)
* [https://forum.freecadweb.org/viewtopic.php?p=329054#p329054 A simple path description of Link, 019, Link stage, Asm3, merge?] (Août 2019)
* [https://forum.freecadweb.org/viewtopic.php?f=17&t=39672 PR#2559: expose link and navigation actions], une introduction à la fonctionnalité Link en 0.19 (Septembre 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.