Part Box/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "== Utilisation ==")
No edit summary
 
(34 intermediate revisions by 2 users not shown)
Line 13: Line 13:
|Name=Part Box
|Name=Part Box
|Name/fr=Part Cube
|Name/fr=Part Cube
|MenuLocation=Pièce → Primitives → Cube
|MenuLocation=Part → Primitives → Cube
|Workbenches=[[Part_Workbench/fr|Atelier Part]]
|Workbenches=[[Part_Workbench/fr|Part]]
|SeeAlso=[[Part_Primitives/fr|Part Primitives]]
|SeeAlso=[[Part_Primitives/fr|Part Primitives]]
}}
}}
Line 20: Line 20:
== Description ==
== Description ==


La commande Cube de l'[[Part_Workbench/fr|atelier Part]] insère un [https://fr.wikipedia.org/wiki/Pav%C3%A9_droit parallélépipède droit] paramétrique dans le document actif. Par défaut, la commande insère un cube de 10x10x10 mm positionné à l'origine avec l'étiquette "cube". Ces paramètres peuvent être édités une fois que l'objet a été ajouté.
La commande [[Image:Part_Box.svg|24px]] '''Part Cube''' crée un solide de type boîte paramétrique, un [https://fr.wikipedia.org/wiki/Pav%C3%A9_droit parallélépipède rectangle]. Dans le système de coordonnées défini par sa propriété {{PropertyData|Placement}}, la face inférieure de la boîte se trouve dans le plan XY, son coin avant gauche étant à l'origine et son bord avant étant parallèle à l'axe des X.


[[Image:Part_Box.jpg|400px|Part_Box]]
[[Image:Part_Box_Example.png|400px]]


<span id="Usage"></span>
== Utilisation ==
== Utilisation ==


# Il existe plusieurs façons de lancer la commande :
<div class="mw-translate-fuzzy">
#* Appuyez sur le bouton {{Button|[[Image:Part_Box.svg|16px]] [[Part_Box/fr|Cube]]}}.
==Utilisation==
#* Sélectionnez l'option {{MenuCommand|Part → Primitives → [[Image:Part_Box.svg|16px]] Cube}} dans le menu.
# Basculez vers l'[[Image:Workbench_Part.svg|16px]] [[Part_Workbench/fr|Atelier Part]]
# La boîte est créée.
# Lancez la commande de plusieurs manières:
# Vous pouvez modifier les dimensions et le {{PropertyData|Placement}} de la boîte en effectuant l'une des opérations suivantes :
#* Appuyez sur le bouton {{Button|[[Image:Part_Box.svg|16px]] Créer un cube plein}} dans la barre d'outils.
#* Double-cliquez sur l'objet dans la [[Tree_view/fr|vue en arborescence]] :
#* Sélectionnez {{MenuCommand|Pièce → Primitives → [[Image:Part_Box.svg|16px]] Cube}} dans la barre de menus.
#*# Le panneau de tâches {{MenuCommand|Primitives géométriques}} s'ouvre.
</div>
#*# Modifiez une ou plusieurs propriétés.
#*# L'objet est mis à jour dynamiquement dans la [[3D_view/fr|vue 3D]].
#*# Appuyez sur le bouton {{Button|OK}}.
#*# Modifiez les propriétés dans l'[[Property_editor/fr|éditeur de propriétés]].
#* Changez le {{PropertyData|Placement}} avec la commande [[Image:Std_TransformManip.svg|16px]] [[Std_TransformManip/fr|Std Transformer]].


<span id="Example"></span>
'''Résultat:''' le résultat par défaut est une boîte dont la longueur, la largeur et la hauteur sont égales à 10 mm. Elle est attachée au plan xy global et un bord coïncide avec l'axe z global.
== Exemple ==


[[Image:Part_Box_Scripting_Example.png|thumb|Part Cube à partir de l'exemple du script]]
Les propriétés de la boîte peuvent ensuite être modifiées, soit dans l'éditeur de propriétés, soit en double-cliquant sur la boîte dans l'arbre du modèle.


Un objet Part Cube créé avec l'[[#Script|exemple du script]] ci-dessous.
== Properties ==


<span id="Notes"></span>
{{Properties_Title|Box}}
== Remarques ==


* Un Part Cube peut également être créé avec la commande [[Image:Part_Primitives.svg|16px]] [[Part_Primitives/fr|Part Primitives]]. Avec cette commande, vous pouvez spécifier les dimensions et le placement au moment de la création.
<div class="mw-translate-fuzzy">
{{Properties_Title|Box}}
*{{PropertyData/fr|Length}}: Le paramètre length est la dimension de la boîte dans la direction x.
*{{PropertyData/fr|Width}}: Le paramètre width est la dimension de la boîte dans la direction y.
*{{PropertyData/fr|Height}}: Le paramètre height est la dimension de la boîte dans la direction z.
</div>


<span id="Properties"></span>
== Scripting ==
== Propriétés ==


Voir aussi: [[Property_editor/fr|Éditeur de propriétés]]
<div class="mw-translate-fuzzy">

Un objet Part Cube est dérivé d'un [[Part_Feature/fr|Part Feature]] et hérite de toutes ses propriétés. Il possède également les propriétés supplémentaires suivantes :

<span id="Data"></span>
=== Données ===

{{TitleProperty|Attachment}}

L'objet a les mêmes propriétés d'attachement qu'un [[Part_Part2DObject/fr#Donn.C3.A9es|Part Part2DObject]].

{{TitleProperty|Box}}

* {{PropertyData|Length|Length}} : longueur de la boîte. Il s'agit de la dimension dans sa direction X. La valeur par défaut est {{Value|10mm}}.
* {{PropertyData|Width|Length}} : largeur de la boîte. Il s'agit de la dimension dans sa direction Y. La valeur par défaut est {{Value|10mm}}.
* {{PropertyData|Height|Length}} : hauteur de la boîte. Il s'agit de la dimension dans sa direction Z. La valeur par défaut est {{Value|10mm}}.

<span id="Scripting"></span>
==Script==
==Script==

La commande Box peut être utilisée dans [[Macros/fr|macro]] et à partir de la console python en utilisant la fonction suivante:
Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation], [[Part_scripting/fr|Part Ecrire un script]] et [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts FreeCAD]].
</div>

Un Part Cube est créé avec la méthode {{incode|addObject()}} du document :


{{Code|code=
{{Code|code=
Line 60: Line 83:
}}
}}


* Où {{Incode|"myBox"}} est le nom de l'objet.
<div class="mw-translate-fuzzy">
* La fonction restitue l'objet juste créé.
* Où "myBox" est l'étiquette de l'objet Box.
* Retourne l'objet nouvellement créé de type Box.
</div>


Exemple :
<div class="mw-translate-fuzzy">
Vous pouvez accéder aux attributs de l'objet Box et les modifier. Par exemple, vous pouvez modifier les paramètres de longueur, largeur et hauteur.
</div>


{{Code|code=
{{Code|code=
import FreeCAD as App
box.Length = 25
box.Width = 15
box.Height = 30
}}


doc = App.activeDocument()
Vous pouvez changer son emplacement avec:


box = doc.addObject("Part::Box", "myBox")
{{Code|code=
box.Length = 4
box.Placement = FreeCAD.Placement(FreeCAD.Vector(4, 6, 3), FreeCAD.Rotation(30, 45, 10))
box.Width = 8
box.Height = 12
box.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(75, 60, 30))

doc.recompute()
}}
}}


