blob: 7dc8aabfbb5e156636e160754c8e9ce16f8f94ba (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
/*
* File: gmath.h
* -------------
* This file exports several functions for working with graphical
* geometry along with the mathematical constants <code>PI</code>
* and <code>E</code>.
*/
#ifndef _gmath_h
#define _gmath_h
#include "gtypes.h"
/*
* Constant: PI
* ------------
* The mathematical constant pi, which is the ratio of the circumference
* of a circle to its diameter.
*/
extern const double PI;
/*
* Constant: E
* -----------
* The mathematical constant e, which is the base of natural logarithms.
*/
extern const double E;
/*
* Function: sinDegrees
* Usage: double sine = sinDegrees(angle);
* ---------------------------------------
* Returns the trigonometric sine of <code>angle</code>, which is
* expressed in degrees.
*/
double sinDegrees(double angle);
/*
* Function: cosDegrees
* Usage: double cosine = cosDegrees(angle);
* -----------------------------------------
* Returns the trigonometric cosine of <code>angle</code>, which is
* expressed in degrees.
*/
double cosDegrees(double angle);
/*
* Function: tanDegrees
* Usage: double tangent = tanDegrees(angle);
* ------------------------------------------
* Returns the trigonometric tangent of <code>angle</code>, which is
* expressed in degrees.
*/
double tanDegrees(double angle);
/*
* Function: toDegrees
* Usage: double degrees = toDegrees(radians);
* -------------------------------------------
* Converts an angle from radians to degrees.
*/
double toDegrees(double radians);
/*
* Function: toRadians
* Usage: double radians = toRadians(degrees);
* -------------------------------------------
* Converts an angle from degrees to radians.
*/
double toRadians(double degrees);
/*
* Function: vectorDistance
* Usage: double r = vectorDistance(pt);
* double r = vectorDistance(x, y);
* ---------------------------------------
* Computes the distance between the origin and the specified point.
*/
double vectorDistance(const GPoint & pt);
double vectorDistance(double x, double y);
/*
* Function: vectorAngle
* Usage: double angle = vectorAngle(pt);
* double angle = vectorAngle(x, y);
* ----------------------------------------
* Returns the angle in degrees from the origin to the specified point.
* This function takes account of the fact that the graphics coordinate
* system is flipped in the <i>y</i> direction from the traditional
* Cartesian plane.
*/
double vectorAngle(const GPoint & pt);
double vectorAngle(double x, double y);
#endif
|
