Définition d’un plug-in

Les paramètres qui définissent l’aspect d’un plug-in pour un outil, une commande ou un objet sont enregistrés dans une fiche paramétrique, liée à tout objet placé dans le document avec ce plug-in. Ces fiches contiennent les données et valeurs paramétriques standard. Une commande qui ouvre une boîte de dialogue, par exemple, pourrait devoir enregistrer les valeurs insérées par un utilisateur afin de réutiliser celles-ci ultérieurement. Un outil pourrait offrir différents modes. Si l’utilisateur sélectionne un autre mode pour l’outil, la nouvelle option peut être sauvegardée et réutilisée. Ces valeurs peuvent être enregistrées dans une fiche paramétrique pour la commande ou l’outil et récupérées ultérieurement lorsque la commande ou l’outil est à nouveau sélectionné. Lorsque vous alternez entre plusieurs fichiers, les valeurs enregistrées liées aux nouveaux fichiers sont affichées ou, s’il n’existe pas de fiche paramétrique, les valeurs standard de la fiche paramétrique sont affichées comme étant créées par le plug-in.

Vous pouvez modifier les paramètres dans la palette Info Objet de l’objet. Une fiche paramétrique standard est également réalisée lorsque l’objet (ou l’outil) est placé pour la première fois dans le fichier. Cette fiche paramétrique sauvegarde les préférences standard de l’objet avec le fichier. Elle est utilisée pour chaque nouvel objet placé.

Pour définir les paramètres d’un plug-in sur mesure:

1. Sélectionnez dans la boîte de dialogue « Gestionnaire des plug-ins » l’onglet Plug-ins sur mesure.

2. Cliquez sur le bouton Éditer la définition.

La boîte de dialogue « Éditer la définition du plug-in » s’ouvre.

►    Cliquez pour afficher/masquer les champs.

