Std LinkMake/fr

Other languages:
Groupe
Créer un sous-lien
Std Base

Std Créer un lien

Emplacement du menu
Aucun
Ateliers
Tous
Raccourci par défaut
Aucun
Introduit dans la version
0.19
Voir aussi
Std Part, Std Groupe, PartDesign Corps

Description

Std Créer un lien crée une classe App Link, un type d'objet faisant référence ou lié à 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.

L'objet App Link a été introduit dans la v0.19. Auparavant, une simple duplication d'objets pouvait être réalisée avec Draft Cloner, mais c'est une solution moins efficace en raison de son implémentation qui crée essentiellement une copie de la forme interne de l'objet source. Au lieu de cela, un lien fait directement référence à la forme d'origine, ce qui permet d'économiser de la mémoire.

En lui-même, l'objet Link peut se comporter comme un réseau dupliquant son objet de base plusieurs fois. Cela peut être fait en définissant sa propriété DonnéesElement Count sur 1 ou plus. Cet objet « Link Array » peut également être créé avec les différents outils de réseau de l' atelier Draft, par exemple Draft Réseau orthogonal, Draft Réseau polaire et Draft Réseau circulaire.

Lorsqu'ils sont utilisés avec l' atelier PartDesign, les liens sont destinés à être utilisés avec PartDesign Corps. Il est recommandé de mettre VueDisplay Mode Body sur Tip pour sélectionner les fonctions du corps entier et non chacun des fonctions. Pour créer des réseaux de PartDesign Fonctions internes, utilisez PartDesign Répétition linéaire, PartDesign Répétition circulaire et PartDesign Transformation multiple.

L'outil Std Créer un lien n'est pas défini par un atelier particulier, mais par le système de base, il se trouve donc dans la barre d'outils de structure, disponible dans tous les ateliers.

Utilisation

Avec sélection :

  1. Sélectionnez un objet dans l'arborescence ou la vue 3D pour lequel vous souhaitez créer un lien.
  2. Appuyez sur le bouton Std Créer un lien. L'objet créé a la même icône que l'objet d'origine mais a une flèche superposée indiquant qu'il s'agit d'un lien.

Sans sélection :

  1. Si aucun objet n'est sélectionné, appuyez sur le bouton Std Créer un lien pour créer un lien vide.
  2. Allez dans l'éditeur de propriétés, puis cliquez sur la propriété DonnéesLinked Object pour ouvrir la fenêtre de dialogue de sélection des liens pour choisir un objet, puis appuyez sur OK .
  3. Au lieu de choisir un objet entier dans l'arborescence, vous pouvez également choisir des sous-éléments (sommets, arêtes ou faces) d'un seul objet dans la vue 3D. Dans ce cas, le lien dupliquera uniquement ces sous-éléments et la superposition de flèches sera différente. Cela peut également être fait avec Std Créer un sous-lien.

(1) Un objet
(2) Un lien vide
(3) Un lien complet vers le premier objet (avec un matériau rajouté)
(4) Un lien vers seulement quelques sous-éléments de l'objet. Le lien vide n'est pas lié à l'objet réel et n'est donc pas affiché dans la vue 3D.

Utilisation : documents externes

  1. Commencez par un document contenant au moins un objet qui sera la source du lien.
  2. Ouvrez un nouveau document ou un document existant. Pour une manipulation plus facile, utilisez Std Arborescence Tous les documents pour afficher les deux documents dans l'arborescence. Avant de continuer, sauvegarder les deux documents. Le lien ne pourra pas trouver sa source et sa cible à moins que les deux documents ne soient enregistrés sur le disque.
  3. Dans le premier document, sélectionnez l'objet que vous souhaitez lier, puis changez d'onglet dans la zone de vue principale pour passer au deuxième document.
  4. Appuyez sur Std Créer un lien. L'objet produit a la même icône que l'objet d'origine mais a une flèche superposée indique qu'il s'agit d'un lien provenant d'un document externe.

Remarques :

(1, 2) Deux objets d'un document source liés à un document cible
(3) Un lien vers le deuxième lien (avec un matériau rajouté)
(4) Un lien vers les sous-éléments du deuxième lien

Glisser-déposer

Au lieu de changer d'onglet de document, vous pouvez créer des liens en effectuant une opération de glisser-déposer dans l'arborescence : sélectionnez l'objet source dans le premier document, faites-le glisser, puis déposez-le dans le nom du second document tout en maintenant la touche Alt du clavier.

Le glisser-déposer entraîne différentes actions en fonction de la touche de modification enfoncée.

Pour les modificateurs Ctrl et Alt, le glisser-déposer peut également être effectué avec un seul document. Autrement dit, faire glisser un objet et le déposer dans le même nom de document peut être utilisé pour créer plusieurs copies ou plusieurs liens vers celui-ci.

