xref: /aosp_15_r20/external/mesa3d/src/gallium/auxiliary/util/u_texture.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /**************************************************************************
2  *
3  * Copyright 2009 Marek Olšák <[email protected]>
4  *
5  * Permission is hereby granted, free of charge, to any person obtaining a
6  * copy of this software and associated documentation files (the
7  * "Software"), to deal in the Software without restriction, including
8  * without limitation the rights to use, copy, modify, merge, publish,
9  * distribute, sub license, and/or sell copies of the Software, and to
10  * permit persons to whom the Software is furnished to do so, subject to
11  * the following conditions:
12  *
13  * The above copyright notice and this permission notice (including the
14  * next paragraph) shall be included in all copies or substantial portions
15  * of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
20  * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
21  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24  *
25  **************************************************************************/
26 
27 #ifndef U_TEXTURE_H
28 #define U_TEXTURE_H
29 
30 #include "util/compiler.h"
31 
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
35 
36 /**
37  * Convert 2D texture coordinates of 4 vertices into cubemap coordinates
38  * in the given face.
39  * Coordinates must be in the range [0,1].
40  *
41  * \param face          Cubemap face.
42  * \param in_st         4 pairs of 2D texture coordinates to convert.
43  * \param in_stride     Stride of in_st in floats.
44  * \param out_str       STR cubemap texture coordinates to compute.
45  * \param out_stride    Stride of out_str in floats.
46  */
47 void util_map_texcoords2d_onto_cubemap(unsigned face,
48                                        const float *in_st, unsigned in_stride,
49                                        float *out_str, unsigned out_stride);
50 
51 
52 #ifdef __cplusplus
53 }
54 #endif
55 
56 #endif
57