Vector API/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{VeryImportantMessage |(Octobre 2019) Ne modifiez pas cette page. L'information est incomplète et obsolète. Pour la dernière API, consultez la [https://www.freecadweb.org/api documentation de l'API générée automatiquement], ou générez la documentation vous-même, voir [[Source documentation/fr|Source documentation]].}}
{{VeryImportantMessage|(Octobre 2019) Ne modifiez pas cette page. L'information est incomplète et obsolète. Pour la dernière API, consultez la [https://www.freecadweb.org/api documentation de l'API générée automatiquement], ou générez la documentation vous-même, voir [[Source_documentation/fr|Documentation du code source]].}}


Les vecteurs sont utilisés partout dans FreeCAD.
Les vecteurs sont utilisés partout dans FreeCAD.


Exemple:
Exemple :
{{Code|code=
{{Code|code=
v=FreeCAD.Vector()
v=FreeCAD.Vector()
Line 15: Line 16:


{{APIProperty|Length|renvoie la longueur du vecteur.}}
{{APIProperty|Length|renvoie la longueur du vecteur.}}
{{APIFunction|add|Vector|ajoute un autre vecteur à celui-ci|. La somme de deux vecteurs.|vecteur}}
{{APIFunction|add|Vector|ajoute un autre vecteur à celui-ci|vecteur}}
{{APIFunction|distanceToPoint|Vector|la distance entre ce vecteur et un autre.|virgule flottante}}
{{APIFunction |cross|Vector|le produit croisé entre ce vecteur et un autre.|vecteur}}
{{APIFunction |cross|Vector|le produit croisé entre ce vecteur et un autre.|vecteur}}
{{APIFunction|distanceToLine|Vector1, Vector2|la distance entre le vecteur et une ligne passant par Vecteur1 dans la direction Vecteur2.|float}}
{{APIFunction|distanceToLine|Vector1, Vector2|la distance entre le vecteur et une ligne passant par Vecteur1 dans la direction Vecteur2.|virgule flottante}}
{{APIFunction|distanceToLineSegment|Vector1,Vector2|un vecteur au point le plus proche sur un segment de ligne de Vector1 à Vector2.|vecteur}}
{{APIFunction|distanceToLineSegment|Vector1,Vector2|un vecteur au point le plus proche sur un segment de ligne de Vector1 à Vector2.|vecteur}}
{{APIFunction|distanceToPlane|Vector1, Vector2|la distance entre le vecteur et un plan défini par un point et une normale.|float}}
{{APIFunction|distanceToPlane|Vector1, Vector2|la distance entre le vecteur et un plan défini par un point et une normale.|virgule flottante}}
{{APIFunction|dot|Vector||le produit scalaire entre deux vecteurs.|float}}
{{APIFunction|dot|Vector|le produit scalaire entre deux vecteurs.|virgule flottante}}
{{APIFunction|getAngle|Vector|l'angle en radians entre ce vecteur et un autre.|float}}
{{APIFunction|getAngle|Vector|l'angle en radians entre ce vecteur et un autre.|virgule flottante}}
{{APIFunction|isEqual|Vector2,tolerance|vérifie si la distance entre les points représentés par ce Vector et Vector2 est inférieure ou égale à la tolérance donnée.|vrai/faux}}
{{APIFunction|multiply|Float|multiplie (échelles) un vecteur par le facteur donné.|Rien.}}
{{APIFunction|normalize| |normalise un vecteur (fixe sa longueur à 1,0).|Rien}}
{{APIFunction|isNormal|Vector2,tolerance|vérifie si ce vecteur est normal à Vector2 dans les limites de la tolérance.|vrai/faux}}
{{APIFunction|projectToLine|Vector1, Vector2 |projette le vecteur sur une ligne entre Vecteur1 et Vector2.|Rien}}
{{APIFunction|isOnLineSegment|Vector1,Vector2|vérifie si ce vecteur est sur le segment de ligne généré par Vector1 et Vector2.|vecteur}}
{{APIFunction|projectToPlan|Vector1, Vector2| projette le vecteur sur un plan défini par un point et un normal|Rien.}}
{{APIFunction|isParallel|Vector2,tolerance|vérifie si ce vecteur est parallèle à Vector2 dans la limite de la tolérance.|vrai/faux}}
{{APIFunction|multiply|Float|multiplie (échelles) un vecteur par le facteur donné.|rien}}
{{APIFunction|scale|Float,Float,Float|même que multipy, mais permet de spécifier des valeurs différentes pour les directions x, y et z. (non-uniform scale)|Rien.}}
{{APIFunction |sub|Vector | soustrait un autre vecteur du premier.|vector}}
{{APIFunction|negative|Vector|renvoie le négatif (opposé) de ce vecteur.|vecteur}}
{{APIFunction|normalize| |normalise un vecteur (fixe sa longueur à 1,0).|rien}}
{{APIFunction|projectToLine|Vector1, Vector2 |projette le vecteur sur une ligne entre Vecteur1 et Vector2.|rien}}
{{APIFunction|projectToPlan|Vector1, Vector2| projette le vecteur sur un plan défini par un point et un normal|rien}}
{{APIFunction|scale|Float,Float,Float|comme multiply, mais permet de spécifier des valeurs différentes pour les directions x, y et z. (échelle non uniforme)|rien}}
{{APIFunction |sub|Vector|soustrait un autre vecteur du premier.|vecteur}}
{{APIProperty|x|la coordonnée x d'un vecteur.}}
{{APIProperty|x|la coordonnée x d'un vecteur.}}
{{APIProperty |y|la coordonnée y d'un vecteur.}}
{{APIProperty |y|la coordonnée y d'un vecteur.}}

Latest revision as of 20:40, 16 January 2024

Other languages:
(Octobre 2019) Ne modifiez pas cette page. L'information est incomplète et obsolète. Pour la dernière API, consultez la documentation de l'API générée automatiquement, ou générez la documentation vous-même, voir Documentation du code source.

Les vecteurs sont utilisés partout dans FreeCAD.

Exemple :

v=FreeCAD.Vector()
v=FreeCAD.Vector(1,0,0)
v=FreeCAD.Base.Vector()
v2 = FreeCAD.Vector(3,2,-5)
v3 = v.add(v2)
print v3.Length
Length

Returns: renvoie la longueur du vecteur.

add(Vector)

Description: ajoute un autre vecteur à celui-ci

Returns: vecteur

distanceToPoint(Vector)

Description: la distance entre ce vecteur et un autre.

Returns: virgule flottante

cross(Vector)

Description: le produit croisé entre ce vecteur et un autre.

Returns: vecteur

distanceToLine(Vector1, Vector2)

Description: la distance entre le vecteur et une ligne passant par Vecteur1 dans la direction Vecteur2.

Returns: virgule flottante

distanceToLineSegment(Vector1,Vector2)

Description: un vecteur au point le plus proche sur un segment de ligne de Vector1 à Vector2.

Returns: vecteur

distanceToPlane(Vector1, Vector2)

Description: la distance entre le vecteur et un plan défini par un point et une normale.

Returns: virgule flottante

dot(Vector)

Description: le produit scalaire entre deux vecteurs.

Returns: virgule flottante

getAngle(Vector)

Description: l'angle en radians entre ce vecteur et un autre.

Returns: virgule flottante

isEqual(Vector2,tolerance)

Description: vérifie si la distance entre les points représentés par ce Vector et Vector2 est inférieure ou égale à la tolérance donnée.

Returns: vrai/faux

isNormal(Vector2,tolerance)

Description: vérifie si ce vecteur est normal à Vector2 dans les limites de la tolérance.

Returns: vrai/faux

isOnLineSegment(Vector1,Vector2)

Description: vérifie si ce vecteur est sur le segment de ligne généré par Vector1 et Vector2.

Returns: vecteur

isParallel(Vector2,tolerance)

Description: vérifie si ce vecteur est parallèle à Vector2 dans la limite de la tolérance.

Returns: vrai/faux

multiply(Float)

Description: multiplie (échelles) un vecteur par le facteur donné.

Returns: rien

negative(Vector)

Description: renvoie le négatif (opposé) de ce vecteur.

Returns: vecteur

normalize( )

Description: normalise un vecteur (fixe sa longueur à 1,0).

Returns: rien

projectToLine(Vector1, Vector2 )

Description: projette le vecteur sur une ligne entre Vecteur1 et Vector2.

Returns: rien

projectToPlan(Vector1, Vector2)

Description: projette le vecteur sur un plan défini par un point et un normal

Returns: rien

scale(Float,Float,Float)

Description: comme multiply, mais permet de spécifier des valeurs différentes pour les directions x, y et z. (échelle non uniforme)

Returns: rien

sub(Vector)

Description: soustrait un autre vecteur du premier.

Returns: vecteur

x

Returns: la coordonnée x d'un vecteur.

y

Returns: la coordonnée y d'un vecteur.

z

Returns: la coordonnée z d'un vecteur.