1 /**************************************************************************
2  *
3  * Copyright 2009 Marek Olšák <maraeo@gmail.com>
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 TUNGSTEN GRAPHICS 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 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 /**
35  * Convert 2D texture coordinates of 4 vertices into cubemap coordinates
36  * in the given face.
37  * Coordinates must be in the range [0,1].
38  *
39  * \param face          Cubemap face.
40  * \param in_st         4 pairs of 2D texture coordinates to convert.
41  * \param in_stride     Stride of in_st in floats.
42  * \param out_str       STR cubemap texture coordinates to compute.
43  * \param out_stride    Stride of out_str in floats.
44  */
45 void util_map_texcoords2d_onto_cubemap(unsigned face,
46                                        const float *in_st, unsigned in_stride,
47                                        float *out_str, unsigned out_stride);
48 
49 
50 #ifdef __cplusplus
51 }
52 #endif
53 
54 #endif
55