Sunlit Design > The Sun API > Documentation > sdACos Function
- Introduction
+ Using the Functions
+ User Guide
+ Function Reference
+ Constants
sdACos Function
Description
Returns the arccosine of a number. The arccosine is the angle whose cosine isValue.
The returned angle is given in degrees in the range 0 (zero) to 180.
Syntax
sdACos(Value)
Value A double precision number, is the cosine of
the angle you want and must be from -1 to 1.
Return Values
sdACos returns a double precision number.Errors
If this function finds any errors in it's input parameter(s) it returns -99999999
Remarks
This degree based function is provided because most programming environments provide only radian based functions.
You can convert a degree value to it's Degrees:Minute:Seconds components using the sdDUnpackx function and to a printable text format using sdD2Text function.
Example
To find the angle which has a Cosine of -.5:
sdACos(-.5) equals 120