# Angle and Trigonometry Functions

Angle and Trigonometry Functions
GLM Core

## Functions

template<typename genType >
genType | acos (genType const &x)
template<typename genType >
genType | acosh (genType const &x)
template<typename genType >
genType | asin (genType const &x)
template<typename genType >
genType | asinh (genType const &x)
template<typename genType >
genType | atan (genType const &y, genType const &x)
template<typename genType >
genType | atan (genType const &y_over_x)
template<typename genType >
genType | atanh (genType const &x)
template<typename genType >
genType | cos (genType const &angle)
template<typename genType >
genType | cosh (genType const &angle)
template<typename genType >
genType | degrees (genType const &radians)
template<typename genType >
genType | radians (genType const &degrees)
template<typename genType >
genType | sin (genType const &angle)
template<typename genType >
genType | sinh (genType const &angle)
template<typename genType >
genType | tan (genType const &angle)
template<typename genType >
genType | tanh (genType const &angle)

## Detailed Description

Function parameters specified as angle are assumed to be in units of radians.

In no case will any of these functions result in a divide by zero error. If the divisor of a ratio is 0, then results will be undefined.

These all operate component-wise. The description is per component.

## Function Documentation

genType glm::acos | ( | genType const & | x | ) |

Arc cosine.

Returns an angle whose sine is x. The range of values returned by this function is [0, PI]. Results are undefined if |x| > 1.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL acos man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::acosh | ( | genType const & | x | ) |

Arc hyperbolic cosine; returns the non-negative inverse of cosh.

Results are undefined if x < 1.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL acosh man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::asin | ( | genType const & | x | ) |

Arc sine.

Returns an angle whose sine is x. The range of values returned by this function is [-PI/2, PI/2]. Results are undefined if |x| > 1.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL asin man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::asinh | ( | genType const & | x | ) |

Arc hyperbolic sine; returns the inverse of sinh.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL asinh man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::atan | ( | genType const & | y,
|  | genType const & | x
| ) |  |

Arc tangent.

Returns an angle whose tangent is y/x. The signs of x and y are used to determine what quadrant the angle is in. The range of values returned by this function is [-PI, PI]. Results are undefined if x and y are both 0.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL atan man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

Referenced by glm::atan2().

genType glm::atan | ( | genType const & | y_over_x | ) |

Arc tangent.

Returns an angle whose tangent is y_over_x. The range of values returned by this function is [-PI/2, PI/2].

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL atan man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::atanh | ( | genType const & | x | ) |

Arc hyperbolic tangent; returns the inverse of tanh.

Results are undefined if abs(x) >= 1.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL atanh man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::cos | ( | genType const & | angle | ) |

The standard trigonometric cosine function.

The values returned by this function will range from [-1, 1].

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL cos man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::cosh | ( | genType const & | angle | ) |

Returns the hyperbolic cosine function, (exp(x) + exp(-x)) / 2.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL cosh man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::degrees | ( | genType const & | radians | ) |

Converts radians to degrees and returns the result.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL degrees man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::radians | ( | genType const & | degrees | ) |

Converts degrees to radians and returns the result.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL radians man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::sin | ( | genType const & | angle | ) |

The standard trigonometric sine function.

The values returned by this function will range from [-1, 1].

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL sin man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::sinh | ( | genType const & | angle | ) |

Returns the hyperbolic sine function, (exp(x) - exp(-x)) / 2.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL sinh man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::tan | ( | genType const & | angle | ) |

The standard trigonometric tangent function.

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL tan man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions

genType glm::tanh | ( | genType const & | angle | ) |

Returns the hyperbolic tangent function, sinh(angle) / cosh(angle)

Template Parameters

  genType | Floating-point scalar or vector types.

See Also
  GLSL tanh man page
  GLSL 4.20.8 specification, section 8.1 Angle and Trigonometry Functions