Macro Circle/fr: Difference between revisions

From FreeCAD Documentation
m (Created page with "==Utilisation== Copiez le code et collez le dans la console Python de FreeCAD, la fonction sera disponible tout le temps de votre cession (vous pouvez aussi utiliser ce code d...")
(Created page with "Icône de la barre d'outils Image:Macro_Circle.png")
 
(48 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
{{Macro|Icon=Text-x-python|Name=Macro circle|Name/fr=Macro circle|Description=Crée un cercle en donnant différents paramètres.|Author=mario52}}

{{Macro/fr
|Name=Macro Circle
|Name/fr=Macro Circle
|Icon=Macro_Circle.png
|Description=Crée un cercle en donnant différents paramètres (sans interface graphique). Le nouveau cercle est créé dans les coordonnées réelles de l'objet et non dans celles du corps.<br/>{{ColoredText|(Ligne de commande, collez cette macro complète dans la console Python)}}.
|Author=mario52
|Version=0.4
|Date=2019-06-19
|FCVersion=Toutes
|Download=[https://www.freecadweb.org/wiki/images/9/9d/Macro_Circle.png Icône de la barre d'outils]
|SeeAlso=[[Macro_CirclePlus/fr|Macro CirclePlus]]
}}


==Description==
==Description==
Cette petite macro vous permet de créer un cercle en donnant comme argument différents paramètres comme le rayon, le diamètre, la circonférence, la surface, début d'angle, fin d'angle, arc, angle central, corde, flèche, point au centre du cercle au choix.


Cette petite macro vous permet de créer un cercle en donnant comme argument différents paramètres comme le rayon, le diamètre, la circonférence, la surface, angle de départ, angle de fin, arc, angle central, corde, flèche, point au centre du cercle, placement de l'objet au choix. La nouveau cercle est créée dans les coordonnées réelles de l'objet et non dans celles du corps.<br/> {{ColoredText|(Ligne de commande, collez cette macro complète dans la console Python)}}.
Le cercle fait toujours face à l'écran (avec la commande getCameraOrientation)


Le cercle fait toujours face à l'écran (avec la commande getCameraOrientation) (ou donner le placement)

<span id="Usage"></span>
==Utilisation==
==Utilisation==
Copiez le code et collez le dans la console Python de FreeCAD, la fonction sera disponible tout le temps de votre cession (vous pouvez aussi utiliser ce code dans une macro).
Donnez les paramètres au choix :


Copier le code et le coller dans la console Python de FreeCAD la commande est utilisée tout le temps à la disposition de FreeCAD ouvert
* '''x y z''' : coordinates of circle if not coordinates the circle is created on point 0,0,0
Donner le paramètre au choix :
*'''radius''' : radius of cicle

*'''diameter''' : diameter of circle
* '''x y z''' : coordonnées du cercle s'il n'y a pas de coordonnées, le cercle est créé aux coordonnées 0,0,0
*'''circumference''' : circumference of circle
*'''area''' : area of circle
*'''radius''' : rayon du cercle
*'''startangle''' : start angle for arc
*'''diameter''' : diamètre du cercle
*'''endangle''' : end angle for arc
*'''circumference''' : circonférence du cercle
*'''area''' : surface du cercle
*'''arc''' and '''anglecenter''' : arc in combination with anglecenter
** '''arc''' = length of arc
*'''startangle''' : début de l'angle de l'arc à créer
** '''anglecenter''' = angle of center circle to extremities of arc
*'''endangle''' : fin de l'angle de l'arc
*'''cord''' and '''arrow''' : cord in combination with arrow of circle
*'''arc''' et '''anglecenter''' : longueur de l'arc arc en combinaison avec angle central
** '''cord''' : length of cord of circle
** '''arc''' = longueur de l'arc
** '''anglecenter''' = angle central à partir du centre du cercle jusqu'aux deux extrémités de l'arc (l'angle est donné en degrés)
** '''arrow''' : length of arrow of circle
*'''cord''' et '''arrow''' : longueur de la corde en combinaison avec la longueur de la flèche
*'''center''' : if center as different 0 one point is created on center of circle
** '''cord''' : longueur de la corde du cercle
** '''arrow''' : longueur de la flèche du cercle
*'''center''' : si "center" est différent de 0 un point sera créé au centre du cercle
*'''placemObject''' : imposer le placement sous cette forme
** exemple :
** pl=FreeCAD.Placement()
** pl.Rotation.Q=(0.0,-0.0,-0.0,1.0)
** pl.Base=FreeCAD.Vector(-1.89847898483,-0.490152746439,0.0)
** et donner '''placemObject = pl'''


if there is no parameter "'''circle()'''" a list of functions is displayed in the report view
S'il n'y a pas de paramètre ex: "'''circle()'''" la liste des fonctions disponibles est affichée
<br /><br />
<br /><br />

'''Example entrance :'''
{{Code|code=
circle(arc=50,anglecenter=20,center=1)
circle(cord = 100,arrow = 20,center=1)
circle(circumference = 100,center=1)
}}
==Script==
==Script==

Icône de la barre d'outils [[Image:Macro_Circle.png]]

'''Macro_circle.FCMacro'''
'''Macro_circle.FCMacro'''


{{Code|code=
{{MacroCode|code=
# -*- coding: utf-8 -*-
#-*- coding: utf-8 -*-
#from math import sqrt, pi
# creer un cercle ou un arc entierement parametrabel en utilisant :
# creer un cercle ou un arc entierement parametrabel en utilisant :
# create a circle or arc fully parametrabel using:
# create a circle or arc fully parametrabel using:
#
# x y z coordinates
# paste the complete macro in the Python console
#
# x x x coordinates
#with radius
#with radius
#with diameter
#with diameter
Line 47: Line 71:
#with startangle
#with startangle
#with endangle
#with endangle
#with [arc and anglecenter] in combination
#with [arc and anglecenter] in combination (angle in degrees)
#with [cord and arrow] in combination
#with [cord and arrow] in combination
#with center (if center as different 0 one point is created on center of circle)
#with center (if center as different 0 one point is created on center of circle)
#give placemObject
# ex :pl=FreeCAD.Placement()
# pl.Rotation.Q=(0.0,-0.0,-0.0,1.0)
# pl.Base=FreeCAD.Vector(-1.89847898483,-0.490152746439,0.0)
# placemObject = pl
# s'il n'y a pas de parametre "circle()" une liste des fonctions s'affiche dans la Vue rapport
# s'il n'y a pas de parametre "circle()" une liste des fonctions s'affiche dans la Vue rapport
# if there is no parameter "circle()" a list of functions is displayed in the report view
# if there is no parameter "circle()" a list of functions is displayed in the report view
Line 55: Line 84:
__title__ = "circle"
__title__ = "circle"
__author__ = "Mario52"
__author__ = "Mario52"
__version__ = "0.4"
__date__ = "31/01/2015"
__date__ = "19/06/2019"


import Draft #, Part
import Draft #, Part
import FreeCAD
def circle(x=0.0,y=0.0,z=0.0,radius=0.0,diameter=0.0,circumference=0.0,area=0.0,startangle=0.0,endangle=0.0,arc=0.0,anglecenter=0.0,cord=0.0,arrow=0.0,center=0):
App = FreeCAD
from math import sqrt, pi
pl = FreeCAD.Placement()
pl.Rotation = FreeCADGui.ActiveDocument.ActiveView.getCameraOrientation()
pl.Base=FreeCAD.Vector(x,y,z)


def circle(x=0.0,y=0.0,z=0.0,radius=0.0,diameter=0.0,circumference=0.0,area=0.0,startangle=0.0,endangle=0.0,arc=0.0,anglecenter=0.0,cord=0.0,arrow=0.0,center=0,placemObject=""):
from math import sqrt, pi
if placemObject == "":
pl = FreeCAD.Placement()
pl.Rotation = FreeCADGui.ActiveDocument.ActiveView.getCameraOrientation()
pl.Base = FreeCAD.Vector(x,y,z)
else:
pl = FreeCAD.Placement()
pl = placemObject # placement imposted
if diameter != 0: # with diameter
if diameter != 0: # with diameter
radius = diameter / 2
radius = diameter / 2.0
elif circumference != 0: # with circumference
elif circumference != 0: # with circumference
radius = (circumference / pi) / 2
radius = (circumference / pi) / 2.0
elif area != 0: # with area
elif area != 0: # with area
radius = sqrt((area / pi))
radius = sqrt((area / pi))
elif (cord != 0) and (arrow != 0): # with cord and arrow
elif (cord != 0) and (arrow != 0): # with cord and arrow
radius = ((arrow**2) + (cord**2) / 4) / (arrow*2)
radius = ((arrow**2) + (cord**2) / 4.0) / (arrow*2)
elif (arc != 0) and (anglecenter != 0): # with arc and anglecenter central
elif (arc != 0) and (anglecenter != 0): # with arc and anglecenter central in degrees
radius = ((360/anglecenter)*arc) / pi/2
radius = ((360/anglecenter)*arc) / pi/2.0
if endangle != 0:
if endangle != 0:
startangle = endangle - anglecenter
startangle = endangle - anglecenter
endangle = anglecenter + startangle
endangle = anglecenter + startangle
startangle = endangle - anglecenter
startangle = endangle - anglecenter

if radius != 0:
if radius != 0:
try:
Draft.makeCircle(radius,placement=pl,face=False,startangle=startangle,endangle=endangle,support=None)
Draft.makeCircle(radius,placement=pl,face=False,startangle=startangle,endangle=endangle,support=None)
if center != 0:
Draft.makePoint(x,y,z)
if center != 0:
x=pl.Base.x
y=pl.Base.y
z=pl.Base.z
Draft.makePoint(x,y,z)
except Exception:
App.Console.PrintError("Unexpected keyword argument" + "\n")
App.ActiveDocument.recompute()
else:
else:
App.Console.PrintMessage("unexpected keyword argument" + "\n")
App.Console.PrintMessage("Unexpected keyword argument" + "\n")
App.Console.PrintMessage("circle(x,y,z,radius,diameter,circumference,area,startangle,endangle,[arc,anglecenter],[cord,arrow],center)" + "\n")
App.Console.PrintMessage("circle(x,y,z,radius,diameter,circumference,area,startangle,endangle,[arc,anglecenter],[cord,arrow],center,placemObject)" + "\n")
App.Console.PrintMessage("circle(radius=10.0,placemObject=App.Placement(App.Vector(11,20,30), App.Rotation(30,40,0), App.Vector(0,0,0)))" + "\n")

#example
#example
#circle(arc=50,anglecenter=20,center=1)
#circle(arc=50,anglecenter=20,center=1)
#circle(x=10.0,y=10.0,z=10.0,radius=10.0)
#circle(radius=10.0,center=1,placemObject=App.Placement(App.Vector(11,20,30), App.Rotation(30,40,0), App.Vector(0,0,0)))

}}
}}

==Memo of circle==
<span id="Memo_of_circle"></span>
'''Examples codes'''
==Memo sur le cercle==

'''Exemples de codes'''

{{Code|code=
{{Code|code=
circle(radius=10)
circle(radius=10) # example 1
circle(x=15,diameter=20)
circle(x=15,diameter=20) # example 2
circle(y=45,circumference=100)
circle(y=45,circumference=100) # example 3
}}
}}

[[File:Macro Circle 01.png|640px|center|examples]]
[[File:Macro Circle 01.png|640px|center|examples 1, 2, 3]]
{{clear}}
{{clear}}


{{Code|code=
{{Code|code=
circle(y=-15,area=100)
circle(y=-15,area=100) # example 4
circle(y=-15,x=15,startangle=60,endangle=-20,center=1)
circle(y=-15,x=15,startangle=60,endangle=-20,center=1) # example 5
circle(y=-15,x=45,cord=9,arrow=3,center=1)
circle(y=-15,x=45,cord=9,arrow=3,center=1) # example 6 left
circle(x=65,y=-15,arc=3.5,anglecenter=40,startangle=20,center=1)
circle(x=65,y=-15,arc=3.5,anglecenter=40,startangle=20,center=1) # example 6 rigth
}}
}}

[[File:Macro Circle 02.png|640px|center|examples]]
[[File:Macro Circle 02.png|640px|center|examples]]


{{clear}}
{{clear}}
==Version==
<languages/>

ver 0.4 19/06/2019 : mise à jour version 0.19

ver 0.3 10/06/2018 : remplacement de /2 par /2.0 (flottant)

ver 0.2 24/02/2015 : ajout de la fonction "'''placemObject'''"

Latest revision as of 12:33, 29 December 2023

Other languages:

Macro Circle

Description
Crée un cercle en donnant différents paramètres (sans interface graphique). Le nouveau cercle est créé dans les coordonnées réelles de l'objet et non dans celles du corps.
(Ligne de commande, collez cette macro complète dans la console Python).

Version macro : 0.4
Date dernière modification : 2019-06-19
Version FreeCAD : Toutes
Téléchargement : Icône de la barre d'outils
Auteur: mario52
Auteur
mario52
Téléchargement
Icône de la barre d'outils
Liens
Version Macro
0.4
Dernière modification
2019-06-19
Version(s) FreeCAD
Toutes
Raccourci clavier
None
Voir aussi
Macro CirclePlus

Description

Cette petite macro vous permet de créer un cercle en donnant comme argument différents paramètres comme le rayon, le diamètre, la circonférence, la surface, angle de départ, angle de fin, arc, angle central, corde, flèche, point au centre du cercle, placement de l'objet au choix. La nouveau cercle est créée dans les coordonnées réelles de l'objet et non dans celles du corps.
(Ligne de commande, collez cette macro complète dans la console Python).

Le cercle fait toujours face à l'écran (avec la commande getCameraOrientation) (ou donner le placement)

Utilisation

Copier le code et le coller dans la console Python de FreeCAD la commande est utilisée tout le temps à la disposition de FreeCAD ouvert Donner le paramètre au choix :

  • x y z : coordonnées du cercle s'il n'y a pas de coordonnées, le cercle est créé aux coordonnées 0,0,0
  • radius : rayon du cercle
  • diameter : diamètre du cercle
  • circumference : circonférence du cercle
  • area : surface du cercle
  • startangle : début de l'angle de l'arc à créer
  • endangle : fin de l'angle de l'arc
  • arc et anglecenter : longueur de l'arc arc en combinaison avec angle central
    • arc = longueur de l'arc
    • anglecenter = angle central à partir du centre du cercle jusqu'aux deux extrémités de l'arc (l'angle est donné en degrés)
  • cord et arrow : longueur de la corde en combinaison avec la longueur de la flèche
    • cord : longueur de la corde du cercle
    • arrow : longueur de la flèche du cercle
  • center : si "center" est différent de 0 un point sera créé au centre du cercle
  • placemObject : imposer le placement sous cette forme
    • exemple :
    • pl=FreeCAD.Placement()
    • pl.Rotation.Q=(0.0,-0.0,-0.0,1.0)
    • pl.Base=FreeCAD.Vector(-1.89847898483,-0.490152746439,0.0)
    • et donner placemObject = pl

S'il n'y a pas de paramètre ex: "circle()" la liste des fonctions disponibles est affichée

Script

Icône de la barre d'outils

Macro_circle.FCMacro

#-*- coding: utf-8 -*-
#from math import sqrt, pi
# creer un cercle ou un arc entierement parametrabel en utilisant :
# create a circle or arc fully parametrabel using:
#
# paste the complete macro in the Python console
#
# x x x coordinates
#with radius
#with diameter
#with circumference
#with area
#with startangle
#with endangle
#with [arc and anglecenter]      in combination (angle in degrees)
#with [cord and arrow]           in combination
#with center (if center as different 0 one point is created on center of circle)
#give placemObject  
# ex :pl=FreeCAD.Placement()
#     pl.Rotation.Q=(0.0,-0.0,-0.0,1.0)
#     pl.Base=FreeCAD.Vector(-1.89847898483,-0.490152746439,0.0)
#     placemObject = pl
# s'il n'y a pas de parametre "circle()" une liste des fonctions s'affiche dans la Vue rapport
# if there is no parameter "circle()" a list of functions is displayed in the report view

__title__   = "circle"
__author__  = "Mario52"
__version__ = "0.4"
__date__    = "19/06/2019"

import Draft #, Part
import FreeCAD
App = FreeCAD

def circle(x=0.0,y=0.0,z=0.0,radius=0.0,diameter=0.0,circumference=0.0,area=0.0,startangle=0.0,endangle=0.0,arc=0.0,anglecenter=0.0,cord=0.0,arrow=0.0,center=0,placemObject=""):
    from math import sqrt, pi
    if placemObject == "":
        pl = FreeCAD.Placement()
        pl.Rotation = FreeCADGui.ActiveDocument.ActiveView.getCameraOrientation()   
        pl.Base = FreeCAD.Vector(x,y,z)
    else:
        pl = FreeCAD.Placement()
        pl = placemObject                                  # placement imposted
    if diameter != 0:                                      # with diameter
        radius = diameter / 2.0
    elif circumference != 0:                               # with circumference
        radius = (circumference / pi) / 2.0
    elif area != 0:                                        # with area
        radius =  sqrt((area / pi))
    elif (cord != 0) and (arrow != 0):                     # with cord and arrow
        radius = ((arrow**2) + (cord**2) / 4.0) / (arrow*2) 
    elif (arc != 0) and (anglecenter != 0):                # with arc and anglecenter central in degrees
        radius = ((360/anglecenter)*arc) / pi/2.0
        if endangle != 0:
            startangle  = endangle - anglecenter
        endangle   = anglecenter + startangle
        startangle  = endangle - anglecenter
    if radius != 0:
        try:
            Draft.makeCircle(radius,placement=pl,face=False,startangle=startangle,endangle=endangle,support=None)
            if center != 0:
                x=pl.Base.x
                y=pl.Base.y
                z=pl.Base.z
                Draft.makePoint(x,y,z)
            
        except Exception:
            App.Console.PrintError("Unexpected keyword argument" + "\n")
        App.ActiveDocument.recompute()
    else:
        App.Console.PrintMessage("Unexpected keyword argument" + "\n")
        App.Console.PrintMessage("circle(x,y,z,radius,diameter,circumference,area,startangle,endangle,[arc,anglecenter],[cord,arrow],center,placemObject)" + "\n")
        App.Console.PrintMessage("circle(radius=10.0,placemObject=App.Placement(App.Vector(11,20,30), App.Rotation(30,40,0), App.Vector(0,0,0)))" + "\n")
#example
#circle(arc=50,anglecenter=20,center=1)
#circle(x=10.0,y=10.0,z=10.0,radius=10.0)
#circle(radius=10.0,center=1,placemObject=App.Placement(App.Vector(11,20,30), App.Rotation(30,40,0), App.Vector(0,0,0)))

Memo sur le cercle

Exemples de codes

circle(radius=10)    # example 1
circle(x=15,diameter=20)    # example 2
circle(y=45,circumference=100)    # example 3
examples 1, 2, 3
examples 1, 2, 3
circle(y=-15,area=100)    # example 4
circle(y=-15,x=15,startangle=60,endangle=-20,center=1)    # example 5
circle(y=-15,x=45,cord=9,arrow=3,center=1)    # example 6 left
circle(x=65,y=-15,arc=3.5,anglecenter=40,startangle=20,center=1)    # example 6 rigth
examples
examples

Version

ver 0.4 19/06/2019 : mise à jour version 0.19

ver 0.3 10/06/2018 : remplacement de /2 par /2.0 (flottant)

ver 0.2 24/02/2015 : ajout de la fonction "placemObject"