Éditeur de propriétés

From FreeCAD Documentation
Revision as of 10:45, 14 December 2019 by Mario52 (talk | contribs)

Description

L'éditeur de propriétés apparaît lorsque l'onglet Model de la vue combinée est actif dans l'interface; il permet de gérer les propriétés exposées publiquement des objets du document.

Généralement, l'éditeur de propriétés est conçu pour traiter un seul objet à la fois. Les valeurs affichées dans l'éditeur de propriétés appartiennent à l'objet sélectionné du document actif. Malgré cela, certaines propriétés, telles que les couleurs, peuvent être définies pour plusieurs objets sélectionnés. Si aucun élément n'est sélectionné, l'éditeur de propriétés sera vide.

Toutes les propriétés ne peuvent pas toujours être modifiées. en fonction du statut spécifique de la propriété, certains d'entre eux seront invisibles (non répertoriés) ou en lecture seule (non modifiables).

File:FreeCAD Properties empty.png

Éditeur de propriétés vide, quand aucun objet n'est sélectionné.

Définition d'une propriété

Une propriété est une information, telle qu'un nombre ou une chaîne de texte, attachée à un document FreeCAD ou à un objet d'un document. Les propriétés peuvent être visualisées et modifiées avec l'éditeur de propriétés.

Les objets scriptés personnalisés peuvent utiliser n'importe quel type de propriété défini dans le système de base. Voir la liste complète dans Propriétés.

Certains des types de propriétés les plus couramment utilisés sont :

App::PropertyBool
App::PropertyFloat
App::PropertyAngle
App::PropertyDistance
App::PropertyInteger
App::PropertyString
App::PropertyMatrix
App::PropertyVector
App::PropertyPlacement

Différents objets peuvent avoir différents types de propriétés. Cependant, de nombreux objets ont les mêmes types car ils sont dérivés de la même classe interne. Par exemple, la plupart des objets décrivant des formes géométriques (lignes, cercles, rectangles, corps solides, pièces importées, etc.) ont la propriété "Placement" qui définit leur position dans la Vue 3D.

Vue et Propriétés des données

Il existe deux classes de propriétés d'entités accessibles via des onglets dans l'éditeur de propriétés :

  • View propriétés liées à l'aspect "visuel" de l'objet. Les propriétés View sont liées à l'attribut ViewProvider (ViewObject) de l'objet et ne sont accessibles que lorsque l'interface graphique est chargée. Ils ne sont pas accessibles lorsque vous utilisez FreeCAD en mode console ou en tant que bibliothèque sans tête.
  • Data propriétés, liées aux paramètres "physiques" de l'objet. Les propriétés Data définissent les caractéristiques essentielles de l'objet. Elles existent à tout moment, même lorsque FreeCAD est utilisé en mode console ou en tant que bibliothèque. Cela signifie que si vous chargez un document en mode console, vous pouvez modifier le rayon d'un cercle ou la longueur d'une ligne, même si vous ne pouvez pas voir le résultat à l'écran.

Pour cette raison, les propriétés Data sont considérées comme plus "importantes", car elles définissent réellement la géométrie d'une forme. D'autre part, les propriétés View sont moins importantes car elles affectent uniquement l'apparence superficielle de la géométrie. Par exemple, un cercle de 10 mm de rayon est différent d'un cercle de 5 mm de rayon ; la couleur des cercles (propriété View) n'affecte pas leurs formes, mais le rayon (propriété Data). Dans de nombreux cas dans cette documentation, le mot "Property" désigne une "propriété de données" et non "View property".

Propriétés de base

L'objet scripté le plus élémentaire n'affiche aucune propriété Data dans l'éditeur de propriétés, à l'exception de son attribut Label. Le Label est une chaîne éditable par l'utilisateur qui identifie l'objet dans la l'arborescence. D'autre part, le Nom d'un objet est un attribut interne qui est affecté à l'objet au moment de sa création. cet attribut est en lecture seule, il ne peut donc pas être modifié et il n'est pas non plus affiché dans l'éditeur de propriétés.

Un objet paramétrique de base est créé comme suit

obj = App.ActiveDocument.addObject("App::FeaturePython", "App__FeaturePython")
obj.Label = "Plain_object"
print(obj.Name)
print(obj.Label)

File:FreeCAD Properties View basic.png File:FreeCAD Properties Data basic.png

Onglets Vue et Données de l’éditeur de propriétés, pour une basique "App::FeaturePython" d'un objet scripté.

La plupart des objets géométriques pouvant être créés et affichés dans la Vue 3D sont dérivés d'un Part::Feature. Voir Part Feature pour les propriétés les plus élémentaires de ces objets.

Pour la géométrie 2D, la plupart des objets sont dérivés de Part::Part2DObject (itself derived from Part::Feature) qui est la base du Sketchers, et de Draft éléments. Voir Part Part2DObject pour les propriétés les plus élémentaires de ces objets.

Actions

Les actions dans la vue de la propriété ont été implémentées dans 0.19.

Un clic droit dans un espace vide de la vue ou avec une propriété sélectionnée ne montre qu'une seule commande:

  • Show all: s'il est actif, en plus des propriétés standard qui apparaissent déjà, il affiche toutes les propriétés masquées des données et de vues dans leurs onglets respectifs.
    • Données: "Proxy", "Label2", "Expression Engine", and "Visibility".
    • Voir: "Proxy".

Lorsque l'option Show all est active et qu'une propriété est sélectionnée, d'autres actions sont disponibles avec un deuxième clic droit:

  • Show all: désactive la commande Show all, masquant ainsi les propriétés supplémentaires de données et d'affichage.
  • Add Property: ajoute une propriété dynamique à l'objet. cela fonctionne à la fois avec C++ defined objects, et Python objets scriptés.
  • Expression: appelle l'éditeur de formule, qui permet d'utiliser expressions dans la valeur de la propriété.
  • Hidden: si actif, définit la propriété comme masquée, ce qui signifie qu'elle ne sera affichée que si Show all est actif.
  • Output: s'il est actif, définit la propriété comme sortie.
  • NoRecompute: si actif, définit la propriété comme non recalculée lorsque le document est recalculé; Ceci est utile lorsqu'une propriété ne doit pas être affectée par d'autres mises à jour.
  • ReadOnly: si actif, définit la propriété pour être en lecture seule; il ne sera plus éditable jusqu'à ce que ce commutateur soit désactivé.
  • Transient: si actif, définit la propriété sur transitoire.
  • Touched: s'il est actif, il est touché et prêt à être recalculé.
  • EvalOnRestore: s'il est actif, il est évalué lors de la restauration du document.

Exemple de propriétés d'un objet PartDesign

Vue

Base

  • VueBounding Box: indique si une zone indiquant l'étendue globale de l'objet doit être affichée. Valeur False ou True (par défaut, False).
  • VueControl Point: indique si les points de contrôle des fonctionnalités doivent être affichés. Valeur False ou True (par défaut, False).
  • VueDeviation: définit la précision de la représentation polygonale du modèle dans la vue 3D (tessellation). Valeurs inférieures = meilleure qualité. La valeur est exprimée en pourcentage de la taille de l'objet (écart en mm = (w+h+d)/3*valueInPercent/100 où w, h, d sont les dimensions du cadre de sélection).
  • VueDisplay Mode: mode d'affichage de la fonction, Lignes plates, ombrées, filaire, points (par défaut, Flat lines).
  • VueLighting: éclairage Un côté, deux côtés (par défaut, Two side).
  • VueLine Line: donne la couleur de la ligne (bords) (par défaut, 25, 25, 25).
  • VueLine Width: donne l'épaisseur de la ligne (bords) (par défaut, 2).
  • VuePoint Color: donne la couleur des points (extrémités de l'entité) (par défaut, 25, 25, 25).
  • VuePoint Size: donne la taille des points (par défaut, 2).
  • VueSelectable: permet la sélection de la fonctionnalité. Valeur False ou True (par défaut, True).
  • VueShape Color: donne la forme de la couleur (par défaut, 204, 204, 204).
  • VueTransparency: définit le degré de transparence de la fonction de 0 sur 100 (par défaut, 0).
  • VueVisibility: détermine la visibilité de la fonctionnalité (comme la barre SPACE). Valeur False ou True (par défaut, True).

Données

Base

  • DonnéesPlacement:

Résumé des données ci-dessous. Chaque fonctionnalité a un emplacement qui peut être contrôlé via la table Propriétés de données. Il contrôle le positionnement de la pièce par rapport au système de coordonnées. REMARQUE: les propriétés de placement n'affectent pas les dimensions physiques de la fonction, mais simplement sa position dans l'espace!
Si vous sélectionnez le titre Placement Options Placement, un bouton avec trois petits points apparaît à droite. En cliquant sur ce bouton ... s'ouvre la fenêtre d'options Opération de Positionnement.

  • DonnéesAngle:

Spécifie l'angle à utiliser avec la propriété axis (ci-dessous). Un angle est défini ici et l'axe sur lequel agit l'angle est défini avec la propriété axis. L'entité est pivotée de l'angle spécifié, autour de l'axe spécifié. Un exemple d'utilisation pourrait être si vous avez créé une fonctionnalité de révolution selon vos besoins, mais que vous deviez ensuite faire pivoter la fonctionnalité dans son ensemble, afin de lui permettre de s'aligner sur une autre fonctionnalité préexistante.

  • DonnéesAxis:

Cette propriété spécifie les axes autour desquels l'entité doit être tournée. La valeur exacte de la rotation provient de la propriété angle (ci-dessus). Cette propriété prend trois arguments qui sont transmis sous forme de nombres dans les zones x, y et z de l'outil. Si vous définissez une valeur pour plusieurs axes, la pièce sera tournée selon chaque axe en multipliant la valeur de l'angle par la valeur de l'axe. Par exemple, avec un angle de 15 ° défini, les valeurs de 1,0 pour x et de 2,0 pour y donneront une rotation de 15 ° de la pièce finie sur l'axe des x ET de 30 ° sur l'axe des y.

  • DonnéesPosition:

Cette propriété spécifie le point de base auquel toutes les dimensions font référence. Cela prend trois arguments, qui sont transmis sous forme de nombres aux zones x, y et z de l'outil. Si vous définissez une valeur pour plusieurs cases, la pièce sera traduite par le nombre d'unités le long de l'axe correspondant.

  • DonnéesLabel:

L'étiquette est le nom donné à l'objet (fonctionnalité). Ce nom peut être modifié à volonté.

Script

See also: FreeCAD Script de Base.

Voir la page objets scriptés pour obtenir des informations complètes sur l'ajout de propriétés aux objets définis via un script Python.

La plupart des propriétés visibles dans l'éditeur de propriétés sont accessibles depuis la console Python. Dans la plupart des cas, ces propriétés ne sont que des attributs de la classe qui définit l'objet sélectionné. Par exemple, si l'éditeur de propriétés affiche la propriété DonnéesGroup, cela signifie que l'objet a l'attribut Group.

print(obj.Group)

These attributes (properties) are added with the addProperty method of the base object. At least it is necessary to specify the type of property, and its name.

obj.addProperty("App::PropertyFloat", "Custom")
print(obj.Custom)

L'éditeur de propriétés prend le nom de l'attribut et l'affiche dans la liste. Les attributs ont normalement des noms qui suivent la convention PascalCase, ce qui signifie que les mots individuels qui font que le nom d'attribut commencent par une majuscule. Lorsque l'éditeur de propriétés affiche ces noms, il laisse un espace entre chaque lettre majuscule. Cela signifie que l'attribut LineColor est affiché sous la forme Line Color dans l'éditeur de propriétés.

obj.addProperty("App::PropertyDistance", "CustomCamelProperty")
obj.CustomCamelProperty = 1000
print(obj.CustomCamelProperty)

Property editor showing the Data properties of a PartDesign Body, with two additional properties, "Custom" and "Custom Camel Property".

In similar way the View properties are added, not to the base object, but to its ViewObject. Then, it follows that properties like VueAngular Deflection, VueBounding Box, VueDisplay Mode, VueDisplay Mode Body, VueLine Color, and others, can be examined and changed from the Python console.

print(obj.ViewObject.AngularDeflection)
print(obj.ViewObject.BoundingBox)
print(obj.ViewObject.DisplayMode)
print(obj.ViewObject.DisplayModeBody)
print(obj.ViewObject.LineColor)

Template:Interface/fr