/***************************************************************************/
/*                                                                         */
/*  fttrigon.h                                                             */
/*                                                                         */
/*    FreeType trigonometric functions (specification).                    */
/*                                                                         */
/*  Copyright 2001 by                                                      */
/*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
/*                                                                         */
/*  This file is part of the FreeType project, and may only be used,       */
/*  modified, and distributed under the terms of the FreeType project      */
/*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
/*  this file you indicate that you have read the license and              */
/*  understand and accept it fully.                                        */
/*                                                                         */
/***************************************************************************/


#ifndef __FTTRIGON_H__
#define __FTTRIGON_H__

#include FT_FREETYPE_H


FT_BEGIN_HEADER


  /*************************************************************************/
  /*                                                                       */
  /* @section:                                                             */
  /*   computations                                                        */
  /*                                                                       */
  /*************************************************************************/


  /*************************************************************************/
  /*                                                                       */
  /* @type:                                                                */
  /*    FT_Angle                                                           */
  /*                                                                       */
  /* @description:                                                         */
  /*    This type is used to model angle values in FreeType.  Note that    */
  /*    the angle is a 16.16 fixed float value expressed in degrees.       */
  /*                                                                       */
  typedef FT_Fixed  FT_Angle;


  /*************************************************************************/
  /*                                                                       */
  /* @macro:                                                               */
  /*    FT_ANGLE_PI                                                        */
  /*                                                                       */
  /* @description:                                                         */
  /*   The angle pi expressed in @FT_Angle units.                          */
  /*                                                                       */
#define FT_ANGLE_PI  ( 180L << 16 )


  /*************************************************************************/
  /*                                                                       */
  /* @macro:                                                               */
  /*    FT_ANGLE_2PI                                                       */
  /*                                                                       */
  /* @description:                                                         */
  /*    The angle 2*pi expressed in @FT_Angle units.                       */
  /*                                                                       */
#define FT_ANGLE_2PI  ( FT_ANGLE_PI * 2 )


  /*************************************************************************/
  /*                                                                       */
  /* @macro:                                                               */
  /*    FT_ANGLE_PI2                                                       */
  /*                                                                       */
  /* @description:                                                         */
  /*    The angle pi/2 expressed in @FT_Angle units.                       */
  /*                                                                       */
#define FT_ANGLE_PI2  ( FT_ANGLE_PI / 2 )


  /*************************************************************************/
  /*                                                                       */
  /* @macro:                                                               */
  /*    FT_ANGLE_PI4                                                       */
  /*                                                                       */
  /* @description:                                                         */
  /*    The angle pi/4 expressed in @FT_Angle units.                       */
  /*                                                                       */