Copier en cas de modification

La fonction Copier en cas de modification permet à un lien de commencer comme une référence légère, puis de se séparer en un objet indépendant lorsque des modifications spécifiques sont apportées. Cela suit la philosophie « copy-on-write » (copie à l'écriture), garantissant que les variantes ne consomment de la mémoire et de l'espace disque que lorsqu'elles divergent réellement de l'original (voir l'annonce sur le forum FreeCAD).

Sélection des propriétés

Pour que ce mécanisme fonctionne, certaines propriétés de l'objet source doivent être marquées comme pouvant être copiées.

Processus de travail

Le comportement du lien est contrôlé par sa propriété DonnéesLinkCopyOnChange :

Ces instances de liens forquées sont parfois appelées Variant Links. Elles peuvent éventuellement être associées à une feuille de calcul pour utiliser des tables de configuration.

Le statut de la propriété DonnéesLinkCopyOnChange peut être modifié dans l'interface utilisateur de deux manières différentes :

Configurer l'objet configurable

L'utilisateur peut contrôler précisément quels objets et dépendances copier lors de la création de la variante :

  1. Cliquez avec le bouton droit sur le lien avec DonnéesLinkCopyOnChange défini sur Enabled.
  2. Sélectionnez l'entrée du menu contextuel Configurer l'objet configurable.
  3. Une boîte de dialogue s'affiche pour vous permettre de choisir l'objet à copier, afin d'exclure éventuellement les objets dépendants ou non pertinents de la copie.

Masquer des propriétés

Si un lien doit avoir une valeur différente de celle de sa source pour une propriété spécifique (même si « CopyOnChange » n'est pas utilisé), un ajout manuel peut être effectué, la propriété d'origine étant alors masquée par un remplacement.

Si un lien possède une propriété dont le nom et le type sont exactement identiques à ceux de son objet source, le lien privilégiera sa propre valeur locale et cessera de lire à partir de la source. (voir discussion sur le forum FreeCAD).

Comment créer un ajout dans l'interface utilisateur :

  1. Sélectionnez le lien dans l'arborescence.
  2. Cliquez avec le bouton droit n'importe où dans l'éditeur de propriétés et sélectionnez Ajouter une propriété.
  3. Choisissez Type et entrez le nom correspondant à la propriété que vous souhaitez remplacer.
  4. La propriété apparaîtra désormais dans la liste des liens avec sa propre valeur indépendante. Elle n'apparaîtra plus en vert dans l'éditeur de propriétés, afin d'indiquer ce nouvel état.

Avec cette ajout, les liens peuvent toujours se comporter comme des références légères sans déclencher de copie profonde. Cependant, ils peuvent utiliser de manière sélective leurs propres propriétés indépendantes, déconnectées de l'objet source.

Processus de travail prototype

Pour les projets qui nécessitent des liens variants, une structure à deux niveaux est recommandée :

  1. The inventory (prototypes) : créez un groupe à la racine de votre document qui servira d'inventaire. Placez-y vos pièces de base. Si vous avez besoin d'une variante (par exemple, une vis d'une longueur différente), créez un lien vers la pièce de base, définissez sa DonnéesLinkCopyOnChange sur Enabled (ou Owned), puis modifiez la longueur. Ce lien est le prototype.
  2. The Instances : utilisez des liens normaux (DonnéesLinkCopyOnChange=Disabled) qui pointent vers les prototypes pour les placer dans le modèle.

Cela présente les avantages suivants :

Groupes

Std Créer un lien peut être utilisé avec des objets Std Part afin de dupliquer rapidement des groupes d'objets positionnés dans l'espace, c'est-à-dire assemblages.

Lien créé à partir d'un Std Part. Les objets ne sont pas dupliqués mais ils sont répertoriés sous le conteneur d'origine et sous le conteneur Link.

Un Std Groupe standard ne possède pas de propriété DonnéesPlacement, il ne peut donc pas contrôler la position des objets qu'il contient. Cependant, lorsque Std Créer un lien est utilisé avec Std Groupe, le lien résultant se comporte essentiellement comme un Std Part et peut également être déplacé dans l'espace.

Lien créé à partir d'un Std Groupe. Les objets ne sont pas dupliqués mais ils sont répertoriés sous le conteneur d'origine et sous le conteneur Link. Le lien (avec un matériau rajouté) peut être déplacé dans l'espace, tout comme un Std Part.

Un lien vers un Std Part gardera la visibilité des objets synchronisée avec le Part d'origine. Donc si vous masquez un objet dans un lien, il sera masqué dans tous les liens et dans l'objet d'origine. D'un autre côté, un lien vers un Std Groupe permettra un contrôle indépendant des visibilités.

À gauche : un Std Part avec deux objets et deux liens vers le Part. La visibilité des objets est synchronisée.
À droite : un Std Groupe avec deux objets et deux liens vers le groupe. La visibilité des objets est contrôlée indépendamment dans chaque groupe.

Contrôler l'apparence

Lorsqu'un lien est créé, par défaut VueOverride Material est false, donc le lien aura la même apparence que l'original DonnéesLinked Object.

Lorsque VueOverride Material est défini sur true, la propriété VueShape Material contrôlera désormais l'apparence du lien.

Quel que soit l'état de VueOverride Material, il est possible de définir l'apparence de chacun des sous-éléments (sommets, arêtes, faces) d'un lien.

  1. Sélectionnez le lien dans l'arborescence. Ouvrez le menu contextuel (clic droit) et choisissez Remplacer des couleurs.
  2. Choisissez maintenant chacun des sous-éléments que vous voulez dans la vue 3D, appuyez sur Éditer et modifiez les propriétés, y compris la transparence.
  3. Pour supprimer les attributs personnalisés, sélectionnez les éléments dans la liste et appuyez sur Supprimer.
  4. Lorsque vous êtes satisfait du résultat, appuyez sur OK pour fermer la fenêtre de dialogue.

Remarque : à partir de la v0.19, la mise en couleur des sous-éléments est soumise au problème de dénomination topologique. Elle doit être effectuée comme dernière étape de modélisation lorsque le modèle n'est plus sensé être modifié.

(1) L'objet d'origine
(2) Un lien avec un matériau rajouté
(3) Un deuxième lien avec chacun des sous-éléments modifiés

Réseau de liens

Voir aussi : Draft Réseau orthogonal.

Lorsqu'un lien est créé, par défaut, DonnéesElement Count vaut 0, donc un seul objet Link sera visible dans l'arborescence.

Étant donné que DonnéesShow Element est true par défaut, lorsque DonnéesElement Count vaut 1 ou plus, automatiquement plus de liens seront créés sous le premier. Chaque nouveau lien peut être placé à la position souhaitée en modifiant sa propre propriété DonnéesPlacement.

De la même manière, chaque élément du réseau peut avoir sa propre apparence modifiée, soit par les propriétés VueOverride Material et VueShape Material, soit en utilisant le menu Remplacer des couleurs sur l'ensemble du réseau puis en sélectionnant des faces une par une. Ceci est décrit dans Contrôler l'apparence.

(1) Objet d'origine
(2, 3, 4) Un réseau de liens avec trois éléments, chacun dans une position différente. Le premier lien a un matériau rajouté et des faces transparentes, les deux autres ont des couleurs de face personnalisées.

Une fois que vous êtes satisfait de l'emplacement et des propriétés des éléments Link dans le réseau, vous pouvez changer DonnéesShow Element par false afin de masquer chaque lien dans l'arborescence. Cela présente l'avantage de rendre le système plus réactif, en particulier si votre document contient de nombreux objets.

Lors de la création de ce type de réseau de liens, vous devez placer chacun des éléments manuellement. Cependant, si vous souhaitez utiliser des modèles spécifiques pour placer les copies, vous pouvez utiliser les outils de réseau de l' atelier Draft, comme Draft Réseau orthogonal, Draft Réseau polaire et Draft Réseau circulaire. Ces commandes peuvent créer des copies normales ou des copies de lien selon les options au moment de la création.

Visibilité

Lorsque DonnéesShow Element vaut true et que chaque élément est répertorié dans l'arborescence dans un réseau de liens, chaque lien peut être affiché ou masqué par en appuyant sur la barre Espace du clavier.

Une autre façon de masquer les éléments individuellement consiste à utiliser le menu Remplacer des couleurs.

  1. Sélectionnez le réseau, ouvrez le menu Remplacer des couleurs (clic droit).
  2. Dans la vue 3D, choisissez n'importe quel sous-élément à partir de n'importe quel lien du réseau.
  3. Appuyez sur Caché. Une icône représentant un œil devrait apparaître, indiquant que cet élément a été masqué de la vue 3D. L'objet s'affichera temporairement lorsque le curseur survolera l'icône .
  4. Vous pouvez cliquer sur OK pour confirmer l'opération et fermer la fenêtre de dialogue. Le lien restera caché même s'il est affiché comme visible dans l'arborescence.

Fenêtre de dialogue des couleurs des éléments disponibles lors de l'ouverture du menu contextuel d'un objet Link dans l'arborescence.

Si vous souhaitez restaurer la visibilité de cet élément du réseau, entrez à nouveau dans la fenêtre de dialogue, choisissez l'icône en forme d'œil, puis cliquez sur Supprimer pour supprimer l'état caché et cliquez sur OK pour confirmer et fermez la fenêtre de dialogue. L'élément sera à nouveau visible dans vue 3D.

Lorsque le lien est pour un Std Part ou un Std Groupe, le menu Remplacer des couleurs fonctionne de la même manière qu'avec les réseaux. Il permet de contrôler la couleur de la face, la couleur de l'objet entier et la visibilité des objets du groupe.

Un Std Part contenant trois objets et un lien vers cette pièce :
(1) Le premier objet est rendu invisible.
(2) Le deuxième objet a des sous-éléments avec des couleurs différentes.
(3) Le troisième objet entier a une couleur et un niveau de transparence différents.

Propriétés

Un App Link (classe App::Link) est dérivé de App DocumentObject (classe App::DocumentObject). Il a donc les propriétés de base de ce dernier comme DonnéesLabel et DonnéesLabel2.

Voici les propriétés spécifiques disponibles dans l'éditeur de propriétés. Les propriétés masquées peuvent être affichées en utilisant la commande Afficher les propriétés cachées dans le menu contextuel de l'éditeur de propriétés.

Voir Part Feature pour une explication des propriétés énumérées ci-dessous.

Données

Link

Base

L'objet App Link affichera en plus les propriétés de l'objet lié DonnéesLinked Object d'origine, ainsi l'éditeur de propriétés peut avoir des groupes de propriétés comme Attachment, Box, Draft, etc.

Vues

Link

Base

Options d'affichage

Selection

Il montrera en outre les propriétés de vue de l'original DonnéesLinked Object.

Héritage

Un App Link est formellement une instance de la classe App::Link, dont le parent est l'objet de base App DocumentObject (classe App::DocumentObject). Il s'agit d'un objet de très bas niveau, qui peut être utilisé avec la plupart des autres objets des documents.

Schéma simplifié des relations entre les objets principaux du programme. L'objet App::Link est un composant central du système, il ne dépend d'aucun atelier, mais il peut être utilisé avec la plupart des objets créés dans tous les ateliers.

Script

Voir aussi : Débuter avec les scripts et Objets créés par script.

Voir Part Feature pour plus d'informations.

Un lien d'application est créé avec la méthode addObject() du document. Il peut définir son DonnéesLinked Object en remplaçant son attribut LinkedObject, ou en utilisant sa méthode setLink. 

import FreeCAD as App

doc = App.newDocument()
bod1 = App.ActiveDocument.addObject("Part::Box", "Box")
bod2 = App.ActiveDocument.addObject("Part::Cylinder", "Cylinder")
bod1.Placement.Base = App.Vector(10, 0, 0)
bod2.Placement.Base = App.Vector(0, 10, 0)

obj1 = App.ActiveDocument.addObject("App::Link", "Link")
obj2 = App.ActiveDocument.addObject("App::Link", "Link")

obj1.LinkedObject = bod1
obj2.setLink(bod2)
obj1.Placement.Base = App.Vector(-10, -10, 0)
obj2.Placement.Base = App.Vector(10, -10, 0)
obj1.ViewObject.OverrideMaterial = True
App.ActiveDocument.recompute()

Le App::Link de base n'a pas d'objet Proxy, il ne peut donc pas être entièrement utilisé pour la sous-classification.

Par conséquent, pour la sous-classification Python, vous devez créer l'objet App::LinkPython. 

import FreeCAD as App

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

Exemple masquage de propriétés. La fonction appLinkExecute est exécutée lorsque le lien est recalculé. 

def appLinkExecute(self, obj, linkObj, index, linkElement)
  properties = linkObj.PropertiesList
  # This is assuming all these properties you want to add exists in obj
  # You don't need to hide the original property. The action of adding a property of the same name will hide the linked property.
  for prop in ("XYZ", "MNO", "PQR"):
    if prop not in properties:
      linkObj.addProperty(obj.getTypeIdOfProperty(prop), prop, obj.getGroupOfProperty(prop))
      
   # now do what you like...

Lecture complémentaire

Si vous souhaitez passer outre les détails historiques, rendez-vous sur le site introduction aux liens orientée vers l'utilisateur.

L'objet App Link a été introduit après 2 ans de développement et de prototypage. Ce composant a été pensé et développé presque seul par l'utilisateur realthunder. Les motivations et les implémentations de conception derrière ce projet sont décrites dans sa page GitHub, Link. Afin d'accomplir cette fonctionnalité, plusieurs modifications fondamentales de FreeCAD ont été apportées; ceux-ci ont également été largement documentés dans Core-Changes.

Le projet App Link a démarré après que la refonte de l'atelier PartDesign s'est terminée dans la v0.17. L'histoire d'App Link peut être retracée à certains fils de discussion essentiels du forum :

Enfin, le pull request et le merge ont eu lieu :

D'autres « liens » à propos de Link incluent :


Groupe
Créer un sous-lien
Std Base
Std Base
Hub utilisateurs