dot_product_normalised

Returns the normalised dot_product of the vectors x1,y1 and x2,y2.


Syntax:

dot_product_normalised(x1, y1, x2, y2)


Argument Description
x1 The x coordinate of the first vector.
y1 The y coordinate of the first vector.
x2 The x coordinate of the second vector.
y2 The y coordinate of the second vector.


Returns: Real


Description

The dot product is a value expressing the angular relationship between two vectors and is found by taking two vectors, multiplying them together and then adding the results. The name "dot product" is derived from the centered dot "·" that is often used to designate this operation (the alternative name "scalar product" emphasizes the scalar rather than vector nature of the result).

The actual mathematical formula can be written like this:


So, in 2D the dot product of vectors a[x1,y1] and b[x2,2] is x1x2 + y1y2, meaning that the dot_product in GameMaker: Studio is calculated as:

a · b = (x1*x2)+(y1*y2);

What about the normalised dot product? The normalised dot product has been corrected in such a way as to bring the return value into the range of -1 and 1 (see Normalised Vectors for more detailed information), which is exceptionally useful in many circumstances, particularly when dealing with lighting and other 3D functions.


Example:

var x1, y1, x2, y2;
x1 = lengthdir_x(1, image_angle);
y1 = lengthdir_y(1, image_angle);
x2 = o_Player.x - x;
y2 = o_Player.y - y;
if dot_product_normalised(x1, y1, x2, y2) > 0 seen=true else seen=false;

The above code creates a vector using the instances image angle, and then gets the vector of the player object "o_Player" to itself. Finally it calculates the dot product of these two vectors and if it is greater than 0 it sets the variable "seen" to true, and if it is equal to or less than 0 it sets it to "false".


Back: Vector Functions
Next: dot_product_3d_normalised
© Copyright YoYo Games Ltd. 2018 All Rights Reserved