Line 91: Line 112:
}}
}}


{{Part Tools navi{{#translation:}}}}
{{Part_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 21:22, 18 September 2023

Part Cube

Emplacement du menu
Part → Primitives → Cube
Ateliers
Part
Raccourci par défaut
Aucun
Introduit dans la version
-
Voir aussi
Part Primitives

Description

La commande Part Cube crée un solide de type boîte paramétrique, un parallélépipède rectangle. Dans le système de coordonnées défini par sa propriété DonnéesPlacement, la face inférieure de la boîte se trouve dans le plan XY, son coin avant gauche étant à l'origine et son bord avant étant parallèle à l'axe des X.

Utilisation

  1. Il existe plusieurs façons de lancer la commande :
    • Appuyez sur le bouton Cube.
    • Sélectionnez l'option Part → Primitives → Cube dans le menu.
  2. La boîte est créée.
  3. Vous pouvez modifier les dimensions et le DonnéesPlacement de la boîte en effectuant l'une des opérations suivantes :
    • Double-cliquez sur l'objet dans la vue en arborescence :
      1. Le panneau de tâches Primitives géométriques s'ouvre.
      2. Modifiez une ou plusieurs propriétés.
      3. L'objet est mis à jour dynamiquement dans la vue 3D.
      4. Appuyez sur le bouton OK.
      5. Modifiez les propriétés dans l'éditeur de propriétés.
    • Changez le DonnéesPlacement avec la commande Std Transformer.

Exemple

Part Cube à partir de l'exemple du script

Un objet Part Cube créé avec l'exemple du script ci-dessous.

Remarques

  • Un Part Cube peut également être créé avec la commande Part Primitives. Avec cette commande, vous pouvez spécifier les dimensions et le placement au moment de la création.

Propriétés

Voir aussi: Éditeur de propriétés

Un objet Part Cube est dérivé d'un Part Feature et hérite de toutes ses propriétés. Il possède également les propriétés supplémentaires suivantes :

Données

Attachment

L'objet a les mêmes propriétés d'attachement qu'un Part Part2DObject.

Box

  • DonnéesLength (Length) : longueur de la boîte. Il s'agit de la dimension dans sa direction X. La valeur par défaut est 10mm.
  • DonnéesWidth (Length) : largeur de la boîte. Il s'agit de la dimension dans sa direction Y. La valeur par défaut est 10mm.
  • DonnéesHeight (Length) : hauteur de la boîte. Il s'agit de la dimension dans sa direction Z. La valeur par défaut est 10mm.

Script

Voir aussi : Autogenerated API documentation, Part Ecrire un script et Débuter avec les scripts FreeCAD.

Un Part Cube est créé avec la méthode addObject() du document :

box = FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
  • "myBox" est le nom de l'objet.
  • La fonction restitue l'objet juste créé.

Exemple :

import FreeCAD as App

doc = App.activeDocument()

box = doc.addObject("Part::Box", "myBox")
box.Length = 4
box.Width = 8
box.Height = 12
box.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(75, 60, 30))

doc.recompute()