VS:DotProduct

.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix

Description

Returns the dot product of the two specified vectors.

The dot product is also known as the scalar product of the two vectors, and is equivalent to the product of the magnitudes of the two vectors multiplied by the cosine of the angle between the two vectors.

FUNCTION DotProduct(
           v1   :VECTOR;
           v2   :VECTOR) : REAL;

def vs.DotProduct(v1, v2):
    return REAL

Parameters

v1		VECTOR		Source vector 1.
v2		VECTOR		Source vector 2.

Return Value

Returns the scalar, or dot, product of the vectors v1 and v2.

Remarks

This should be used in place of the bullet/yen operator for better cross-platform operability. - PCP

Example

VectorScript

PROCEDURE Example;
VAR
pt1, pt2, pt3, pt4 :VECTOR;
ang :REAL;
BEGIN
GetPt(pt1.x, pt1.y);
GetPtL(pt1.x, pt1.y, pt2.x, pt2.y);
GetPtL(pt2.x, pt2.y, pt3.x, pt3.y);
MoveTo(pt1.x, pt1.y);
LineTo(pt2.x, pt2.y);
LineTo(pt3.x, pt3.y);
pt4 := (pt1 + pt3) / 2;
{Find the angle between the vectors.}
ang := Rad2Deg(ArcCos(DotProduct(UnitVec(pt1-pt2), UnitVec(pt3-pt2))));
TextOrigin(pt4.x, pt4.y);
CreateText(Concat(ang));
END;
RUN(Example);

Version

Availability: from VectorWorks8.0

See Also

VS Functions:

VS:AngBVec

VS Functions: [[VS:AngBVec]]