App GeoFeature/fr: Difference between revisions
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
Line 46: | Line 46: | ||
===== Propriétés cachées de Données ===== |
===== Propriétés cachées de Données ===== |
||
<div class="mw-translate-fuzzy"> |
|||
* {{PropertyData/fr|Expression Engine|ExpressionEngine}}: une liste d'expressions. Par défaut, vide {{value|[]}}. |
* {{PropertyData/fr|Expression Engine|ExpressionEngine}}: une liste d'expressions. Par défaut, vide {{value|[]}}. |
||
* {{PropertyData/fr|Label2|String}}: description plus longue et modifiable par l'utilisateur de cet objet, il s'agit d'une chaîne UTF8 arbitraire. Par défaut, il s'agit d'une chaîne vide {{value|""}}. |
* {{PropertyData/fr|Label2|String}}: description plus longue et modifiable par l'utilisateur de cet objet, il s'agit d'une chaîne UTF8 arbitraire. Par défaut, il s'agit d'une chaîne vide {{value|""}}. |
||
* {{PropertyData/fr|Proxy|PythonObject}}: une classe personnalisée associée à cet objet. Cela n'existe que pour la version [[Python/frPython]]. Voir [[App_GeoFeature/fr#Script|Script]]. |
* {{PropertyData/fr|Proxy|PythonObject}}: une classe personnalisée associée à cet objet. Cela n'existe que pour la version [[Python/frPython]]. Voir [[App_GeoFeature/fr#Script|Script]]. |
||
* {{PropertyData/fr|Visibility|Bool}}: affiche ou non l'objet. |
* {{PropertyData/fr|Visibility|Bool}}: affiche ou non l'objet. |
||
</div> |
|||
=== Vue === |
=== Vue === |
||
<div class="mw-translate-fuzzy"> |
|||
⚫ | |||
⚫ | |||
* {{PropertyView/fr|Shape Material|Material}}: un [[App_Material/fr|App Material]] associé à cet objet. Par defaut, vide. |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
* {{PropertyView/fr|Bounding Box|Bool}}: s'il s'agit de {{TRUE}}, l'objet affichera le cadre de délimitation dans la [[3D view/fr|Vue 3D]]. |
* {{PropertyView/fr|Bounding Box|Bool}}: s'il s'agit de {{TRUE}}, l'objet affichera le cadre de délimitation dans la [[3D view/fr|Vue 3D]]. |
||
* {{PropertyView/fr|Display Mode|Enumeration}}: il est vide par défaut. |
* {{PropertyView/fr|Display Mode|Enumeration}}: il est vide par défaut. |
||
Line 64: | Line 70: | ||
* {{PropertyView/fr|Transparency|Percent}}: un entier de {{value|0}} à {{value|100}} qui détermine le niveau de transparence des faces dans la [[3D view/fr|vue 3D]]. Une valeur de {{value|100}} indique des faces complètement invisibles. Les faces sont invisibles mais peuvent toujours être sélectionnées tant que {{PropertyView|Selectable}} est {{TRUE}}. |
* {{PropertyView/fr|Transparency|Percent}}: un entier de {{value|0}} à {{value|100}} qui détermine le niveau de transparence des faces dans la [[3D view/fr|vue 3D]]. Une valeur de {{value|100}} indique des faces complètement invisibles. Les faces sont invisibles mais peuvent toujours être sélectionnées tant que {{PropertyView|Selectable}} est {{TRUE}}. |
||
* {{PropertyView/fr|Visibility|Bool}}: s'il s'agit de {{TRUE}}, l'objet apparaît dans la [[3D view/fr|Vue 3D]] sinon invisible. Par défaut, cette propriété peut être activée et désactivée en appuyant sur la barre {{KEY|Espace}} du clavier. |
* {{PropertyView/fr|Visibility|Bool}}: s'il s'agit de {{TRUE}}, l'objet apparaît dans la [[3D view/fr|Vue 3D]] sinon invisible. Par défaut, cette propriété peut être activée et désactivée en appuyant sur la barre {{KEY|Espace}} du clavier. |
||
</div> |
|||
{{TitleProperty|Object Style}} |
|||
===== Propriétés cachées de Vue ===== |
|||
* {{PropertyView|Shape Color|Color}}: a tuple of three floating point RGB values {{value|(r,g,b)}} to define the color of the faces in the [[3D view|3D view]]; by default it is {{value|(0.8, 0.8, 0.8)}}, which is displayed as {{value|[204, 204, 204]}} on base 255, a <span style="background-color:#ccc; width:3em; height:12pt; padding: 2px 1em 2px;"> light gray </span>. |
|||
* {{PropertyView|Shape Material|Material|Hidden}}: an [[App_Material|App Material]] associated with this object. By default it is empty. |
|||
* {{PropertyView|Transparency|Percent}}: an integer from {{value|0}} to {{value|100}} that determines the level of transparency of the faces in the [[3D view|3D view]]. A value of {{value|100}} indicates completely invisible faces; the faces are invisible but they can still be picked as long as {{PropertyView|Selectable}} is {{TRUE}}. |
|||
⚫ | |||
⚫ | |||
* {{PropertyView |
* {{PropertyView|On Top When Selected|Enumeration}}: see the information in [[App_FeaturePython|App FeaturePython]]. |
||
* {{PropertyView|Selectable|Bool}}: if it is {{TRUE}}, the object can be picked with the pointer in the [[3D view|3D view]]. Otherwise, the object cannot be selected until this option is set to {{TRUE}}. |
|||
* {{PropertyView|Selection Style|Enumeration}}: see the information in [[App_FeaturePython|App FeaturePython]]. |
|||
== Script == |
== Script == |
Revision as of 19:00, 11 September 2020
Introduction
Un objet App GeoFeature, ou officiellement App::GeoFeature
, est la classe de base de la plupart des objets qui afficheront des éléments géométriques dans la vue 3D car il inclut la propriété DonnéesPlacement.
Diagramme simplifié des relations entre les objets centraux du programme. La classe App::GeoFeature
est la classe de base de pratiquement tous les objets du logiciel qui affichera la géométrie dans le vue 3D.
Utilisation
App GeoFeature est un objet interne, il ne peut donc pas être créé à partir de l'interface graphique. Il n'est généralement pas destiné à être utilisé directement, mais il peut plutôt être sous-classé pour obtenir un objet nu qui n'a qu'une propriété DonnéesPlacement de base pour définir sa position dans la vue 3D.
Certains des objets dérivés les plus importants sont les suivants:
- La classe Part Feature, le parent de la plupart des objets 2D et 3D formes topologiques.
- La classe Mesh Feature, le parent de la plupart des objets fabriqués à partir de meshes, pas des solides.
- La classe Fem FemMeshObject, le parent des maillages d'éléments finis créés avec le FEM Workbench.
- La classe Path Feature, le parent des chemins créés avec le Path Workbench pour une utilisation dans l'usinage CNC.
- La classe App Part, qui définit Std Parts qui peut être utilisée comme conteneurs de corps pour effectuer des assemblages.
Lorsque vous créez cet objet dans Python, au lieu de sous-classer App::GeoFeature
, vous devez sous-classer App::GeometryPython
car ce dernier inclut une valeur par défaut fournisseur de vues et attributs Proxy
pour l'objet lui-même et son fournisseur de vues. Voir Script.
Propriétés
App FeaturePython (classe App::FeaturePython
) est dérivée de la classe de base App DocumentObject (classe App::DocumentObject
). Elle partage toutes les propriétés de cette dernière.
En plus des propriétés décrites dans App DocumentObject, la GeoFeature possède la propriété DonnéesPlacement qui contrôle sa position dans la vue 3D.
Voir Propriétés pour tous les types de propriétés que les objets crées par script peuvent avoir.
Ce sont les propriétés disponibles dans l'éditeur de propriétés. Les propriétés masquées peuvent être affichées en utilisant la commande Show all dans le menu contextuel de l'éditeur de propriétés.
Données
Base
- DonnéesPlacement (
Placement
): la position de l'objet dans la Vue 3D. Le placement est défini par un pointBase
(vecteur) et unRotation
(axe et angle). Voir Positionnement.- DonnéesAngle: l'angle de rotation autour de DonnéesAxis. Par défaut
0°
(zéro degré). - DonnéesAxis: le vecteur unitaire qui définit l'axe de rotation pour le placement. Chaque composant est une valeur à virgule flottante entre
0
et1
. Si une valeur est supérieure à1
, le vecteur est normalisé de sorte que l'amplitude du vecteur est1
. Par défaut, il s'agit de l'axe Z positif,(0, 0, 1)
. - DonnéesPosition: un vecteur avec les coordonnées 3D du point de base. Par défaut, c'est l'origine
(0, 0, 0)
.
- DonnéesAngle: l'angle de rotation autour de DonnéesAxis. Par défaut
- DonnéesLabel (
String
): le nom modifiable par l'utilisateur de cet objet, il s'agit d'une chaîne UTF8 arbitraire.
Propriétés cachées de Données
- DonnéesExpression Engine (
ExpressionEngine
): une liste d'expressions. Par défaut, vide[]
. - DonnéesLabel2 (
String
): description plus longue et modifiable par l'utilisateur de cet objet, il s'agit d'une chaîne UTF8 arbitraire. Par défaut, il s'agit d'une chaîne vide""
. - DonnéesProxy (
PythonObject
): une classe personnalisée associée à cet objet. Cela n'existe que pour la version Python/frPython. Voir Script. - DonnéesVisibility (
Bool
): affiche ou non l'objet.
Vue
- VueProxy (
PythonObject
): une classe de fournisseur de vue personnalisée associée à cet objet. Par defaut, vide. Cela n'existe que pour la version Python. Voir Scripting. - VueShape Material (
Material
): un App Material associé à cet objet. Par defaut, vide.
- VueBounding Box (
Bool
): s'il s'agit detrue
, l'objet affichera le cadre de délimitation dans la Vue 3D. - VueDisplay Mode (
Enumeration
): il est vide par défaut. - VueOn Top When Selected (
Enumeration
):Disabled
(par défaut),Enabled
,Object
,Element
. - VueSelectable (
Bool
): s'il s'agit detrue
, l'objet peut être sélectionné avec le pointeur dans la Vue 3D. Sinon, l'objet ne peut pas être sélectionné tant que cette option n'est pas définie surtrue
. - VueSelection Style (
Enumeration
):Shape
(par défaut),BoundBox
. Si l'option estShape
, la forme entière (sommets, arêtes et faces) sera mise en surbrillance dans la Vue 3D; s'il s'agit deBoundBox
, seul le cadre de sélection sera mis en surbrillance. - VueShape Color (
Color
): un tuple de trois valeurs RVB à virgule flottante(r,g,b)
pour définir la couleur des faces dans la Vue 3D. Par défaut, il s'agit de(0.8, 0.8, 0.8)
, qui s'affiche sous la forme[204,204,204]
sur la base 255, un gris clair . - VueShow In Tree (
Bool
): s'il s'agit detrue
, l'objet apparaît dans la vue arborescente. Sinon, il est défini comme invisible. - VueTransparency (
Percent
): un entier de0
à100
qui détermine le niveau de transparence des faces dans la vue 3D. Une valeur de100
indique des faces complètement invisibles. Les faces sont invisibles mais peuvent toujours être sélectionnées tant que VueSelectable esttrue
. - VueVisibility (
Bool
): s'il s'agit detrue
, l'objet apparaît dans la Vue 3D sinon invisible. Par défaut, cette propriété peut être activée et désactivée en appuyant sur la barre Espace du clavier.
Object Style
- VueShape Color (
Color
): a tuple of three floating point RGB values(r,g,b)
to define the color of the faces in the 3D view; by default it is(0.8, 0.8, 0.8)
, which is displayed as[204, 204, 204]
on base 255, a light gray . - Vue (Hidden)Shape Material (
Material
): an App Material associated with this object. By default it is empty. - VueTransparency (
Percent
): an integer from0
to100
that determines the level of transparency of the faces in the 3D view. A value of100
indicates completely invisible faces; the faces are invisible but they can still be picked as long as VueSelectable istrue
.
Selection
- VueOn Top When Selected (
Enumeration
): see the information in App FeaturePython. - VueSelectable (
Bool
): if it istrue
, the object can be picked with the pointer in the 3D view. Otherwise, the object cannot be selected until this option is set totrue
. - VueSelection Style (
Enumeration
): see the information in App FeaturePython.
Script
Voir aussi: Débuter avec les scripts et Objets créés par script.
Voir Part Feature pour les informations générales sur l'ajout d'objets au programme.
Un GeoFeature est créé avec la méthode addObject()
du document. Si vous souhaitez créer un objet avec une 2D ou 3D forme topologique, il peut être préférable de créer l'une des sous-classes spécialisées pour la manipulation des formes, par exemple, Part Feature ou Part Part2DObject.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeoFeature", "Name")
obj.Label = "Custom label"
Cette App::GeoFeature
de base n'a pas de fournisseur de vue par défaut donc aucune icône ne sera affichée dans la vue arborescente et aucune propriété View ne sera disponible.
Par conséquent, pour les scripts Python, sous-classe, vous devriez créer l'objet Part::GeometryPython
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeometryPython", "Name")
obj.Label = "Custom label"
Par exemple, l'élément Arch Partie de bâtiment de Atelier Arch est un objet App::GeometryPython
avec une icône personnalisée.
- Coeur : App DocumentObject
- Base : App FeaturePython, App GeoFeature, Part Fonction, Mesh Feature, Fem FemMeshObject
- Formes internes : Part TopoShape, Mesh MeshObject, Fem FemMesh
- Structure : App DocumentObjectGroup (Std Groupe), App Part (Std Part), App Link
- Derivés : Part Part2DObject, Sketcher SketchObject, PartDesign Corps, PartDesign Fonction
- Démarrer avec FreeCAD
- Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don
- Aide : Tutoriels, Tutoriels vidéo
- Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test