Part Box/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(27 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 :
# Basculez vers l'[[Image:Workbench_Part.svg|16px]] [[Part_Workbench/fr|Atelier Part]]
#* Appuyez sur le bouton {{Button|[[Image:Part_Box.svg|16px]] [[Part_Box/fr|Cube]]}}.
# Lancez la commande de plusieurs manières:
#* Appuyez sur le bouton {{Button|[[Image:Part_Box.svg|16px]] Cube}} dans la barre d'outils.
#* Sélectionnez l'option {{MenuCommand|Part → Primitives → [[Image:Part_Box.svg|16px]] Cube}} dans le menu.
# La boîte est créée.
#* Sélectionnez {{MenuCommand|Pièce → Primitives → [[Image:Part_Box.svg|16px]] Cube}} dans la barre de menus.
# 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>
'''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.

<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 ==
== Propriétés ==


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


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 :
*{{PropertyData|Length}} : paramètre longueur est la dimension de la boîte dans la direction x.
*{{PropertyData|Width}} : paramètre largeur est la dimension de la boîte dans la direction y.
*{{PropertyData|Height}} : paramètre hauteur est la dimension de la boîte dans la direction z.


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


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]].
La commande Cube peut être créée en utilisant la fonction suivante:

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


{{Code|code=
{{Code|code=
Line 52: Line 84:


* Où {{Incode|"myBox"}} est le nom de l'objet.
* Où {{Incode|"myBox"}} est le nom de l'objet.
* La fonction restitue l'objet nouvellement créé.
* La fonction restitue l'objet juste créé.


Exemple :
Vous pouvez accéder aux attributs de l'objet {{Incode|box}} et les modifier. Par exemple, vous pouvez modifier les paramètres de longueur, largeur et hauteur.


{{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 78: 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()