src/mesa/main/colormac.h

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  7.3
   4  *
   5  * Copyright (C) 1999-2008  Brian Paul   All Rights Reserved.
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a
   8  * copy of this software and associated documentation files (the "Software"),
   9  * to deal in the Software without restriction, including without limitation
  10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  11  * and/or sell copies of the Software, and to permit persons to whom the
  12  * Software is furnished to do so, subject to the following conditions:
  13  *
  14  * The above copyright notice and this permission notice shall be included
  15  * in all copies or substantial portions 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 MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  20  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  21  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25
  26 /**
  27  * \file colormac.h
  28  * Color-related macros
  29  */
  30
  31
  32 #ifndef COLORMAC_H
  33 #define COLORMAC_H
  34
  35
  36 #include "config.h"
  37 #include "macros.h"
  38 #include "mtypes.h"
  39
  40
  41 /** \def BYTE_TO_CHAN
  42  * Convert from GLbyte to GLchan */
  43
  44 /** \def UBYTE_TO_CHAN
  45  * Convert from GLubyte to GLchan */
  46
  47 /** \def SHORT_TO_CHAN
  48  * Convert from GLshort to GLchan */
  49
  50 /** \def USHORT_TO_CHAN
  51  * Convert from GLushort to GLchan */
  52
  53 /** \def INT_TO_CHAN
  54  * Convert from GLint to GLchan */
  55
  56 /** \def UINT_TO_CHAN
  57  * Convert from GLuint to GLchan */
  58
  59 /** \def CHAN_TO_UBYTE
  60  * Convert from GLchan to GLubyte */
  61
  62 /** \def CHAN_TO_FLOAT
  63  * Convert from GLchan to GLfloat */
  64
  65 /** \def CLAMPED_FLOAT_TO_CHAN
  66  * Convert from GLclampf to GLchan */
  67
  68 /** \def UNCLAMPED_FLOAT_TO_CHAN
  69  * Convert from GLfloat to GLchan */
  70
  71 /** \def COPY_CHAN4
  72  * Copy a GLchan[4] array */
  73
  74 #if CHAN_BITS == 8
  75
  76 #define BYTE_TO_CHAN(b)   ((b) < 0 ? 0 : (GLchan) (b))
  77 #define UBYTE_TO_CHAN(b)  (b)
  78 #define SHORT_TO_CHAN(s)  ((s) < 0 ? 0 : (GLchan) ((s) >> 7))
  79 #define USHORT_TO_CHAN(s) ((GLchan) ((s) >> 8))
  80 #define INT_TO_CHAN(i)    ((i) < 0 ? 0 : (GLchan) ((i) >> 23))
  81 #define UINT_TO_CHAN(i)   ((GLchan) ((i) >> 24))
  82
  83 #define CHAN_TO_UBYTE(c)  (c)
  84 #define CHAN_TO_USHORT(c) (((c) << 8) | (c))
  85 #define CHAN_TO_SHORT(c)  (((c) << 7) | ((c) >> 1))
  86 #define CHAN_TO_FLOAT(c)  UBYTE_TO_FLOAT(c)
  87
  88 #define CLAMPED_FLOAT_TO_CHAN(c, f)    CLAMPED_FLOAT_TO_UBYTE(c, f)
  89 #define UNCLAMPED_FLOAT_TO_CHAN(c, f)  UNCLAMPED_FLOAT_TO_UBYTE(c, f)
  90
  91 #define COPY_CHAN4(DST, SRC)  COPY_4UBV(DST, SRC)
  92
  93 #elif CHAN_BITS == 16
  94
  95 #define BYTE_TO_CHAN(b)   ((b) < 0 ? 0 : (((GLchan) (b)) * 516))
  96 #define UBYTE_TO_CHAN(b)  ((((GLchan) (b)) << 8) | ((GLchan) (b)))
  97 #define SHORT_TO_CHAN(s)  ((s) < 0 ? 0 : (GLchan) (s))
  98 #define USHORT_TO_CHAN(s) (s)
  99 #define INT_TO_CHAN(i)    ((i) < 0 ? 0 : (GLchan) ((i) >> 15))
 100 #define UINT_TO_CHAN(i)   ((GLchan) ((i) >> 16))
 101
 102 #define CHAN_TO_UBYTE(c)  ((c) >> 8)
 103 #define CHAN_TO_USHORT(c) (c)
 104 #define CHAN_TO_SHORT(c)  ((c) >> 1)
 105 #define CHAN_TO_FLOAT(c)  ((GLfloat) ((c) * (1.0 / CHAN_MAXF)))
 106
 107 #define CLAMPED_FLOAT_TO_CHAN(c, f)    CLAMPED_FLOAT_TO_USHORT(c, f)
 108 #define UNCLAMPED_FLOAT_TO_CHAN(c, f)  UNCLAMPED_FLOAT_TO_USHORT(c, f)
 109
 110 #define COPY_CHAN4(DST, SRC)  COPY_4V(DST, SRC)
 111
 112 #elif CHAN_BITS == 32
 113
 114 /* XXX floating-point color channels not fully thought-out */
 115 #define BYTE_TO_CHAN(b)   ((GLfloat) ((b) * (1.0F / 127.0F)))
 116 #define UBYTE_TO_CHAN(b)  ((GLfloat) ((b) * (1.0F / 255.0F)))
 117 #define SHORT_TO_CHAN(s)  ((GLfloat) ((s) * (1.0F / 32767.0F)))
 118 #define USHORT_TO_CHAN(s) ((GLfloat) ((s) * (1.0F / 65535.0F)))
 119 #define INT_TO_CHAN(i)    ((GLfloat) ((i) * (1.0F / 2147483647.0F)))
 120 #define UINT_TO_CHAN(i)   ((GLfloat) ((i) * (1.0F / 4294967295.0F)))
 121
 122 #define CHAN_TO_UBYTE(c)  FLOAT_TO_UBYTE(c)
 123 #define CHAN_TO_USHORT(c) ((GLushort) (CLAMP((c), 0.0f, 1.0f) * 65535.0))
 124 #define CHAN_TO_SHORT(c)  ((GLshort) (CLAMP((c), 0.0f, 1.0f) * 32767.0))
 125 #define CHAN_TO_FLOAT(c)  (c)
 126
 127 #define CLAMPED_FLOAT_TO_CHAN(c, f)  c = (f)
 128 #define UNCLAMPED_FLOAT_TO_CHAN(c, f)      c = (f)
 129
 130 #define COPY_CHAN4(DST, SRC)  COPY_4V(DST, SRC)
 131
 132 #else
 133
 134 #error unexpected CHAN_BITS size
 135
 136 #endif
 137
 138
 139 /**
 140  * Convert 3 channels at once.
 141  *
 142  * \param dst pointer to destination GLchan[3] array.
 143  * \param f pointer to source GLfloat[3] array.
 144  *
 145  * \sa #UNCLAMPED_FLOAT_TO_CHAN.
 146  */
 147 #define UNCLAMPED_FLOAT_TO_RGB_CHAN(dst, f)     \
 148 do {                                            \
 149    UNCLAMPED_FLOAT_TO_CHAN((dst)[0], (f)[0]);   \
 150    UNCLAMPED_FLOAT_TO_CHAN((dst)[1], (f)[1]);   \
 151    UNCLAMPED_FLOAT_TO_CHAN((dst)[2], (f)[2]);   \
 152 } while (0)
 153
 154
 155 /**
 156  * Convert 4 channels at once.
 157  *
 158  * \param dst pointer to destination GLchan[4] array.
 159  * \param f pointer to source GLfloat[4] array.
 160  *
 161  * \sa #UNCLAMPED_FLOAT_TO_CHAN.
 162  */
 163 #define UNCLAMPED_FLOAT_TO_RGBA_CHAN(dst, f)    \
 164 do {                                            \
 165    UNCLAMPED_FLOAT_TO_CHAN((dst)[0], (f)[0]);   \
 166    UNCLAMPED_FLOAT_TO_CHAN((dst)[1], (f)[1]);   \
 167    UNCLAMPED_FLOAT_TO_CHAN((dst)[2], (f)[2]);   \
 168    UNCLAMPED_FLOAT_TO_CHAN((dst)[3], (f)[3]);   \
 169 } while (0)
 170
 171 static inline void _mesa_unclamped_float_rgba_to_ubyte(GLubyte dst[4], const GLfloat src[4])
 172 {
 173    int i;
 174    for (i = 0; i < 4; i++)
 175       UNCLAMPED_FLOAT_TO_UBYTE(dst[i], src[i]);
 176 }
 177
 178 /**
 179  * \name Generic color packing macros.  All inputs should be GLubytes.
 180  *
 181  * \todo We may move these into texstore.h at some point.
 182  */
 183 /*@{*/
 184
 185 #define PACK_COLOR_8888( X, Y, Z, W ) \
 186    (((X) << 24) | ((Y) << 16) | ((Z) << 8) | (W))
 187
 188 #define PACK_COLOR_8888_REV( X, Y, Z, W ) \
 189    (((W) << 24) | ((Z) << 16) | ((Y) << 8) | (X))
 190
 191 #define PACK_COLOR_888( X, Y, Z ) \
 192    (((X) << 16) | ((Y) << 8) | (Z))
 193
 194 #define PACK_COLOR_565( X, Y, Z )                                  \
 195    ((((X) & 0xf8) << 8) | (((Y) & 0xfc) << 3) | (((Z) & 0xf8) >> 3))
 196
 197 #define PACK_COLOR_565_REV( X, Y, Z ) \
 198    (((X) & 0xf8) | ((Y) & 0xe0) >> 5 | (((Y) & 0x1c) << 11) | (((Z) & 0xf8) << 5))
 199
 200 #define PACK_COLOR_5551( R, G, B, A )                                   \
 201    ((((R) & 0xf8) << 8) | (((G) & 0xf8) << 3) | (((B) & 0xf8) >> 2) |   \
 202     ((A) ? 1 : 0))
 203
 204 #define PACK_COLOR_1555( A, B, G, R )                                   \
 205    ((((B) & 0xf8) << 7) | (((G) & 0xf8) << 2) | (((R) & 0xf8) >> 3) |   \
 206     ((A) ? 0x8000 : 0))
 207
 208 #define PACK_COLOR_1555_REV( A, B, G, R )                                       \
 209    ((((B) & 0xf8) >> 1) | (((G) & 0xc0) >> 6) | (((G) & 0x38) << 10) | (((R) & 0xf8) << 5) |    \
 210     ((A) ? 0x80 : 0))
 211
 212 #define PACK_COLOR_2101010_UB( A, B, G, R )                                     \
 213    (((B) << 22) | ((G) << 12) | ((R) << 2) |    \
 214     (((A) & 0xc0) << 24))
 215
 216 #define PACK_COLOR_2101010_US( A, B, G, R )                                     \
 217    ((((B) >> 6) << 20) | (((G) >> 6) << 10) | ((R) >> 6) |      \
 218     (((A) >> 14) << 30))
 219
 220 #define PACK_COLOR_4444( R, G, B, A )                                   \
 221    ((((R) & 0xf0) << 8) | (((G) & 0xf0) << 4) | ((B) & 0xf0) | ((A) >> 4))
 222
 223 #define PACK_COLOR_4444_REV( R, G, B, A )                               \
 224    ((((B) & 0xf0) << 8) | (((A) & 0xf0) << 4) | ((R) & 0xf0) | ((G) >> 4))
 225
 226 #define PACK_COLOR_44( L, A )                                           \
 227    (((L) & 0xf0) | (((A) & 0xf0) >> 4))
 228
 229 #define PACK_COLOR_88( L, A )                                           \
 230    (((L) << 8) | (A))
 231
 232 #define PACK_COLOR_88_REV( L, A )                                       \
 233    (((A) << 8) | (L))
 234
 235 #define PACK_COLOR_1616( L, A )                                         \
 236    (((L) << 16) | (A))
 237
 238 #define PACK_COLOR_1616_REV( L, A )                                     \
 239    (((A) << 16) | (L))
 240
 241 #define PACK_COLOR_332( R, G, B )                                       \
 242    (((R) & 0xe0) | (((G) & 0xe0) >> 3) | (((B) & 0xc0) >> 6))
 243
 244 #define PACK_COLOR_233( B, G, R )                                       \
 245    (((B) & 0xc0) | (((G) & 0xe0) >> 2) | (((R) & 0xe0) >> 5))
 246
 247 /*@}*/
 248
 249
 250 #endif /* COLORMAC_H */