src/gallium/drivers/r300/r300_cb.h

   1 /*
   2  * Copyright 2008 Corbin Simpson <MostAwesomeDude@gmail.com>
   3  * Copyright 2010 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 "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * on the rights to use, copy, modify, merge, publish, distribute, sub
   9  * license, and/or sell copies of the Software, and to permit persons to whom
  10  * the Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice (including the next
  13  * paragraph) shall be included in all copies or substantial portions of the
  14  * 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 NON-INFRINGEMENT. IN NO EVENT SHALL
  19  * THE AUTHOR(S) AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
  20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  21  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  22  * USE OR OTHER DEALINGS IN THE SOFTWARE. */
  23
  24 /**
  25  * This file contains macros for building command buffers in memory.
  26  *
  27  * Use NEW_CB for buffers with a varying size and it will also allocate
  28  * the buffer.
  29  * Use BEGIN_CB for arrays with a static size.
  30  *
  31  * Example:
  32  *
  33  *     uint32_t cb[3];
  34  *     CB_LOCALS;
  35  *
  36  *     BEGIN_CB(cb, 3);
  37  *     OUT_CB_REG_SEQ(R500_RB3D_CONSTANT_COLOR_AR, 2);
  38  *     OUT_CB(blend_color_red_alpha);
  39  *     OUT_CB(blend_color_green_blue);
  40  *     END_CB;
  41  *
  42  * And later:
  43  *
  44  *     CS_LOCALS;
  45  *     WRITE_CS_TABLE(cb, 3);
  46  *
  47  * Or using a little slower variant:
  48  *
  49  *     CS_LOCALS;
  50  *     BEGIN_CS(cb, 3);
  51  *     OUT_CS_TABLE(cb, 3);
  52  *     END_CS;
  53  */
  54
  55 #ifndef R300_CB_H
  56 #define R300_CB_H
  57
  58 #include "r300_reg.h"
  59
  60 /* Yes, I know macros are ugly. However, they are much prettier than the code
  61  * that they neatly hide away, and don't have the cost of function setup, so
  62  * we're going to use them. */
  63
  64 /**
  65  * Command buffer setup.
  66  */
  67
  68 #ifdef DEBUG
  69
  70 #define CB_LOCALS \
  71     int cs_count = 0; \
  72     uint32_t *cs_ptr = NULL; \
  73     (void) cs_count; (void) cs_ptr
  74
  75 #define BEGIN_CB(ptr, size) do { \
  76     assert(sizeof(*(ptr)) == sizeof(uint32_t)); \
  77     cs_count = (size); \
  78     cs_ptr = (ptr); \
  79 } while (0)
  80
  81 #define NEW_CB(ptr, size) \
  82     do { \
  83     assert(sizeof(*(ptr)) == sizeof(uint32_t)); \
  84     cs_count = (size); \
  85     cs_ptr = (ptr) = (uint32_t*)malloc((size) * sizeof(uint32_t)); \
  86 } while (0)
  87
  88 #define END_CB do { \
  89     if (cs_count != 0) \
  90         debug_printf("r300: Warning: cs_count off by %d at (%s, %s:%i)\n", \
  91                      cs_count, __FUNCTION__, __FILE__, __LINE__); \
  92 } while (0)
  93
  94 #define CB_USED_DW(x) cs_count -= x
  95
  96 #else
  97
  98 #define CB_LOCALS \
  99     uint32_t *cs_ptr = NULL; (void) cs_ptr
 100
 101 #define NEW_CB(ptr, size) \
 102     cs_ptr = (ptr) = (uint32_t*)malloc((size) * sizeof(uint32_t))
 103
 104 #define BEGIN_CB(ptr, size) cs_ptr = (ptr)
 105 #define END_CB
 106 #define CB_USED_DW(x)
 107
 108 #endif
 109
 110
 111 /**
 112  * Storing pure DWORDs.
 113  */
 114
 115 #define OUT_CB(value) do { \
 116     *cs_ptr = (value); \
 117     cs_ptr++; \
 118     CB_USED_DW(1); \
 119 } while (0)
 120
 121 #define OUT_CB_TABLE(values, count) do { \
 122     memcpy(cs_ptr, values, count * sizeof(uint32_t)); \
 123     cs_ptr += count; \
 124     CB_USED_DW(count); \
 125 } while (0)
 126
 127 #define OUT_CB_32F(value) \
 128     OUT_CB(fui(value));
 129
 130 #define OUT_CB_REG(register, value) do { \
 131     assert(register); \
 132     OUT_CB(CP_PACKET0(register, 0)); \
 133     OUT_CB(value); \
 134 } while (0)
 135
 136 /* Note: This expects count to be the number of registers,
 137  * not the actual packet0 count! */
 138 #define OUT_CB_REG_SEQ(register, count) do { \
 139     assert(register); \
 140     OUT_CB(CP_PACKET0(register, (count) - 1)); \
 141 } while (0)
 142
 143 #define OUT_CB_ONE_REG(register, count) do { \
 144     assert(register); \
 145     OUT_CB(CP_PACKET0(register, (count) - 1) | RADEON_ONE_REG_WR); \
 146 } while (0)
 147
 148 #define OUT_CB_PKT3(op, count) \
 149     OUT_CB(CP_PACKET3(op, count))
 150
 151 #endif /* R300_CB_H */