GCC Code Coverage Report
Directory: ./ Exec Total Coverage
File: gx_utility_math_asin.c Lines: 12 12 100.0 %
Date: 2024-12-05 08:52:37 Branches: 12 12 100.0 %

Line Branch Exec Source
1
/***************************************************************************
2
 * Copyright (c) 2024 Microsoft Corporation
3
 *
4
 * This program and the accompanying materials are made available under the
5
 * terms of the MIT License which is available at
6
 * https://opensource.org/licenses/MIT.
7
 *
8
 * SPDX-License-Identifier: MIT
9
 **************************************************************************/
10
11
12
/**************************************************************************/
13
/**************************************************************************/
14
/**                                                                       */
15
/** GUIX Component                                                        */
16
/**                                                                       */
17
/**   Utility (Utility)                                                   */
18
/**                                                                       */
19
/**************************************************************************/
20
21
#define GX_SOURCE_CODE
22
23
24
/* Include necessary system files.  */
25
26
#include "gx_api.h"
27
#include "gx_utility.h"
28
29
/* define the the table of arc sine values.
30
   The values have been enlarged by 256.  */
31
static GX_CONST GX_UBYTE asin_angle_value_table[] = {
32
    0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02, 0x02, 0x03, 0x03,
33
    0x03, 0x03, 0x04, 0x04, 0x04, 0x04, 0x04, 0x05, 0x05, 0x05, 0x05, 0x06, 0x06, 0x06, 0x06, 0x06,
34
    0x07, 0x07, 0x07, 0x07, 0x08, 0x08, 0x08, 0x08, 0x09, 0x09, 0x09, 0x09, 0x09, 0x0a, 0x0a, 0x0a,
35
    0x0a, 0x0b, 0x0b, 0x0b, 0x0b, 0x0c, 0x0c, 0x0c, 0x0c, 0x0c, 0x0d, 0x0d, 0x0d, 0x0d, 0x0e, 0x0e,
36
    0x0e, 0x0e, 0x0f, 0x0f, 0x0f, 0x0f, 0x0f, 0x10, 0x10, 0x10, 0x10, 0x11, 0x11, 0x11, 0x11, 0x12,
37
    0x12, 0x12, 0x12, 0x13, 0x13, 0x13, 0x13, 0x13, 0x14, 0x14, 0x14, 0x14, 0x15, 0x15, 0x15, 0x15,
38
    0x16, 0x16, 0x16, 0x16, 0x17, 0x17, 0x17, 0x17, 0x18, 0x18, 0x18, 0x18, 0x19, 0x19, 0x19, 0x19,
39
    0x1a, 0x1a, 0x1a, 0x1a, 0x1b, 0x1b, 0x1b, 0x1b, 0x1c, 0x1c, 0x1c, 0x1c, 0x1d, 0x1d, 0x1d, 0x1d,
40
    0x1e, 0x1e, 0x1e, 0x1e, 0x1f, 0x1f, 0x1f, 0x1f, 0x20, 0x20, 0x20, 0x21, 0x21, 0x21, 0x21, 0x22,
41
    0x22, 0x22, 0x22, 0x23, 0x23, 0x23, 0x24, 0x24, 0x24, 0x24, 0x25, 0x25, 0x25, 0x26, 0x26, 0x26,
42
    0x26, 0x27, 0x27, 0x27, 0x28, 0x28, 0x28, 0x28, 0x29, 0x29, 0x29, 0x2a, 0x2a, 0x2a, 0x2b, 0x2b,
43
    0x2b, 0x2b, 0x2c, 0x2c, 0x2c, 0x2d, 0x2d, 0x2d, 0x2e, 0x2e, 0x2e, 0x2f, 0x2f, 0x2f, 0x30, 0x30,
44
    0x30, 0x31, 0x31, 0x31, 0x32, 0x32, 0x32, 0x33, 0x33, 0x34, 0x34, 0x34, 0x35, 0x35, 0x35, 0x36,
45
    0x36, 0x37, 0x37, 0x37, 0x38, 0x38, 0x39, 0x39, 0x39, 0x3a, 0x3a, 0x3b, 0x3b, 0x3c, 0x3c, 0x3d,
46
    0x3d, 0x3d, 0x3e, 0x3e, 0x3f, 0x3f, 0x40, 0x40, 0x41, 0x42, 0x42, 0x43, 0x43, 0x44, 0x44, 0x45,
47
    0x46, 0x46, 0x47, 0x48, 0x49, 0x49, 0x4a, 0x4b, 0x4c, 0x4d, 0x4e, 0x4f, 0x51, 0x52, 0x54, 0x5a
48
};
49
50
/**************************************************************************/
51
/*                                                                        */
52
/*  FUNCTION                                               RELEASE        */
53
/*                                                                        */
54
/*    _gx_utility_math_asin_5_4_0                         PORTABLE C      */
55
/*                                                           6.1          */
56
/*  AUTHOR                                                                */
57
/*                                                                        */
58
/*    Kenneth Maxwell, Microsoft Corporation                              */
59
/*                                                                        */
60
/*  DESCRIPTION                                                           */
61
/*                                                                        */
62
/*    This service computes the angle value of the arc sin x, which is an */
63
/*    old version of _gx_utility_math_asin.                               */
64
/*                                                                        */
65
/*  INPUT                                                                 */
66
/*                                                                        */
67
/*    x                                     Value whose arc sin is        */
68
/*                                          computed, in the interval     */
69
/*                                          [-256, 256].                  */
70
/*                                                                        */
71
/*  OUTPUT                                                                */
72
/*                                                                        */
73
/*    angle                                 Angle value of arc sin of x   */
74
/*                                                                        */
75
/*  CALLS                                                                 */
76
/*                                                                        */
77
/*    None                                                                */
78
/*                                                                        */
79
/*  CALLED BY                                                             */
80
/*                                                                        */
81
/*    Application Code                                                    */
82
/*                                                                        */
83
/*  RELEASE HISTORY                                                       */
84
/*                                                                        */
85
/*    DATE              NAME                      DESCRIPTION             */
86
/*                                                                        */
87
/*  05-19-2020     Kenneth Maxwell          Initial Version 6.0           */
88
/*  09-30-2020     Kenneth Maxwell          Modified comment(s),          */
89
/*                                            resulting in version 6.1    */
90
/*                                                                        */
91
/**************************************************************************/
92
#if defined(GUIX_5_4_0_COMPATIBILITY)
93
INT _gx_utility_math_asin_5_4_0(INT x)
94
{
95
INT angle = 0;
96
97
    if (x == 256)
98
    {
99
        angle = 90;
100
    }
101
    else if ((x < 256) && (x >= 0))
102
    {
103
        angle = asin_angle_value_table[x];
104
    }
105
    else if ((x > -256) && (x < 0))
106
    {
107
        angle = 0 - asin_angle_value_table[x * -1];
108
    }
109
    else if (x == -256)
110
    {
111
        angle = -90;
112
    }
113
114
    return angle;
115
}
116
#endif
117
118
/**************************************************************************/
119
/*                                                                        */
120
/*  FUNCTION                                               RELEASE        */
121
/*                                                                        */
122
/*    _gx_utility_math_asin                               PORTABLE C      */
123
/*                                                           6.1          */
124
/*  AUTHOR                                                                */
125
/*                                                                        */
126
/*    Kenneth Maxwell, Microsoft Corporation                              */
127
/*                                                                        */
128
/*  DESCRIPTION                                                           */
129
/*                                                                        */
130
/*    This service computes the angle value of the arc sin x.             */
131
/*                                                                        */
132
/*  INPUT                                                                 */
133
/*                                                                        */
134
/*    x                                     Value whose arc sin is        */
135
/*                                          computed. The value is a      */
136
/*                                          fixed point math data type,   */
137
/*                                          call GX_FIXED_VAL_MAKE to do  */
138
/*                                          type conversion.              */
139
/*                                                                        */
140
/*  OUTPUT                                                                */
141
/*                                                                        */
142
/*    angle                                 Angle value of arc sin of x   */
143
/*                                                                        */
144
/*  CALLS                                                                 */
145
/*                                                                        */
146
/*    None                                                                */
147
/*                                                                        */
148
/*  CALLED BY                                                             */
149
/*                                                                        */
150
/*    Application Code                                                    */
151
/*                                                                        */
152
/*  RELEASE HISTORY                                                       */
153
/*                                                                        */
154
/*    DATE              NAME                      DESCRIPTION             */
155
/*                                                                        */
156
/*  05-19-2020     Kenneth Maxwell          Initial Version 6.0           */
157
/*  09-30-2020     Kenneth Maxwell          Modified comment(s),          */
158
/*                                            resulting in version 6.1    */
159
/*                                                                        */
160
/**************************************************************************/
161
62
INT _gx_utility_math_asin(GX_FIXED_VAL x)
162
{
163
62
INT angle = 0;
164
165
62
    x = GX_FIXED_VAL_TO_INT(x << 8);
166
167
62
    if (x == 256)
168
    {
169
8
        angle = 90;
170
    }
171

54
    else if ((x < 256) && (x >= 0))
172
    {
173
44
        angle = asin_angle_value_table[x];
174
    }
175

10
    else if ((x > -256) && (x < 0))
176
    {
177
6
        angle = 0 - asin_angle_value_table[x * -1];
178
    }
179
4
    else if (x == -256)
180
    {
181
3
        angle = -90;
182
    }
183
184
62
    return angle;
185
}
186