Skip to content

Commit

Permalink
doc user signs improved
Browse files Browse the repository at this point in the history
  • Loading branch information
itsakifa committed Jun 24, 2024
1 parent a414c17 commit d60db14
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 13 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
43 changes: 30 additions & 13 deletions website/documentation/user-guide/advanced/customsigns.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,10 @@ tx_slug: documentation_user-guide_advanced_customsigns

# Signaux définis par l'utilisateur

Il arrive qu'une certaine composition de signaux sur un même panneau n'existe pas dans la sélection des signaux officiels. La table `vl_user_sign` (couche *Signal défini par l'utilisateur* dans QGIS) permet la création de signaux personnalisés. Cette table contient les mêmes attributs que `vl_official_sign`, la liste des signaux officiels. Au minimum, les attributs suivants doivent être renseignés:
Il arrive qu'une certaine composition de signaux sur un même panneau n'existe pas dans la sélection des signaux officiels.

## Remplir la base de données
La table `vl_user_sign` (couche *Signal défini par l'utilisateur* dans QGIS) permet la création de signaux personnalisés. Cette table contient les mêmes attributs que `vl_official_sign`, la liste des signaux officiels. Les attributs peuvent être renseignés soit directement dans la base de données via pgAdmin, soit dans le projet QGIS. Au minimum, les attributs suivants doivent être renseignés:

* `id` - identifiant unique qui sera utilisé dans la liste déroulante dans QGIS
* `active` - à mettre sur *true*, autrement le signal n'apparaîtra pas dans la liste déroulante dans QGIS
Expand All @@ -15,29 +18,43 @@ Il arrive qu'une certaine composition de signaux sur un même panneau n'existe p

Les attributs suivants permettent en outre de créer et gérer des panneaux directionnels personnalisés:

* `directional_sign` - à mettre sur true s'il s'agit d'un panneau directionnel
* `directional_sign` - à mettre sur *true* s'il s'agit d'un panneau directionnel
* `img_fr_right`, `img_de_right`, `img_it_right`, `img_ro_right`, qui contiendront le nom du fichier `.svg` avec direction à droite, par exemple *composite-r.svg*. Les attributs `img_fr`, `img_de` etc. contiendront alors le nom du fichier `.svg` avec direction à gauche, par exemple *composite-l.svg*.

Il est possible de créer des signaux statiques ou dynamiques. Le signal dynamique permet d'avoir une base de signal personnalisé qui est en plus dynamique par rapport au texte à afficher.
L'attribut `no_dynamic_inscription` devrait contenir le nombre de textes dynamiques dans le `.svg` (ce qui équivaut au nombre de lignes). Cette information doit être renseignée manuellement.

Afin d'accéder à la liste déroulante des signaux définis par l'utilisateur dans QGIS, le **type de signal** *défini par l'utilisateur* doit être choisi.
## Création du symbol à afficher sur la carte
La création du `.svg` correspondant est donc dans la responsabilité de l'utilisateur. Le fichier d'image doit être enregistré dans les deux dossiers

* `project/images/user-defined/original` : ceci est l'image non-dynamique qui sera aussi affichée dans le formulaire d'attributs. Cette image doit contenir un text static d'exemple.
* `project/images/user-defined/editable` : ceci est l'image dynamique qui permet d'afficher des inscriptions dynamiques.

> A noter: Il est recommandé de reprendre un des fichiers d'images officielles (`project/images/official/original` et `/éditable`) **comme exemple et base** pour créer un signal personnalisé, afin d'avoir une idée de la taille et pour comprendre comment configurer les inscriptions dynamiques.
<figure markdown>
![Liste définie par l'utilisateur](../../assets/images/printscreen/liste_defini_par_lutilisateur.png)
<figcaption>Liste des types de signal</figcaption>
![Stockage fichiers personnalisés](../../assets/images/printscreen/folder_tree_images.png){width="200"; loading=lazy; style="max-width: 900px"}
<figcaption>Emplacement des fichiers `.svg` des signaux définis par l'utilisateur</figcaption>
</figure>

La création du `.svg` correspondant est donc dans la responsabilité de l'utilisateur. Le fichier d'image doit être enregistré dans les deux dossiers
### Signaux dynamiques
Les fichiers `.svg` éditables (dynamiques) contiennent des objets texte `param(text1)`, `param(text2)`, `param(text3)` en fonction du nombre de lignes à afficher sur le signal. Ce texte est défini via le projet QGIS, dans les champs `inscription_1`, `inscription_2` et `inscription_3` du formulaire d'attribut du signal.
Le nombre de lignes d'inscriptions dynamiques est limité à 3 au maximum.

* `project/images/user-defined/original` : ceci est l'image non-dynamique qui sera aussi affichée dans le formulaire d'attributs. Cette image doit contenir un text static d'exemple.
* `project/images/user-defined/editable` : ceci est l'image dynamique qui permet d'afficher des inscriptions
Le `.svg` dynamique ne laisse pas beaucoup d'options de formatage. Le texte sera toujours affiché à partir de là où commence le champs texte `param(text)`. Il n'est donc pas possible de centrer le texte dynamique sur le signal.

> A noter: Il est recommandé de reprendre un des fichiers d'images officielles (`project/images/official/original` et `/éditable`) **comme exemple et base** pour créer un signal personnalisé, afin d'avoir une idée de la taille et pour comprendre comment configurer les inscriptions dynamiques.
<figure markdown>
![Exemple signal éditable](../../assets/images/printscreen/example_editable_sign.png){width="400"; loading=lazy; style="max-width: 900px"}
<figcaption>Exemple de signal dynamique</figcaption>
</figure>

### Signaux statiques
Si le signal personnalisé ne doit pas contenir d'inscription dynamique, les fichiers dans les dossiers `user-defined/original` et `user-defined/editable` peuvent être les mêmes.

<figure markdown>
![Stockage fichiers personnalisés](../../assets/images/printscreen/folder_tree_images.png){width="200"; loading=lazy; style="max-width: 900px"}
<figcaption>Emplacement des fichiers `.svg` des signaux définis par l'utilisateur</figcaption>
</figure>
## Utilisation dans le projet QGIS
Afin d'accéder à la liste déroulante des signaux définis par l'utilisateur dans QGIS, le **type de signal** *défini par l'utilisateur* doit être choisi.

<figure markdown>
![Liste définie par l'utilisateur](../../assets/images/printscreen/liste_defini_par_lutilisateur.png)
<figcaption>Liste des types de signal</figcaption>
</figure>

0 comments on commit d60db14

Please sign in to comment.