Part Box/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(46 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|
|
|[[Part_Cylinder/fr|Cylindre]]
|[[Part_Cylinder/fr|Cylindre]]
|[[Part_Module/fr|Atelier Part]]
|[[Part_Workbench/fr|Atelier Part]]
|IconL=
|IconL=
|IconR=Part_Cylinder.svg
|IconR=Part_Cylinder.svg
Line 12: 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_Module|Atelier Part]]
|Workbenches=[[Part_Workbench/fr|Part]]
|SeeAlso=[[Part_Primitives/fr|Part Primitives]]
|SeeAlso=[[Part_Primitives/fr|Part Primitives]]
}}
}}


==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|Cube]]


[[Image:Part_Box_Example.png|400px]]
==Utilisation==
# Basculez vers l'[[Image:Workbench_Part.svg|16px]] [[Part_Workbench/fr|Atelier Part]]
# Lancez la commande de plusieurs manières:
#* Appuyez sur le bouton {{Button|[[Image:Part_Box.svg|16px]] Créer un cube plein}} dans la barre d'outils.
#* Sélectionnez {{MenuCommand|Pièce → Primitives → [[Image:Part_Box.svg|16px]] Cube}} dans la barre de menus.


<span id="Usage"></span>
'''Result:''' The default result is a box with an equal length, width and height of 10 mm. It is attached the the global xy-plane and one edge is coincident with the global z-axis.
== Utilisation ==


# Il existe plusieurs façons de lancer la commande :
The box properties can later be edited, either in the property editor or by double-clicking on the box in the model tree.
#* Appuyez sur le bouton {{Button|[[Image:Part_Box.svg|16px]] [[Part_Box/fr|Cube]]}}.
#* Sélectionnez l'option {{MenuCommand|Part → Primitives → [[Image:Part_Box.svg|16px]] Cube}} dans le menu.
# La boîte est créée.
# Vous pouvez modifier les dimensions et le {{PropertyData|Placement}} de la boîte en effectuant l'une des opérations suivantes :
#* Double-cliquez sur l'objet dans la [[Tree_view/fr|vue en arborescence]] :
#*# Le panneau de tâches {{MenuCommand|Primitives géométriques}} s'ouvre.
#*# 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>
==Propriétés==
== Exemple ==
{{Properties_Title|Base}}
*{{PropertyData/fr|Placement}}: Spécifie l'orientation et la position du cube dans l'espace 3D. Voir [[Placement/fr|Placement]]. Le point de référence est le coin inférieur avant gauche du cube.
*{{PropertyData/fr|Label}}: Étiquette donnée à l'objet Cube. Modifiez le label en fonction de vos besoins.


[[Image:Part_Box_Scripting_Example.png|thumb|Part Cube à partir de l'exemple du script]]
{{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.


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


<span id="Notes"></span>
== 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.

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

Voir aussi: [[Property_editor/fr|Éditeur de propriétés]]

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:
{{Code|code=
FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
}}
* Où "myBox" est l'étiquette de l'objet Box.
* Retourne l'objet nouvellement créé de type Box.


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]].
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.

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

{{Code|code=
{{Code|code=
FreeCAD.ActiveDocument.myBox.Length = 25
box = FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
FreeCAD.ActiveDocument.myBox.Width = 15
FreeCAD.ActiveDocument.myBox.Height = 30
}}
}}


* Où {{Incode|"myBox"}} est le nom de l'objet.
Vous pouvez changer son emplacement avec:
* La fonction restitue l'objet juste créé.

Exemple :

{{Code|code=
{{Code|code=
import FreeCAD as App
FreeCAD.ActiveDocument.myBox.Placement = FreeCAD.Placement(FreeCAD.Vector(4, 6, 3), FreeCAD.Rotation(30, 45, 10))

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()
}}
}}


Line 68: Line 106:
|
|
|[[Part_Cylinder/fr|Cylindre]]
|[[Part_Cylinder/fr|Cylindre]]
|[[Part_Module/fr|Atelier Part]]
|[[Part_Workbench/fr|Atelier Part]]
|IconL=
|IconL=
|IconR=Part_Cylinder.svg
|IconR=Part_Cylinder.svg
Line 74: 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()