Home | History | Annotate | Download | only in ilo
      1 /*
      2  * Mesa 3-D graphics library
      3  *
      4  * Copyright (C) 2012-2013 LunarG, Inc.
      5  *
      6  * Permission is hereby granted, free of charge, to any person obtaining a
      7  * copy of this software and associated documentation files (the "Software"),
      8  * to deal in the Software without restriction, including without limitation
      9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
     10  * and/or sell copies of the Software, and to permit persons to whom the
     11  * Software is furnished to do so, subject to the following conditions:
     12  *
     13  * The above copyright notice and this permission notice shall be included
     14  * in all copies or substantial portions of the Software.
     15  *
     16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
     19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
     20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
     21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     22  * DEALINGS IN THE SOFTWARE.
     23  *
     24  * Authors:
     25  *    Chia-I Wu <olv (at) lunarg.com>
     26  */
     27 
     28 #ifndef ILO_FORMAT_H
     29 #define ILO_FORMAT_H
     30 
     31 #include "genhw/genhw.h"
     32 
     33 #include "ilo_common.h"
     34 
     35 bool
     36 ilo_format_support_vb(const struct ilo_dev *dev,
     37                       enum pipe_format format);
     38 
     39 bool
     40 ilo_format_support_sol(const struct ilo_dev *dev,
     41                        enum pipe_format format);
     42 
     43 bool
     44 ilo_format_support_sampler(const struct ilo_dev *dev,
     45                            enum pipe_format format);
     46 
     47 bool
     48 ilo_format_support_rt(const struct ilo_dev *dev,
     49                       enum pipe_format format);
     50 
     51 bool
     52 ilo_format_support_zs(const struct ilo_dev *dev,
     53                       enum pipe_format format);
     54 
     55 int
     56 ilo_format_translate_color(const struct ilo_dev *dev,
     57                            enum pipe_format format);
     58 
     59 /**
     60  * Translate a pipe format to a hardware surface format suitable for
     61  * the given purpose.  Return -1 on errors.
     62  *
     63  * This is an inline function not only for performance reasons.  There are
     64  * caveats that the callers should be aware of before calling this function.
     65  */
     66 static inline int
     67 ilo_format_translate(const struct ilo_dev *dev,
     68                      enum pipe_format format, unsigned bind)
     69 {
     70    switch (bind) {
     71    case PIPE_BIND_RENDER_TARGET:
     72       /*
     73        * Some RGBX formats are not supported as render target formats.  But we
     74        * can use their RGBA counterparts and force the destination alpha to be
     75        * one when blending is enabled.
     76        */
     77       switch (format) {
     78       case PIPE_FORMAT_B8G8R8X8_UNORM:
     79          return GEN6_FORMAT_B8G8R8A8_UNORM;
     80       default:
     81          return ilo_format_translate_color(dev, format);
     82       }
     83       break;
     84    case PIPE_BIND_SAMPLER_VIEW:
     85       /*
     86        * For depth formats, we want the depth values to be returned as R
     87        * values.  But we assume in many places that the depth values are
     88        * returned as I values (util_make_fragment_tex_shader_writedepth() is
     89        * one such example).  We have to live with that at least for now.
     90        *
     91        * For ETC1 format, the texture data will be decompressed before being
     92        * written to the bo.  See tex_staging_sys_convert_write().
     93        */
     94       switch (format) {
     95       case PIPE_FORMAT_Z16_UNORM:
     96          return GEN6_FORMAT_I16_UNORM;
     97       case PIPE_FORMAT_Z32_FLOAT:
     98          return GEN6_FORMAT_I32_FLOAT;
     99       case PIPE_FORMAT_Z24X8_UNORM:
    100       case PIPE_FORMAT_Z24_UNORM_S8_UINT:
    101          return GEN6_FORMAT_I24X8_UNORM;
    102       case PIPE_FORMAT_Z32_FLOAT_S8X24_UINT:
    103          return GEN6_FORMAT_I32X32_FLOAT;
    104       case PIPE_FORMAT_ETC1_RGB8:
    105          return GEN6_FORMAT_R8G8B8X8_UNORM;
    106       default:
    107          return ilo_format_translate_color(dev, format);
    108       }
    109       break;
    110    case PIPE_BIND_VERTEX_BUFFER:
    111       if (ilo_dev_gen(dev) >= ILO_GEN(7.5))
    112          return ilo_format_translate_color(dev, format);
    113 
    114       /*
    115        * Some 3-component formats are not supported as vertex element formats.
    116        * But since we move between vertices using vb->stride, we should be
    117        * good to use their 4-component counterparts if we force the W
    118        * component to be one.  The only exception is that the vb boundary
    119        * check for the last vertex may fail.
    120        */
    121       switch (format) {
    122       case PIPE_FORMAT_R16G16B16_FLOAT:
    123          return GEN6_FORMAT_R16G16B16A16_FLOAT;
    124       case PIPE_FORMAT_R16G16B16_UINT:
    125          return GEN6_FORMAT_R16G16B16A16_UINT;
    126       case PIPE_FORMAT_R16G16B16_SINT:
    127          return GEN6_FORMAT_R16G16B16A16_SINT;
    128       case PIPE_FORMAT_R8G8B8_UINT:
    129          return GEN6_FORMAT_R8G8B8A8_UINT;
    130       case PIPE_FORMAT_R8G8B8_SINT:
    131          return GEN6_FORMAT_R8G8B8A8_SINT;
    132       default:
    133          return ilo_format_translate_color(dev, format);
    134       }
    135       break;
    136    case PIPE_BIND_STREAM_OUTPUT:
    137       return ilo_format_translate_color(dev, format);
    138       break;
    139    default:
    140       assert(!"cannot translate format");
    141       break;
    142    }
    143 
    144    return -1;
    145 }
    146 
    147 static inline int
    148 ilo_format_translate_render(const struct ilo_dev *dev,
    149                             enum pipe_format format)
    150 {
    151    return ilo_format_translate(dev, format, PIPE_BIND_RENDER_TARGET);
    152 }
    153 
    154 static inline int
    155 ilo_format_translate_texture(const struct ilo_dev *dev,
    156                              enum pipe_format format)
    157 {
    158    return ilo_format_translate(dev, format, PIPE_BIND_SAMPLER_VIEW);
    159 }
    160 
    161 static inline int
    162 ilo_format_translate_vertex(const struct ilo_dev *dev,
    163                             enum pipe_format format)
    164 {
    165    return ilo_format_translate(dev, format, PIPE_BIND_VERTEX_BUFFER);
    166 }
    167 
    168 static inline enum gen_depth_format
    169 ilo_format_translate_depth(const struct ilo_dev *dev,
    170                            enum pipe_format format)
    171 {
    172    if (ilo_dev_gen(dev) >= ILO_GEN(7)) {
    173       switch (format) {
    174       case PIPE_FORMAT_Z32_FLOAT:
    175          return GEN6_ZFORMAT_D32_FLOAT;
    176       case PIPE_FORMAT_Z24X8_UNORM:
    177          return GEN6_ZFORMAT_D24_UNORM_X8_UINT;
    178       case PIPE_FORMAT_Z16_UNORM:
    179          return GEN6_ZFORMAT_D16_UNORM;
    180       default:
    181          assert(!"unknown depth format");
    182          return GEN6_ZFORMAT_D32_FLOAT;
    183       }
    184    } else {
    185       switch (format) {
    186       case PIPE_FORMAT_Z32_FLOAT_S8X24_UINT:
    187          return GEN6_ZFORMAT_D32_FLOAT_S8X24_UINT;
    188       case PIPE_FORMAT_Z32_FLOAT:
    189          return GEN6_ZFORMAT_D32_FLOAT;
    190       case PIPE_FORMAT_Z24_UNORM_S8_UINT:
    191          return GEN6_ZFORMAT_D24_UNORM_S8_UINT;
    192       case PIPE_FORMAT_Z24X8_UNORM:
    193          return GEN6_ZFORMAT_D24_UNORM_X8_UINT;
    194       case PIPE_FORMAT_Z16_UNORM:
    195          return GEN6_ZFORMAT_D16_UNORM;
    196       default:
    197          assert(!"unknown depth format");
    198          return GEN6_ZFORMAT_D32_FLOAT;
    199       }
    200    }
    201 }
    202 
    203 #endif /* ILO_FORMAT_H */
    204