Vector API/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Vector API")
 
(Updating to match new version of source page)
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
Vectors are used everywhere in FreeCAD.
{{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]].}}


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

<pre>
Exemple:
{{Code|code=
v=FreeCAD.Vector()
v=FreeCAD.Vector()
v=FreeCAD.Vector(1,0,0)
v=FreeCAD.Vector(1,0,0)
Line 9: Line 12:
v3 = v.add(v2)
v3 = v.add(v2)
print v3.Length
print v3.Length
}}
</pre>


{{APIProperty|Length|renvoie la longueur du vecteur.}}
{{APIFunction|add|Vector|ajoute un autre vecteur à celui-ci|. La somme de deux vecteurs.|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|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|dot|Vector||le produit scalaire entre deux vecteurs.|float}}
{{APIFunction|getAngle|Vector|l'angle en radians entre ce vecteur et un autre.|float}}
{{APIFunction|multiply|Float|multiplie (échelles) un vecteur par le facteur donné.|Rien.}}
{{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|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}}
{{APIProperty|x|la coordonnée x d'un vecteur.}}
{{APIProperty |y|la coordonnée y d'un vecteur.}}
{{APIProperty|z|la coordonnée z d'un vecteur.}}


{{Userdocnavi{{#translation:}}}}
{{APIProperty|Length|returns the length of the vector.}}
[[Category:API{{#translation:}}]]
{{APIFunction|add|Vector|adds another vector to this one|the sum of both vectors.}}
[[Category:Poweruser Documentation{{#translation:}}]]
{{APIFunction|cross|Vector| |the crossproduct between two vectors.}}
{{APIFunction|distanceToLine|Vector1,Vector2| |the distance between the vector and a line between Vector1 and Vector2.}}
{{APIFunction|distanceToPlane|Vector1,Vector2| |the distance between the vector and a plane defined by a point and a normal.}}
{{APIFunction|dot|Vector| |the dot product between 2 vectors.}}
{{APIFunction|getAngle|Vector| |the angle in radians between 2 vectors.}}
{{APIFunction|multiply|Float|multiplies (scales) a vector by the given factor|nothing.}}
{{APIFunction|normalize| |normalizes a vector (sets its length to 1.0).|nothing.}}
{{APIFunction|projectToLine|Vector1,Vector2|projects the vector on a line between Vector1 and Vector2.|nothing.}}
{{APIFunction|projectToPlane|Vector1,Vector2|projects the vector on a plane defined by a point and a normal.|nothing.}}
{{APIFunction|scale|Float,Float,Float|Same as multiply but lets specify different values for x, y and z directions.|nothing.}}
{{APIFunction|sub|Vector|subtracts another vector from the first one.|the resulting vector.}}
{{APIProperty|x|the x coordinate of a vector.}}
{{APIProperty|y|the y coordinate of a vector.}}
{{APIProperty|z|the z coordinate of a vector.}}

[[Category:API]]

{{clear}}
{{clear}}
<languages/>

Revision as of 20:48, 27 February 2020

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 Source documentation.

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: . La somme de deux vecteurs.

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: float

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: float

dot(Vector)

Description:

Returns: le produit scalaire entre deux vecteurs.

getAngle(Vector)

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

Returns: float

multiply(Float)

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

Returns: Rien.

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: même que multipy, mais permet de spécifier des valeurs différentes pour les directions x, y et z. (non-uniform scale)

Returns: Rien.

sub(Vector )

Description: soustrait un autre vecteur du premier.

Returns: vector

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.