Champ	Description
Onglet « Général »
Type	Indique le type de plug-in (commande, outil, objet ou fichier include).
Langue	Vous voyez apparaître ici le langage script utilisé pour le script du plug-in (voir Écrire des scripts pour des plug-ins).
Nom	Saisissez le nom du nouveau plug-in (qui deviendra également le nom de fichier du plug-in accompagné automatiquement de l'extension adéquate: .px,  .vsm, .vst, ou  .vso. Si vous renommez un plug-in, n’oubliez pas de mettre ensuite à jour votre configuration.
Catégorie	Attribuez le plug-in à une catégorie pour le retrouver facilement lorsque vous éditez la configuration.
Onglet « Paramètres »	Déterminez les paramètres standard pour le plug-in. Les paramètres standard sont appliqués au moment où vous utilisez le plug-in. Ils sont affichés dans l’ordre donné du plug-in. Vous pouvez modifier l’ordre des paramètres en les faisant glisser dans la colonne #.
Liste des objets paramétriques	Dans cette fenêtre, vous trouvez une liste des objets paramétriques standard, éventuellement un nom alternatif (localisé), le type de paramètre et la valeur par défaut. Pour les objets linéaires, le paramètre LineLength est affiché, contenant la longueur de l’axe de l’objet linéaire. Pour les objets rectangulaires, les paramètres LineLength (longueur d’origine de l’objet) et BoxWidth (la largeur d’origine de l’objet) sont affichés. Vous pouvez donner de nouvelles valeurs par défaut pour ces paramètres, mais vous ne pouvez pas les supprimer.
Nouveau	Créez un nouveau paramètre pour le plug-in. La boîte de dialogue « Paramètre du plug-in » s'ouvre. Donnez un nom au paramètre et éventuellement un nom auxiliaire. Déterminez le type et saisissez une valeur par défaut. Cliquez sur OK. Pour créer une liste d’options prédéfinies, sélectionnez comme Type l’option Liste déroulante. La boîte de dialogue « Valeurs disponibles » s’ouvre. Saisissez les différentes options. Chaque ligne correspond à une option dans la liste. Cliquez sur OK. Pour éditer les choix de la liste, cliquez sur Valeurs.
Éditer	Éditez les paramètres du plug-in sélectionné. Vous pouvez également éditer les paramètres de certains plug-ins tiers et plug-ins intégrés.
Supprimer	Supprimer le plug-in sélectionné.
Onglet « Textes »	Déterminez les chaînes de caractères utilisées par le plug-in.
Liste de chaînes de caractères	Cette liste reprend les chaînes de caractères utilisées par le plug-in (par exemple, des valeurs de sélection d’une couleur qui indiquent quelle couleur doit être utilisée par le plug-in).
Ajouter	Ajoutez un texte à la définition du plug-in. La boîte de dialogue « Ajouter catégorie » s’ouvre. Le prochain numéro ID disponible est automatiquement attribué. Donnez un nom à la catégorie et cliquez sur OK.
Éditer	Éditez la chaîne de caractères sélectionnée. La boîte de dialogue « Textes » s’ouvre. Sélectionnez une chaîne de caractères individuelle et cliquez sur Éditer pour ouvrir la boîte de dialogue « Textes ». Adaptez le texte et cliquez sur OK. Pour plus d'informations, voir developer.vectorworks.net.
Supprimer	Supprimer le plug-in sélectionné.
Onglet « Préférences »	Grâce à ces préférences, les plug-ins peuvent se comporter comme des outils, objets et commandes standard dans Vectorworks. Elles vous permettent de déterminer le comportement du plug-in concernant l’état du fichier (état de sélection, affichage), ainsi que le texte d’aide affiché. Les préférences disponibles dépendent du type de plug-in. Vous pouvez uniquement définir les préférences des plug-ins sur mesure.
Commande
Disponibilité	Pour chaque situation dans le dessin, indiquez si la condition est exigée (la condition est nécessaire pour que la commande soit exécutée), non autorisée (la commande est désactivée dans cette situation) ou si elle peut être ignorée (la situation n’a pas d’influence sur l’activation de la commande).
Message d’aide	Saisissez le texte qui apparaîtra comme texte d’aide lorsque vous placerez votre curseur sur une commande (cette option est uniquement disponible sur Macintosh).
Écraser aide contextuelle	Saisissez une URL (commençant par http:) pour définir une page internet contenant l’aide relative au plug-in. Pour définir un fichier par rapport au dossier de programme Vectoworks, indiquez l’emplacement du fichier en commençant par. / (point et barre oblique).
Créé dans la version	Indiquez dans quelle version de Vectorworks le plug-in a été créé. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Modifié dans la version	Indiquez dans quelle version de Vectorworks le plug-in a été modifié pour la dernière fois. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Fin de support dans la version	Indiquez depuis quelle version de Vectorworks le plug-in n’est plus pris en charge. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Outil
Message de la Barre des modes	Déterminez la description devant apparaître dans la Barre des modes. Il s’agit souvent du nom de l’objet et éventuellement de l’action que l’utilisateur doit exécuter.
Icône	Vous pouvez remplacer le pictogramme standard par un symbole sur mesure. S’il s’agit d’un plug-in tiers, créez deux versions de l’icône: une pour une résolution standard et une autre pour un résolution élevée: ●    Résolution standard: une image centrée dans une zone de 26 pixels de large sur 20 pixels de haut. Enregistrez l’image au format .png. ●    Résolution élevée: une image centrée dans une zone de 52 pixels de large sur 40 pixels de haut. Enregistrez l’icône au format .png avec le même nom que l’image pour la résolution standard suivi de la mention « @2x ». Par exemple, si l’icône pour la résolution standard s’appelle TrousseModelisation3D.png, l’icône pour une résolution élevée devra porter le nom TrousseModelisation3D@2x.png. Sinon, le programme ne pourra pas retrouver l’icône. Cliquez sur Éditer icône pour importer l’icône de résolution standard. Si une icône haute résolution est également présente avec la mention @2x, le logiciel l’importera également automatiquement. Vectorworks fait apparaître l’icône correspondant à la résolution de l’affichage.
Projection	Déterminez l’affichage qui doit être actif. Si une projection 3D est requise, l’affichage sera adapté. Si une projection 2D est requise, la vue Plan 2D sera activée pour cet outil. La projection hybride n’affecte pas la projection de la vue.
Exécuter script	Les outils sont par défaut directement exécutés lorsqu’ils sont sélectionnés. Dans certains cas, il peut cependant être souhaitable de n’exécuter le script qu’à un mouvement de la souris (comme par exemple pour un outil dessiné interactivement).
Écraser aide contextuelle	Saisissez une URL (commençant par http:) pour définir une page internet contenant l’aide relative au plug-in. Pour définir un fichier par rapport au dossier de programme Vectoworks, indiquez l’emplacement du fichier en commençant par. / (point et barre oblique).
Créé dans la version	Déterminez dans quelle version de Vectorworks le plug-in a été créé. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Modifié dans la version	Déterminez dans quelle version de Vectorworks le plug-in a été modifié pour la dernière fois. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Fin de support dans la version	Déterminez depuis quelle version de Vectorworks le plug-in n’est plus pris en charge. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Message d’aide	Saisissez le texte qui apparaîtra comme texte d’aide lorsque vous placerez votre curseur sur une commande (cette option est uniquement disponible sur Macintosh).
Objet
Icône	Vous pouvez remplacer le pictogramme standard par un symbole sur mesure. Réalisez une image de 8 bits centrée dans une zone de 26 pixels de large et 20 pixels de haut. Enregistrez l’image au format .png et cliquez sur Éditer icône pour l’importer.
Projection	Déterminez l’affichage qui doit être actif. Si une projection 3D est requise, l’affichage sera adapté. Si une projection 2D est requise, la vue Plan 2D sera activée pour cet outil. La projection hybride n’affecte pas la projection de la vue.
Exécuter script	Les objets sont par défaut directement exécutés lorsqu’ils sont sélectionnés. Dans certains cas, il peut cependant être souhaitable de n’exécuter le script qu’à un mouvement de la souris (comme par exemple pour un objet dessiné interactivement).
Classe standard	Déterminez la classe standard dans laquelle l’objet doit être créé. Si la classe n’existe pas encore au moment où vous placez l’objet, celle-ci sera créée automatiquement à ce moment-là.
Écraser aide contextuelle	Saisissez une URL (commençant par http:) pour définir une page internet contenant l’aide relative au plug-in. Pour définir un fichier par rapport au dossier de programme Vectoworks, indiquez l’emplacement du fichier en commençant par. / (point et barre oblique).
Créé dans la version	Déterminez dans quelle version de Vectorworks le plug-in a été créé. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Modifié dans la version	Déterminez dans quelle version de Vectorworks le plug-in a été modifié pour la dernière fois. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Fin de support dans la version	Déterminez depuis quelle version de Vectorworks le plug-in n’est plus pris en charge. Par exemple, pour Vectorworks 2016, 2017 et 2018, utilisez respectivement 21, 22 et 23.
Message d’aide	Saisissez le texte qui apparaîtra comme texte d’aide lorsque vous placerez votre curseur sur une commande (cette option est uniquement disponible sur Macintosh).
Options (types d’objet paramétrique uniquement)
Options d'exécution	Vous pouvez attribuer des objets, comme les symboles, à des options prédéfinies pour placer l’objet dans le document. Avec ces options, les objets peuvent interagir comme vous le souhaitez avec des murs ou d’autres types d’objets avancés. Les plug-ins du type commande et outil n’ont pas d’options d’exécution. La géométrie d’un objet sera par défaut uniquement recalculée si les paramètres ou points de contrôle de l’objet sont modifiés. Si la géométrie de l’objet est recalculée, les préférences standard du fichier pour les attributs tels que la police, la taille de texte ou la couleur de trait seront à nouveau appliqués sur l’objet. Si l’une de ces options a été modifiée après que l’objet a été placé ou modifié pour la dernière fois, l’aspect de l’objet peut changer. Le script est exécuté lorsque les paramètres de l’objet sont modifiés. Pour des cas où il est important que l’objet soit à nouveau calculé (par exemple pour des fenêtres placées dans un mur), le script peut aussi faire en sorte que l’objet soit recalculé si celui-ci est pivoté (Actualiser après rotation) ou déplacer (Actualiser après déplacement). Le script du plug-in peut aussi devenir un gestionnaire d’évènements (Selon les évènements). Les scripts doivent alors réagir à un petit ensemble d’évènements d’application. Vous trouverez des exemples et de la documentation (en anglais) sur www.vectorworks.net.
Insertion dans murs	Sélectionnez l’option souhaitée pour l’objet. Voir Concept: Les symboles dans Vectorworks. Pour les objets n’ayant pas besoin d’options d’insertion, laissez les valeurs par défaut.

3. Dès que vous avez défini les paramètres pour le plug-in, cliquez sur OK pour revenir au gestionnaire des plug-ins.

~~~~~~~~~~~~~~~~~~~~~~~~~

Écrire des scripts pour des plug-ins

Définir des plug-ins

Concept: Plug-ins