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 un format de base de données paramétrique, liée à tout objet placé dans le document avec ce plug-in. Ces formats de base de données 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 un enregistrement 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 d’enregistrement paramétrique, les valeurs standard du format de base de données paramétrique sont affichées comme étant créées par le plug-in.

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

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

Paramètre	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. Indiquez le nom, le nom auxiliaire si nécessaire, le type et la valeur par défaut du paramètre. 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. Créez la liste des options. Chaque ligne dans la liste représente une choix dans la liste déroulante. Ne laissez pas de ligne vide. Pour éditer les choix de la liste par la suite, 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 » apparaît. L’ID suivant disponible est attribué automatiquement. Saisissez le nom de la catégorie.
É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 ». Saisissez le texte. La valeur dépend de la catégorie. 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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 2019, 2020 et 2021, utilisez respectivement 24, 25 et 26.
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 Créer un symbole. 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.