Vector API: Difference between revisions
mNo edit summary |
Tag: Undo |
||
(15 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
<translate> |
|||
<!--T:1--> |
|||
{{VeryImportantMessage|(October 2019) Do not edit this page. The information is incomplete and outdated. For the latest API, see the [https://www.freecadweb.org/api autogenerated API documentation], or generate the documentation yourself, see [[Source documentation|Source documentation]].}} |
|||
<!--T:20--> |
|||
Vectors are used everywhere in FreeCAD. |
Vectors are used everywhere in FreeCAD. |
||
<!--T:2--> |
|||
Example: |
Example: |
||
</translate> |
|||
⚫ | |||
{{Code|code= |
|||
⚫ | |||
v=FreeCAD.Vector() |
|||
v=FreeCAD.Vector(1,0,0) |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
}} |
|||
<translate> |
|||
<!--T:3--> |
|||
{{APIProperty|Length|returns the length of the vector.}} |
{{APIProperty|Length|returns the length of the vector.}} |
||
⚫ | |||
{{APIFunction| |
{{APIFunction|cross|Vector|the crossproduct between this vector and another.|vector}} |
||
⚫ | |||
{{APIFunction|distanceToLineSegment|Vector1,Vector2|a vector to the closest point on a line segment from Vector1 to Vector2.|vector}} |
|||
⚫ | |||
⚫ | |||
{{APIFunction| |
{{APIFunction|dot|Vector|the dot product between 2 vectors.|float}} |
||
⚫ | |||
{{APIFunction| |
{{APIFunction|multiply|Float|multiplies (uniform scale) a vector by the given factor.|nothing}} |
||
⚫ | |||
{{APIFunction| |
{{APIFunction|projectToLine|Vector1,Vector2|projects the vector on a line through Vector1 in direction Vector2.|nothing}} |
||
{{APIFunction|projectToPlane|Vector1,Vector2|projects the vector on a plane defined by a point (Vector1) and a normal (Vector2).|nothing}} |
|||
⚫ | |||
{{APIFunction|getAngle|Vector| |the angle in radians between 2 vectors.}} |
|||
{{APIFunction|sub|Vector|subtracts another vector from this one.|vector}} |
|||
{{APIFunction|multiply|Float|multiplies (scales) a vector by the given factor|nothing.}} |
|||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
{{APIProperty|x|the x coordinate of a vector.}} |
{{APIProperty|x|the x coordinate of a vector.}} |
||
{{APIProperty|y|the y coordinate of a vector.}} |
{{APIProperty|y|the y coordinate of a vector.}} |
||
{{APIProperty|z|the z coordinate of a vector.}} |
{{APIProperty|z|the z coordinate of a vector.}} |
||
</translate> |
|||
{{languages | {{es|Vector_API/es}} }} |
|||
{{Userdocnavi{{#translation:}}}} |
|||
[[Category:API]] |
[[Category:API{{#translation:}}]] |
||
[[Category:Poweruser Documentation{{#translation:}}]] |
|||
{{clear}} |
Revision as of 13:07, 25 July 2022
Vectors are used everywhere in FreeCAD.
Example:
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
Description: the distance between the vector and a line through Vector1 in direction Vector2.
Returns: float
Description: a vector to the closest point on a line segment from Vector1 to Vector2.
Returns: vector
Description: the distance between the vector and a plane defined by a point and a normal.
Returns: float
Description: multiplies (uniform scale) a vector by the given factor.
Returns: nothing
Description: projects the vector on a line through Vector1 in direction Vector2.
Returns: nothing
Description: projects the vector on a plane defined by a point (Vector1) and a normal (Vector2).
Returns: nothing
Description: Same as multiply but lets specify different values for x, y and z directions. (non-uniform scale)
Returns: nothing
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub