# 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".

##### © Copyright YoYo Games Ltd. 2015 All Rights Reserved