> For the complete documentation index, see [llms.txt](https://docs.dietrichs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dietrichs.com/dietrichs-intelligent-documentation/francais/elements-combines-parametriques/creation-et-edition-decp/bibliotheque-de-composants.md).

# Bibliothèque de composants

Avec les ECP, vous pouvez insérer des objets appartenant à une bibliothèque d’objet 3D. Ce sont des bibliothèques qui ont été préalablement créées avec la fonction "DI-CAM - 1-5-1 Composants".

Lors de l'insertion de bibliothèques d'éléments, la "Référence bibl. d'éléments" des de la bibliothèque est utilisée :

* Une bibliothèque de composants enregistrée avec son propre système de coordonnées. La position des composants dans ce système de coordonnées correspond à la position des composants par rapport au système de coordonnées actuel au moment où la bibliothèque de composants a été sauvegardée.
* Si la bibliothèque est insérée, elle est d'abord placée avec son système de coordonnées, exactement dans le système de coordonnées d'insertion actuel (ou le système de coordonnées d'insertion projeté).
* Ensuite, la bibliothèque est déplacée avec son système de coordonnées selon les translations définies dans les directions X, Y et Z.
* Enfin, les composants de la bibliothèque sont tournés autour de l'origine de son système de coordonnées translaté ; l'ordre des rotations doit être respecté :
  * d'abord par l'angle en plan suivant XoY,
  * puis par l'angle d'inclinaison par rapport au plan XoY
  * et enfin par l'angle de rotation autour de l'axe X qui est également tourné.

<details>

<summary>Nom et n° de la bibliothèque</summary>

{% hint style="info" %}
À partir de la version 10.01
{% endhint %}

Lorsqu'une bibliothèque est créée, elle reçoit automatiquement un numéro : 1, 2, etc…

* Le numéro est affiché à gauche dans l'arborescence de l'élément combiné paramétrique.
* Un aperçu de la bibliothèque est affiché à droite dans la zone d'aperçu.
* Une description peut être saisie à droite sous l'image d'aide. Celle-ci est utilisée à des fins de documentation. La première ligne de la description est également affichée à gauche dans l'arborescence de l'élément combiné paramétrique. De cette façon, la bibliothèque peut être reconnue beaucoup plus rapidement dans l'arborescence.

</details>

<details>

<summary>Chemins d’enregistrement</summary>

{% hint style="info" %}
À partir de la version 10.01
{% endhint %}

Toutes les bibliothèques de composants peuvent être sélectionnées. Pour que l'élément combiné paramétrique puisse être utilisé dans d'autres installations, les bibliothèques doivent être situées dans le même sous-répertoire que l'élément combiné paramétrique. Voir également le chapitre "[Construction, structure de fichier](/dietrichs-intelligent-documentation/francais/elements-combines-parametriques/creation-et-edition-decp/construction-structure-de-fichier.md)".

{% hint style="info" %}
À partir de la version 13.01
{% endhint %}

* À partir de la version 13.01, des bibliothèques peuvent également être insérées comme variables. Les variables avec l'unité "Texte" ou "Enumération" ainsi que les valeurs intermédiaires avec l'unité "Texte" peuvent être utilisées. Les objets de bibliothèque qui sont insérées de la même manière et qui comportent des informations "long-court" peuvent être gérées avec une seule entrée. Les valeurs telles que les dimensions long-court sont généralement calculées à l’aide de formules dans les valeurs intermédiaires.

</details>

<details>

<summary>"Type d’insertion ECP" et "Conditions"</summary>

{% hint style="info" %}
À partir de la version 10.01
{% endhint %}

* Ici, vous pouvez définir les conditions dans lesquelles les bibliothèques doivent être créées. Vous trouverez plus d'informations sous le chapitre "[Conditions](/dietrichs-intelligent-documentation/francais/elements-combines-parametriques/creation-et-edition-decp/variables-formules-valeurs-intermediaires.md#conditions)".

</details>

<details>

<summary>Réf. produit composant</summary>

{% hint style="info" %}
À partir de la version 11.01
{% endhint %}

Les réf. produit peuvent être transmises aux bibliothèques insérées. La réf. produit est transférée à tous les composants de la bibliothèque. Si les composants doivent recevoir des réf. produits différentes, ils doivent être répartis entre différentes bibliothèques. Si le champ "Réf. produit composant" est vide, les réf. produit d'origine sont conservées.

* La forme des composants enregistrés dans la bibliothèque est conservée, seule la réf. produit est modifiée ; par conséquent, il n'est pas possible de sélectionner des réf. produit comportant une description de barre profilée.
* Ces réf. produit peuvent être interrogées en même temps que les variables. Deux icônes sont présentes à la fin du champ permettant d’ouvrir :
  * ![](/files/HLuLrZXK6tFr3NTzFSdp) La liste des variables adaptées aux réf. produits.
  * <img src="/files/wikrudCrT0ySQQLL3NsV" alt="" data-size="original"> Le catalogue de produits avec les réf. produits disponibles
* Les réf. produit peuvent être interrogés via des variables avec les unités "*Ref.Prod.-Prof*" (réf. produit sans les barres profilées). On peut aussi utiliser des listes (*Enumération*) ou des entrées de texte (*Texte*).
* La réf. produit peut également être extraite d'un corps à sélectionner.
* Ainsi, les bibliothèques peuvent être définies avec des réf. produits variables pour les listes de matériaux ou autres résultats. Il n’est donc plus nécessaire de créer un nombre important de bibliothèques correspondant aux différentes options de matériau souhaitées.
* La réf. produit peut également être composé de parties de texte.  Ainsi, une dimension, par exemple, peut être intégrée dans la réf. produit. Exemple : une réf. produit doit être composé du texte "**Tube**" et de la longueur définie par une variable **VL** en mm sans décimales. L'expression pour la réf. produit est alors : **`Tube#VL[mm,0]#`**. Pour plus d’informations, se référer au chapitre "[Variables dans les textes, Réf. produit](/dietrichs-intelligent-documentation/francais/le-systeme-de-variables/formules-et-textes/variables-dans-les-textes-and-ref.-produits.md)" présent dans la documentation [Variables\_Ud\*\_\*\*.pdf](/dietrichs-intelligent-documentation/francais/le-systeme-de-variables.md).

</details>

<details>

<summary>Texture et couleur complémentaire</summary>

{% hint style="info" %}
À partir de la version 11.01
{% endhint %}

La texture et la couleur complémentaire peuvent être définies directement dans le champ ou interrogées via des variables. Elles sont appliquées à toutes les composants constituant la bibliothèque. Si les composants doivent avoir une texture ou couleur complémentaire différente, celles-ci doivent être attribuées aux différents composants avant de les enregistrer en bibliothèque. Si les champs correspondants sont vides, les entrées d'origine sont conservées.

* La texture et la couleur complémentaire peuvent être interrogées par le biais d’une variable ou sélectionnées depuis leur fonction de recherche respective. Deux icônes sont présentes à la fin de chaque champ permettant d’ouvrir :
  * ![](/files/HLuLrZXK6tFr3NTzFSdp) La liste des variables correspondantes
  * <img src="/files/wikrudCrT0ySQQLL3NsV" alt="" data-size="original"> La liste des textures ; deux aperçus de la texture sélectionnée est disponible dans la partie droite de la fenêtre / la fonction pour la création et l’affectation des couleurs complémentaires.
* Les textures peuvent être interrogés via des variables avec l’unité "*Texture*". Les couleurs complémentaires peuvent être interrogés via des variables avec l’unité "*Texture couleur*" (couleur de texture complémentaire).
* Ainsi, les composants de la bibliothèque destinés à la visualisation peuvent être fournies avec n'importe quel ensemble de textures.  Il n'est plus nécessaire de sauvegarder de nouvelles bibliothèques pour chaque option souhaitée.

</details>

<details>

<summary>Insérer dans MOS groupe / dans MOS bâtiment</summary>

{% hint style="info" %}
À partir de la version 11.01
{% endhint %}

* Les bibliothèques insérées sont affectées au MOS groupe spécifié. Si le champ "Groupe" reste vide, les affectations au groupe d'origine sont conservées.
* Les bibliothèques insérées sont affectées à l'élément de construction spécifié.
* Vous pouvez également définir le groupe au moyen de variables, afin de pouvoir l'interroger.  Les variables avec l'unité "*Unité(s)*", "*Texte*" ou "*Enumération*" (listes) sont prises en compte. Pour une entrée dans le champ "*Groupe*", la variable doit être entourée de # : **`#VGroupe#`**.

</details>

<details>

<summary>Insérer dans couche (vide = en dehors) / Orientation</summary>

{% hint style="info" %}
À partir de la version 12.01
{% endhint %}

* Orientation = libre : la bibliothèque est insérée directement dans le système de coordonnées d'insertion. Il est ensuite affecté à l'élément de construction spécifié dans le champ situé au-dessus mais la translation et l'orientation se réfèrent au système de coordonnées d'insertion.
* Orientation = Parallèle à l’élément du bâtiment : Maintenant, une position peut également être spécifiée. L'origine du système de coordonnées d'insertion est projetée dans la couche choisie, perpendiculairement à l'élément de construction. Un système de coordonnées d'insertion projeté est alors généré en fonction du type d'élément de construction. Il est ensuite procédé à d'autres translations et orientations. Une description détaillée des processus se trouve dans le chapitre : [Translation et projection du système de coordonnées d'insertion](/dietrichs-intelligent-documentation/francais/elements-combines-parametriques/techniques-fondamentales/systeme-de-coordonnees.md#translation-et-projection-du-systeme-de-coordonnees-dinsertion).
* Si la couche n’est pas renseignée (couche = vide), l'origine est projetée sur la surface de l'élément de construction. Pour les murs et les structures, il s'agit de la face avant ou arrière, selon la position du système de coordonnées d'insertion. Pour les planchers et les versants de toit, c'est toujours la face supérieure.
* Pour une insertion dans un étage, un toit ou dans la construction libre, l'orientation est automatiquement réglée sur "*Libre*".
* Vous pouvez également définir la couche par le biais de variables, afin qu'elle puisse être interrogée. Les variables avec l'unité "*Unité(s)*", "*Texte*" ou "*Enumération*" (listes) sont prises en compte. Pour l'entrée dans le champ "Couche", la variable doit être entourée de # : **`#VCouche#`**.

</details>

<details>

<summary>MOS Libres</summary>

{% hint style="info" %}
À partir de la version 16.01
{% endhint %}

* Après son insertion, la bibliothèque peut être affectée à un nombre quelconque de MOS libres.
* Les MOS libres sont simplement donnés sous forme de texte ; si on souhaite en renseigner plusieurs, ils doivent être séparés par un tilde \~.

</details>

<details>

<summary>Translation en X, Y, Z et angles de rotation</summary>

{% hint style="info" %}
À partir de la version 10.01
{% endhint %}

* Ce sont les translations et les rotations qui sont utilisés selon la procédure décrite en début de chapitre : [Bibliothèques de composants](/dietrichs-intelligent-documentation/francais/elements-combines-parametriques/creation-et-edition-decp/bibliotheque-de-composants.md).

</details>

<details>

<summary>Répartition de composants</summary>

{% hint style="info" %}
À partir de la version 13.01
{% endhint %}

Les répartitions peuvent être formulées dans les coordonnées des points de position des bibliothèques :

* Chaque coordonnée reçoit une entrée dans le formulaire **`(Départ~Saut~Chiffre)`**. Le chiffre 1 signifie qu'aucun saut n'est exécuté, c'est-à-dire qu’un seul composant est créé à la valeur de départ.
* Si des répartitions sont formulées, elles doivent être générées en direction de X, Y et Z.
  * **`X(1.0~0.1~5)Y(0.0~0.0~1)Z(0.0~0.0~1)`** Répartition suivant X avec 5 éléments commençant à 1,0 avec un saut de 0,1
  * **`X(1.0~0.1~5)Y(0.0~0.2~4)Z(0.0~0.0~1)`** Répartition suivant X avec 5 éléments commençant à 1.0 avec un saut de 0.1 ;  cette répartition est réalisée 4 fois en direction de Y avec un saut de 0.2.
* Grâce à ces répartitions, il est possible de créer des lignes, des trames ou des trames 3D de bibliothèques en une seule étape.

</details>

<details>

<summary>Liste avec informations Long / Court</summary>

{% hint style="info" %}
À partir de la version 10.01
{% endhint %}

Lors de la sauvegarde d'une bibliothèque, la fonction Long /court peut être utilisée pour définir les positions où la bibliothèque peut être allongée ou raccourcie pendant l'insertion.

* Les colonnes "*N°*" et "*Long/court*" comportent des informations renseignées lors de leur création pour décrire le changement de longueur. Par exemple, on indique que le premier long-court indique un changement de longueur.
* La "*longueur d’origine*" indique la longueur réelle de la bibliothèque dans son état d'origine. La longueur réelle est mesurée dans le sens du changement de longueur à l'extension maximale de tous les composants constituant la bibliothèque.
* La "*Longueur souhaitée*" dans cette direction est saisie ici soit directement, soit à l'aide d'une formule. Les composants de la bibliothèque sont allongés ou raccourcis par la différence entre la longueur d'origine et la longueur souhaitée à la position correspondante.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dietrichs.com/dietrichs-intelligent-documentation/francais/elements-combines-parametriques/creation-et-edition-decp/bibliotheque-de-composants.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
