dot_product_normalised_3d

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

Syntax:

dot_product_normalised_3d(x1, y1, z1, x2, y2, z2)


Argument Description
x1 The x coordinate of the first vector.
y1 The y coordinate of the first vector.
z1 The z coordinate of the first vector.
x2 The x coordinate of the second vector.
y2 The y coordinate of the second vector.
z2 The z 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:


In 2D, the dot product of vectors a[x1,y1] and b[x2,y2] is x1x2 + y1y2, so in 3D, the dot product of vectors a[x1,y1,z1] and b[x1,y1,z1] is x1x2 + y1y2 + z1z2. So, the dot_product_3d in GameMaker: Studio is calculated as:

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

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 = 0;
y1 = 1;
z1 = 0;
x2 = o_Player.x - x;
y2 = o_Player.y - y;
z2 = o_Player.z - z;
if dot_product_normalised_3d(x1, y1, z1, x2, y2, z2) > 0 above=true else above=false;

The above code creates a vector normal along the instances y (up) axis, 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 tan 0 it sets the variable "above" to true, and if it is less than or equal to 0 it sets it to "false".


Back: Vector Functions
Next: angle_difference
© Copyright YoYo Games Ltd. 2015 All Rights Reserved