#define FT_ANGLE_PI4  ( FT_ANGLE_PI / 4 )


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Sin                                                             */
  /*                                                                       */
  /* @description:                                                         */
  /*    Return the sinus of a given angle in fixed point format.           */
  /*                                                                       */
  /* @input:                                                               */
  /*    angle :: The input angle.                                          */
  /*                                                                       */
  /* @return:                                                              */
  /*    The sinus value.                                                   */
  /*                                                                       */
  /* @note:                                                                */
  /*    If you need both the sinus and cosinus for a given angle, use the  */
  /*    function @FT_Vector_Unit.                                          */
  /*                                                                       */
  FT_EXPORT( FT_Fixed )
  FT_Sin( FT_Angle  angle );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Cos                                                             */
  /*                                                                       */
  /* @description:                                                         */
  /*    Return the cosinus of a given angle in fixed point format.         */
  /*                                                                       */
  /* @input:                                                               */
  /*    angle :: The input angle.                                          */
  /*                                                                       */
  /* @return:                                                              */
  /*    The cosinus value.                                                 */
  /*                                                                       */
  /* @note:                                                                */
  /*    If you need both the sinus and cosinus for a given angle, use the  */
  /*    function @FT_Vector_Unit.                                          */
  /*                                                                       */
  FT_EXPORT( FT_Fixed )
  FT_Cos( FT_Angle  angle );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Tan                                                             */
  /*                                                                       */
  /* @description:                                                         */
  /*    Return the tangent of a given angle in fixed point format.         */
  /*                                                                       */
  /* @input:                                                               */
  /*    angle :: The input angle.                                          */
  /*                                                                       */
  /* @return:                                                              */
  /*    The tangent value.                                                 */
  /*                                                                       */
  FT_EXPORT( FT_Fixed )
  FT_Tan( FT_Angle  angle );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Atan2                                                           */
  /*                                                                       */
  /* @description:                                                         */
  /*    Return the arc-tangent corresponding to a given vector (x,y) in    */
  /*    the 2d plane.                                                      */
  /*                                                                       */
  /* @input:                                                               */
  /*    x :: The horizontal vector coordinate.                             */
  /*                                                                       */
  /*    y :: The vertical vector coordinate.                               */
  /*                                                                       */
  /* @return:                                                              */
  /*    The arc-tangent value (i.e. angle).                                */
  /*                                                                       */
  FT_EXPORT( FT_Angle )
  FT_Atan2( FT_Fixed  x,
            FT_Fixed  y );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Angle_Diff                                                      */
  /*                                                                       */
  /* @description:                                                         */
  /*    Return the difference between two angles.  The result is always    */
  /*    constrained to the ]-PI..PI] interval.                             */
  /*                                                                       */
  /* @input:                                                               */
  /*    angle1 :: First angle.                                             */
  /*                                                                       */
  /*    angle2 :: Second angle.                                            */
  /*                                                                       */
  /* @return:                                                              */
  /*    Contrainted value of `value2-value1'.                              */
  /*                                                                       */
  FT_EXPORT( FT_Angle )
  FT_Angle_Diff( FT_Angle  angle1,
                 FT_Angle  angle2 );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Vector_Unit                                                     */
  /*                                                                       */
  /* @description:                                                         */
  /*    Return the unit vector corresponding to a given angle.  After the  */
  /*    call, the value of `vec.x' will be `sin(angle)', and the value of  */
  /*    `vec.y' will be `cos(angle)'.                                      */
  /*                                                                       */
  /*    This function is useful to retrieve both the sinus and cosinus of  */
  /*    a given angle quickly.                                             */
  /*                                                                       */
  /* @output:                                                              */
  /*    vec   :: The address of target vector.                             */
  /*                                                                       */
  /* @input:                                                               */
  /*    angle :: The address of angle.                                     */
  /*                                                                       */
  FT_EXPORT( void )
  FT_Vector_Unit( FT_Vector*  vec,
                  FT_Angle    angle );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Vector_Rotate                                                   */
  /*                                                                       */
  /* @description:                                                         */
  /*    Rotate a vector by a given angle.                                  */
  /*                                                                       */
  /* @inout:                                                               */
  /*    vec   :: The address of target vector.                             */
  /*                                                                       */
  /* @input:                                                               */
  /*    angle :: The address of angle.                                     */
  /*                                                                       */
  FT_EXPORT( void )
  FT_Vector_Rotate( FT_Vector*  vec,
                    FT_Angle    angle );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*   FT_Vector_Length                                                    */
  /*                                                                       */
  /* @description:                                                         */
  /*   Return the length of a given vector.                                */
  /*                                                                       */
  /* @input:                                                               */
  /*   vec :: The address of target vector.                                */
  /*                                                                       */
  /* @return:                                                              */
  /*   The vector length, expressed in the same units that the original    */
  /*   vector coordinates.                                                 */
  /*                                                                       */
  FT_EXPORT( FT_Fixed )
  FT_Vector_Length( FT_Vector*  vec );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Vector_Normalize                                                */
  /*                                                                       */
  /* @description:                                                         */
  /*    Normalize a given vector (i.e. compute the equivalent unit         */
  /*    vector).                                                           */
  /*                                                                       */
  /* @inout:                                                               */
  /*    vec :: The address of target vector.                               */
  /*                                                                       */
  FT_EXPORT( void )
  FT_Vector_Normalize( FT_Vector*  vec );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Vector_Polarize                                                 */
  /*                                                                       */
  /* @description:                                                         */
  /*    Compute both the length and angle of a given vector.               */
  /*                                                                       */
  /* @input:                                                               */
  /*    vec    :: The address of source vector.                            */
  /*                                                                       */
  /* @output:                                                              */
  /*    length :: The vector length.                                       */
  /*    angle  :: The vector angle.                                        */
  /*                                                                       */
  FT_EXPORT( void )
  FT_Vector_Polarize( FT_Vector*  vec,
                      FT_Fixed   *length,
                      FT_Angle   *angle );


  /*************************************************************************/
  /*                                                                       */
  /* @function:                                                            */
  /*    FT_Vector_From_Polar                                               */
  /*                                                                       */
  /* @description:                                                         */
  /*    Compute vector coordinates from a length and angle.                */
  /*                                                                       */
  /* @output:                                                              */
  /*    vec    :: The address of source vector.                            */
  /*                                                                       */
  /* @input:                                                               */
  /*    length :: The vector length.                                       */
  /*    angle  :: The vector angle.                                        */
  /*                                                                       */
  FT_EXPORT( void )
  FT_Vector_From_Polar( FT_Vector*  vec,
                        FT_Fixed    length,
                        FT_Angle    angle );

  /* */


FT_END_HEADER

#endif /* __FTTRIGON_H__ */


/* END */
