Chaque formule contient une ou plusieurs expressions des listes suivantes. Les expressions sont décrites plus en détail dans le reste de la section.
Expression |
Description |
Constantes |
Types de données comme les nombres entiers, les constantes booléennes, les nombres et les constantes textes |
Valeurs fixes |
Enchaînement de caractères, valeurs numériques et logiques, etc. |
Opérateurs |
Addition, soustraction, comparaison, etc. |
Variables |
Sources de données Vectorworks, comme les paramètres d’un objet, le style, le nom d’une classe |
Fonctions |
Fonctions mathématiques, manipulations d’enchaînement de caractères, fonctions conditionnelles, etc. |
ELSE |
Méthode pour ajouter une mise en correspondance de données alternative si la précédente fournit une valeur vide. |
Constante |
Description |
Exemples |
Booléen |
Les valeurs sont utilisées pour les paramètres booléens. Elles sont soit vraies (TRUE) ou fausses (FALSE) et sont écrites comme des contraintes de texte entourées d’apostrophes. |
‘FALSE’ ‘TRUE’ |
Entier |
Les nombres positifs et négatifs ou 0, écrits comme des nombres sans décimales ou apostrophes |
4 125 |
Nombre rationnel |
Valeurs de nombres réels, écrits comme un nombre avec des décimales et sans apostrophes |
3,14 -12,0 248,141539 |
Texte |
Valeurs textes entourées d’apostrophes |
‘Unstyled Wall’ ‘INTERNAL’ ‘NOTDEFINED’ |
Opérateur |
Description |
+ |
Plus unaire |
- |
Moins unaire |
+ |
Plus binaire, addition, concaténation |
- |
Moins binaire, soustraction |
* |
Multiplication |
/ |
Division |
= |
Logique EQUALS |
! |
Logique NOT |
| |
Logique OR |
& |
Logique AND |
!= |
Logique NOT EQUAL |
> |
Supérieur à |
< |
Inférieur à |
>= |
Supérieur ou égal à |
<= |
Inférieur ou égal à |
Les variables représentent des sources de données dans Vectorworks. Elles peuvent être combinées à des constantes, des résultats de fonctions et d’autres variables à l’aide d’opérateurs. Le type de variable (nom) est identique à celui de la source de données. Les variables sont entourées de crochets vu qu’il est possible d’insérer des espaces dans leur nom.
Variable |
Format |
Exemple |
Paramètres d’un objet |
[Objet.NomDuParamètre] Si le paramètre est un champ avec une liste déroulante, la variable revient à la valeur localisée. Pour utiliser la valeur universelle, ajoutez une astérisque après le nom du champ. |
[Object.Config] [Object.Column ID] [Object.Struct Type] [Object.structuralUse*] |
Nom Vectorworks |
[Object.VW_Name] |
[Object.VW_Name] |
Donnée d’un champ d’un format de base de données |
[Record.NameOfTheRecord.NameOfTheField] Si un enregistrement portant ce nom n’est pas liée à l’objet, alors la valeur par défaut du champ est considérée comme la valeur de la variable. |
[Record.MyRecord.Price] [Record.Plant Record.Latin Name] |
Données à partir du style |
[Style.NameOfTheField] Les champs de données actuellement supportés sont: Nom (du style), Marque, Fonction, Description, Extérieur (booléen), Portant(e) (booléen), Résistance au feu, Matériaux inflammables (booléen), Compartimentage (booléen), Valeur U, Résistance acoustique, Système de catégorie de prix, Catégorie de prix, Type, Fabricant |
[Style.Function] [Style.Name] [Style.Fire Rating] |
Composant |
[Component.NameOfTheField] Les champs de données actuellement supportés sont: Nom (le nom du composant), Fonction, Classe, Épaisseur, Lambda, Valeur U. Si l’option d’export par composant n’est pas utilisée, ces variables correspondent au composant principal. |
[Component.Function] [Component.Thickness] |
Matériau |
[Material.NameOfTheField] Les champs de données actuellement supportés sont: Nom, Description, Marque, Référence, Est un volume, Catégorie, Standard, N° de référence, Description de classification, Fabricant, Modèle produit, Nom produit, Description produit, URL produit, Source produit, Finition produit, Coût produit |
[Material.Mark] [Material.Category] [Material.Lambda] |
Données de champ d'un enregistrement lié à un matériau |
[Material Record.NameOfTheField] |
[Material Record.CastInPlace] [Material Record.TimeToDry] |
Nom de la classe |
[ClassName] |
[ClassName] |
Nom du calque |
[LayerName] |
[LayerName] |
Nom de l’étage |
[StoryName] |
[StoryName] |
Fonction |
Description |
PI ( ) |
Retourne le nombre Π. |
SIN (radians) |
Retourne le sinus. |
COS (radians) |
Retourne le cosinus. |
ABS (nombre) |
Retourne la valeur absolue. |
SQRT (nombre) |
Retourne la racine carrée. |
INT (nombre) |
Retourne la valeur entière convertie. |
REAL (nombre) |
Retourne la valeur réelle convertie. |
IF (expression_logique, expression_valeur1, expression_valeur2) |
Calcule l’expression_logique et retourne la valeur calculée de l’expression_valeur1 si TRUE ou sinon, la valeur de l’expression_valeur2 |
SELECT1 (expression_numérique, expression_valeur1, expression_valeur2, …, expression_valeurN) |
Calcule l’expression_numérique et retourne la valeur calculée de l’expression_valeur1, si le résultat est égal à 0, la valeur de l’expression_valeur2 si le résultat est égal à 1, etc. Retourne la valeur de la dernière expression, si le résultat est supérieur à N-1. Le nombre des paramètres doit être supérieur à 3. |
SELECT2 (expression_logique1, expression_valeur1, expression_logique2, expression_valeur2, ..., expression_logiqueN, expression_valeurN) |
Calcule la première expression logique et retourne la valeur calculée de l’expression_valeur 1, si le résultat est TRUE; sinon, continue avec la paire d’expression logique et d’expression_valeur suivante. Le nombre des paramètres doit être égal ou supérieur à 2. Le nombre des paramètres doit être égal ou supérieur à 2. |
COUNTER (“nom”) |
Retourne les valeurs incrémentées automatiquement (pour générer des valeurs uniques). |
BOUNDS (“nom”) |
Retourne les dimensions X/Y/Z ou la Largeur/Hauteur/Profondeur d’un objet. |
LEFT (texte, quantité) |
Retourne le côté gauche du texte, selon un nombre (une quantité) de caractères. Retourne une valeur vide si la valeur de la quantité est incorrecte. |
RIGHT (texte, quantité) |
Retourne le côté droit du texte, selon un nombre (une quantité) de caractères. Retourne une valeur vide si la valeur de la quantité est incorrecte. |
MID (texte, index, quantité) |
Retourne le côté droit du texte, divisé par l’index de position (0 est la position du premier caractère) selon un nombre (une quantité) de caractères. Retourne une valeur vide si la valeur de l’index ou de la quantité est incorrecte. |
FIND (sous-texte, texte) |
Retourne la position sur base 0 du sous-texte dans un texte, si trouvé ou -1 si non trouvé. Exemple: exemple FIND (‘fo’, ‘foo’) retourne 0 et FIND (‘oo’, ‘foo’) retourne 1. |
LEN (chaîne de caractères) |
Retourne la longueur de la chaîne de caractères. |
INSERT (chaîne de caractères 1, index, chaîne de caractères 2) |
Retourne la chaîne de caractères 2 dans la chaîne de caractères 1 à la position de l’index. |
DELETE (chaîne de caractères, index, quantité) |
Supprimer le côté droit du texte, divisé par index de position selon un nombre (une quantité) de caractères. |
REPLACE (chaîne de caractères 1, chaîne de caractères 2, chaîne de caractères 3) |
Remplace toutes les occurrences de la chaîne de caractères 2 par la chaîne de caractères 3 dans la chaîne de caractères 1. |
TRIMLEFT (chaîne de caractères) |
Retourne la partie gauche de la chaîne de caractères tronquée de ses caractères vides. |
TRIMRIGHT (chaîne de caractères) |
Retourne la partie droite de la chaîne de caractères tronquée de ses caractères vides. |
MAKEUPPER (chaîne de caractères) |
Retourne la chaîne de caractères en majuscules. |
MAKELOWER (chaîne de caractères) |
Retourne la chaîne de caractères en minuscules. |
GETCOMPONENTINFO (index, sélecteur) |
Renvoie des informations sur le composant sélectionné (mur / plancher), où index est le numéro du composant et le sélecteur est l'un des éléments suivants: 1 (Nom composant) 2 (Fonction composant) 3 (Classe composant) 4 Épaisseur composant) |
ISFLIPPED( ) |
Retourne si l’objet est inversé ou non. |
GETOBJECTVARIABLE(selector)
|
Renvoie la valeur d'une propriété d'objet Vectorworks. Pour des valeurs spécifiques pour la sélection d’objet, consultez l’annexe G de la page « VectorScript Function Reference ». developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#appx_g. |
~~~~~~~~~~~~~~~~~~~~~~~~~