src/gallium/auxiliary/util/u_texture.h

   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 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 "pipe/p_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                                        boolean allow_scale);
  51
  52
  53 #ifdef __cplusplus
  54 }
  55 #endif
  56
  57 #endif