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 >

template<typename genType >

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