Champs de texte

Les champs de texte sont des fonctions pour les textes et les lignes de repères. Les champs de texte sont des formules calculées lorsque Rhino est ouvert et dont le résultat est affiché dans le texte. Tous les champs de texte ont la même syntaxe : %<champ et options>%. Lorsqu'une formule ne peut pas être calculée, une chaîne d'erreur (####) est affichée.

Opérations mathématiques

Toutes les fonctions de champ de texte qui donnent un nombre (par exemple Area, BlockInstanceCount, CurveLength, NumPages, PageNumber, Volume) peuvent être combinées dans des formules mathématiques.

Par exemple :

%<2*3>% donne 6.

%<NumPages()-1>% donne 3 s'il y a 4 pages de mise en page dans le modèle.

Format des chaînes de texte

Les fonctions peuvent être au format Python et .NET.

Exemples :
Ajouter des zéros non significatifs devant un nombre

%<'{:03}'.format(NumPages())>% change 2 en 002 si le modèle possède 2 pages de mise en page.

Modifier la casse

%<ModelUnits().upper()>% convertit les unités du modèle, par exemple : de millimètres en MILLIMÈTRES.

Fonctions de modification de la casse dans Python et .NET

Python :

upper(), lower() et capitalize()

.NET:

ToUpper() et ToLower()

Il n'existe pas de fonction directe de mise en majuscules dans .NET.

Fonctions

Area

Calcule l'aire d'une courbe fermée (plane), d'un motif de hachures, d'une surface, d'une polysurface, d'un SubD ou d'un maillage.

Syntaxe :

Utiliser les unités du style d'annotation.

%<Area("IdentifiantObjet")>%

Indiquer une unité.

%<Area("IdentifiantObjet","Unités")>%

TexteUtilisateurAttribut

Texte de l'utilisateur pour une combinaison objet / clé donnée.

Syntaxe :

%<UserText("IdentifiantObjet","Clé")>%

Clé du texte de l'utilisateur dont la valeur doit être extraite.

Sélectionner un objet

Sélectionnez l'objet dont vous voulez extraire les clés de texte de l'utilisateur pour l'attribut.

  • Cette page apporte les mêmes fonctions que celles se trouvant dans les propriétés des objets, section Texte de l'utilisateur pour l'attribut.

  • Il est possible de faire une référence à l'annotation même avec "(null)". Comment...

  • UserText() renvoie une chaîne de texte qui ne peut pas être utilisée dans des calculs si elle n'est pas convertie en nombre avant. Comment...

TexteAttributBloc

Définit le Texte de l'utilisateur pour l'attribut à inclure dans une occurrence de bloc.

Syntaxe :

%<UserText("block","Clé","Invite","Valeur")>%

  • Clé et Valeur correspondent au Texte de l'utilisateur pour l'attribut enregistré dans l'occurrence de bloc.
  • Invite représente le texte affiché dans la boîte de dialogue lors de l'insertion du bloc.
  • Les éléments Valeur et Invite sont optionnels.

Comment fonctionne cette option :

  1. Utilisez la commande Texte pour créer un objet de texte.

  2. Cliquez sur le bouton fx dans la boîte de dialogue Texte.

  3. Sélectionnez TexteAttributBloc dans la liste de gauche.

  4. Entrez du texte pour les éléments Clé, Invite et Valeur.

  5. Créez une définition de bloc comprenant le texte d'attribut de bloc.

  6. Utilisez la commande Insérer pour ajouter le bloc dans la fenêtre.

  7. Dans la boîte de dialogue, entrez le texte souhaité comme Valeur ou cliquez sur fx pour utiliser un autre champ de texte.

Dans cet exemple, une définition de bloc nommée Data Table est créée à partir du tableau contenant le texte d'attribut de bloc définissant le nom, l'âge et le genre.

Le bloc est ensuite inséré dans la fenêtre en-dessous des deux autres personnes. La commande Insérer demande d'entrer les informations.

Télécharger le modèle d'exemple...

BlockDescription

Récupère la description d'une définition de bloc en sélectionnant son occurrence dans les fenêtres.

Syntaxe :

%<BlockDescription("ID de l'occurrence")>%

BlockInstanceCount

Affiche le nombre de blocs portant le nom indiqué.

Syntaxe :

%<BlockInstanceCount("NomBloc")>%

BlockName

Récupère le nom d'une définition de bloc en sélectionnant son occurrence dans les fenêtres.

Syntaxe :

%<BlockName("ID de l'occurrence")>%

%<BlockName("Bloc")>% renvoie le nom de la définition de bloc qui contient directement la chaîne du champ du texte.

CurveLength

Longueur d'une courbe.

Syntaxe :

Utiliser les unités du style d'annotation.

%<CurveLength("IdentifiantObjet")>%

Indiquer une unité.

%<CurveLength("IdentifiantObjet","Unités")>%

Date

La date et heure actuelles.

Format de date :

Sélectionnez un format de date et d'heure dans la liste.

Région :

Sélectionnez une région dans la liste. Une langue correspondant à la région sera choisir pour la date.

Syntaxe :

%<Date("Format", "Region")>%

Exemples :

%<Date("M/d/yyyyy", "fr-FR")>% = 03/06/2022

%<Date("M/d/yyyyy h:mm tt", "fr-FR")>% = 03/06/2022 4:48 PM

%<Date("dddd dd MMMM yyyy", "fr-FR")>% = vendredi 3 juin 2022

DateModified

La date et heure d' dernier enregistrement de ce fichier.

Format de date :

Sélectionnez un format de date et d'heure dans la liste.

Région :

Sélectionnez une région dans la liste. Une langue correspondant à la région sera choisir pour la date.

Syntaxe :

%<DateModified("Format", "Region")>%

Exemples :

%<DateModified("M/d/yyyy", "en-US")>% = 12/17/2020

%<DateModified("M/d/yyyy h:mm tt", "en-US")>% = 12/17/2020 4:48 PM

%<DateModified("dddd, MMMM dd, yyyy", "en-US")>% = Thursday, December 17, 2020

DetailScale (uniquement pour les vues détaillées parallèles)

Afficher une valeur d'échelle formatée pour la vue détaillée sélectionnée.

Syntaxe :

%<DetailScale("IdentifiantVueDétaillée","Format")>%

Exemples de format

Sans format = 0.1

#:1 = 0.1:1

1:# = 1:10

1=# = 1" = 10'

#=1 = 1/8" = 1'

#=1-0 = 1/8" = 1'-0"

Utiliser le nom de l'attribut de la vue détaillée

Fait référence à une vue détaillée en utilisant le nom défini dans ses Propriétés d'objet au lieu de son GUID.

DocumentUserText

Texte de l'utilisateur du document dans le modèle.

Syntaxe :

%<DocumentText("Clé")>%

Clé du Texte de l'utilisateur du document dont la valeur doit être extraite.

NomFichier

Chemin d'accès au fichier.

Syntaxe :

%<FileName>%

%<FileName>% - crée le chemin complet vers le modèle

%<FileName("0")>% - crée le chemin complet vers le modèle

%<FileName("1")>% - nom de fichier court (avec l'extension)

%<FileName("2")>% - chemin complet vers le modèle sans l'extension

%<FileName("3")>% - nom de fichier court sans l'extension

Le paramètre numérique est un masque pour activer certaines fonctions :

1 = nom de fichier court

2 = sans extension

1+2 = 3 = nom de fichier court + sans l'extension

LayerName

Renvoie le nom d'un calque sélectionné.

Syntaxe :

%<LayerName("IdentifiantCalque")>%

LayoutUserText

Renvoie la valeur d'une clé de texte d'utilisateur enregistrée dans une mise en page.

Syntaxe :

La valeur d'une clé de texte de l'utilisateur pour la mise en page dans la mise en page actuelle.

%<LayoutUserText("Clé")>%

La valeur d'une clé de texte de l'utilisateur dans une mise en page spécifique.

%<LayoutUserText("IdentifiantMiseEnPage","Clé")>%

ModelUnits

Unités du modèle actuel.

Syntaxe :

%<ModelUnits()>%

Notes

Contenu des Notes.

Syntaxe :

%<Notes()>%

NumPages

Le nombre de pages de mise en page dans le document.

Syntaxe :

%<NumPages()>%

ObjectLayer

Renvoie le nom du calque d'un objet sélectionné.

Syntaxe :

%<ObjectLayer("IdentifiantObjet")>%

ObjectName

Affiche le nom de l'objet ou du bloc s'il existe.

Syntaxe :

%<ObjectName("IdentifiantObjet")>%

ObjectPageName

Renvoie le nom de la mise en page dans laquelle se trouve l'objet sélectionné.

Si l'objet ne se trouve dans aucune mise en page, #### est affiché.

Syntaxe :

%<ObjectPageName("IdentifiantObjet")>%

ObjectPageNumber

Renvoie le numéro de la mise en page dans laquelle se trouve l'objet sélectionné.

Si l'objet ne se trouve dans aucune mise en page, #### est affiché.

  • La modification de l'organisation des mises en page dans le panneau Mises en page modifie les numéros de mises en page.
Syntaxe :

%<ObjectPageNumber("IdentifiantObjet")>%

PageHeight

Hauteur de la page de mise en page dans laquelle se trouve ce champ de texte.

Syntaxe :

%<PageHeight()>%

PageName

Nom de la page de mise en page actuelle ou sélectionnée.

Page sélectionnée

Affiche le nom de la page de mise en page sélectionnée.

Syntaxe :

Nom de la page de mise en page actuelle.

%<PageName()>%

Nom de la page de mise en page sélectionnée.

%<PageName("IdentifiantPage")>%

PageNumber

Numéro de la mise en page actuelle.

  • Le numéro de page peut être décalé. La valeur du décalage peut être positive ou négative.
Syntaxe :

%<PageNumber()>%

%<PageNumber() + ValeurDécalage>%

PageWidth

Largeur de la page de mise en page dans laquelle se trouve ce champ de texte.

Syntaxe :

%<PageWidth()>%

PaperName

Nom de la taille de papier sélectionnée.

Syntaxe :

%<PaperName()>%

PointCoordinate

Affiche les coordonnées XYZ d'un objet ponctuel sélectionné.

Les axes XYZ peuvent être activés respectivement.

Syntaxe :

%<PointCoordinate("IdentifiantObjet","Axes")>%

Volume

Renvoie le volume d'une extrusion, d'une surface, d'une polysurface, d'un maillage ou d'un SubD.

Autoriser les objets ouverts

Permet de donner le volume d'un objet ouvert.

Syntaxe :

Utiliser les unités du style d'annotation.

%<Volume("IdentifiantObjet")>%

Indiquer une unité.

%<Volume("IdentifiantObjet","Unités")>%

Autoriser les objets ouverts.

%<Volume("ObjectID","Vrai")>%

  • Vrai (ou 1) renvoie le volume d'un objet ouvert. Faux (ou 0) renvoie 0 si un objet ouvert est sélectionné.

Décomposer et DécomposerBloc

Lorsque des occurrences de bloc contenant des champs de texte sont décomposées, les commandes Décomposer et DécomposerBloc donnent des résultats différents.

  • La commande DécomposerBloc conserve les champs de texte originaux.

  • La commande Décomposer traduit les champs de texte en chaînes de texte statiques.

Le champ de texte Date donne toujours la date du système une fois l'occurrence de bloc décomposée par la commande DécomposerBloc.