xorg-server-1.4/render/picture.h

   1 /*
   2  *
   3  * Copyright © 2000 SuSE, Inc.
   4  *
   5  * Permission to use, copy, modify, distribute, and sell this software and its
   6  * documentation for any purpose is hereby granted without fee, provided that
   7  * the above copyright notice appear in all copies and that both that
   8  * copyright notice and this permission notice appear in supporting
   9  * documentation, and that the name of SuSE not be used in advertising or
  10  * publicity pertaining to distribution of the software without specific,
  11  * written prior permission.  SuSE makes no representations about the
  12  * suitability of this software for any purpose.  It is provided "as is"
  13  * without express or implied warranty.
  14  *
  15  * SuSE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SuSE
  17  * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  18  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  19  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  20  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  21  *
  22  * Author:  Keith Packard, SuSE, Inc.
  23  */
  24
  25 #ifndef _PICTURE_H_
  26 #define _PICTURE_H_
  27
  28 #include <pixman.h>
  29
  30 typedef struct _DirectFormat    *DirectFormatPtr;
  31 typedef struct _PictFormat      *PictFormatPtr;
  32 typedef struct _Picture         *PicturePtr;
  33
  34 /*
  35  * While the protocol is generous in format support, the
  36  * sample implementation allows only packed RGB and GBR
  37  * representations for data to simplify software rendering,
  38  */
  39 #define PICT_FORMAT(bpp,type,a,r,g,b)   PIXMAN_FORMAT(bpp, type, a, r, g, b)
  40
  41 /*
  42  * gray/color formats use a visual index instead of argb
  43  */
  44 #define PICT_VISFORMAT(bpp,type,vi)     (((bpp) << 24) |  \
  45                                          ((type) << 16) | \
  46                                          ((vi)))
  47
  48 #define PICT_FORMAT_BPP(f)      PIXMAN_FORMAT_BPP(f)
  49 #define PICT_FORMAT_TYPE(f)     PIXMAN_FORMAT_TYPE(f)
  50 #define PICT_FORMAT_A(f)        PIXMAN_FORMAT_A(f)
  51 #define PICT_FORMAT_R(f)        PIXMAN_FORMAT_R(f)
  52 #define PICT_FORMAT_G(f)        PIXMAN_FORMAT_G(f)
  53 #define PICT_FORMAT_B(f)        PIXMAN_FORMAT_B(f)
  54 #define PICT_FORMAT_RGB(f)      PIXMAN_FORMAT_RGB(f)
  55 #define PICT_FORMAT_VIS(f)      PIXMAN_FORMAT_VIS(f)
  56
  57 #define PICT_TYPE_OTHER         PIXMAN_TYPE_OTHER
  58 #define PICT_TYPE_A             PIXMAN_TYPE_A
  59 #define PICT_TYPE_ARGB          PIXMAN_TYPE_ARGB
  60 #define PICT_TYPE_ABGR          PIXMAN_TYPE_ABGR
  61 #define PICT_TYPE_COLOR         PIXMAN_TYPE_COLOR
  62 #define PICT_TYPE_GRAY          PIXMAN_TYPE_GRAY
  63
  64 #define PICT_FORMAT_COLOR(f)    PIXMAN_FORMAT_COLOR(f)
  65
  66 /* 32bpp formats */
  67 typedef enum _PictFormatShort {
  68     PICT_a8r8g8b8 =     PIXMAN_a8r8g8b8,
  69     PICT_x8r8g8b8 =     PIXMAN_x8r8g8b8,
  70     PICT_a8b8g8r8 =     PIXMAN_a8b8g8r8,
  71     PICT_x8b8g8r8 =     PIXMAN_x8b8g8r8,
  72
  73 /* 24bpp formats */
  74     PICT_r8g8b8 =       PIXMAN_r8g8b8,
  75     PICT_b8g8r8 =       PIXMAN_b8g8r8,
  76
  77 /* 16bpp formats */
  78     PICT_r5g6b5 =       PIXMAN_r5g6b5,
  79     PICT_b5g6r5 =       PIXMAN_b5g6r5,
  80
  81     PICT_a1r5g5b5 =     PIXMAN_a1r5g5b5,
  82     PICT_x1r5g5b5 =     PIXMAN_x1r5g5b5,
  83     PICT_a1b5g5r5 =     PIXMAN_a1b5g5r5,
  84     PICT_x1b5g5r5 =     PIXMAN_x1b5g5r5,
  85     PICT_a4r4g4b4 =     PIXMAN_a4r4g4b4,
  86     PICT_x4r4g4b4 =     PIXMAN_x4r4g4b4,
  87     PICT_a4b4g4r4 =     PIXMAN_a4b4g4r4,
  88     PICT_x4b4g4r4 =     PIXMAN_x4b4g4r4,
  89
  90 /* 8bpp formats */
  91     PICT_a8 =           PIXMAN_a8,
  92     PICT_r3g3b2 =       PIXMAN_r3g3b2,
  93     PICT_b2g3r3 =       PIXMAN_b2g3r3,
  94     PICT_a2r2g2b2 =     PIXMAN_a2r2g2b2,
  95     PICT_a2b2g2r2 =     PIXMAN_a2b2g2r2,
  96
  97     PICT_c8 =           PIXMAN_c8,
  98     PICT_g8 =           PIXMAN_g8,
  99
 100     PICT_x4a4 =         PIXMAN_x4a4,
 101
 102     PICT_x4c4 =         PIXMAN_x4c4,
 103     PICT_x4g4 =         PIXMAN_x4g4,
 104
 105 /* 4bpp formats */
 106     PICT_a4 =           PIXMAN_a4,
 107     PICT_r1g2b1 =       PIXMAN_r1g2b1,
 108     PICT_b1g2r1 =       PIXMAN_b1g2r1,
 109     PICT_a1r1g1b1 =     PIXMAN_a1r1g1b1,
 110     PICT_a1b1g1r1 =     PIXMAN_a1b1g1r1,
 111
 112     PICT_c4 =           PIXMAN_c4,
 113     PICT_g4 =           PIXMAN_g4,
 114
 115 /* 1bpp formats */
 116     PICT_a1 =           PIXMAN_a1,
 117
 118     PICT_g1 =           PIXMAN_g1,
 119 } PictFormatShort;
 120
 121 /*
 122  * For dynamic indexed visuals (GrayScale and PseudoColor), these control the
 123  * selection of colors allocated for drawing to Pictures.  The default
 124  * policy depends on the size of the colormap:
 125  *
 126  * Size         Default Policy
 127  * ----------------------------
 128  *  < 64        PolicyMono
 129  *  < 256       PolicyGray
 130  *  256         PolicyColor (only on PseudoColor)
 131  *
 132  * The actual allocation code lives in miindex.c, and so is
 133  * austensibly server dependent, but that code does:
 134  *
 135  * PolicyMono       Allocate no additional colors, use black and white
 136  * PolicyGray       Allocate 13 gray levels (11 cells used)
 137  * PolicyColor      Allocate a 4x4x4 cube and 13 gray levels (71 cells used)
 138  * PolicyAll        Allocate as big a cube as possible, fill with gray (all)
 139  *
 140  * Here's a picture to help understand how many colors are
 141  * actually allocated (this is just the gray ramp):
 142  *
 143  *                 gray level
 144  * all   0000 1555 2aaa 4000 5555 6aaa 8000 9555 aaaa bfff d555 eaaa ffff
 145  * b/w   0000                                                        ffff
 146  * 4x4x4                     5555                aaaa
 147  * extra      1555 2aaa 4000      6aaa 8000 9555      bfff d555 eaaa
 148  *
 149  * The default colormap supplies two gray levels (black/white), the
 150  * 4x4x4 cube allocates another two and nine more are allocated to fill
 151  * in the 13 levels.  When the 4x4x4 cube is not allocated, a total of
 152  * 11 cells are allocated.
 153  */
 154
 155 #define PictureCmapPolicyInvalid    -1
 156 #define PictureCmapPolicyDefault    0
 157 #define PictureCmapPolicyMono       1
 158 #define PictureCmapPolicyGray       2
 159 #define PictureCmapPolicyColor      3
 160 #define PictureCmapPolicyAll        4
 161
 162 extern int  PictureCmapPolicy;
 163
 164 int     PictureParseCmapPolicy (const char *name);
 165
 166 extern int      RenderErrBase;
 167 extern int      RenderClientPrivateIndex;
 168
 169 /* Fixed point updates from Carl Worth, USC, Information Sciences Institute */
 170
 171 typedef pixman_fixed_32_32_t    xFixed_32_32;
 172
 173 typedef pixman_fixed_48_16_t    xFixed_48_16;
 174
 175 #define MAX_FIXED_48_16         pixman_max_fixed_48_16
 176 #define MIN_FIXED_48_16         pixman_min_fixed_48_16
 177
 178 typedef pixman_fixed_1_31_t     xFixed_1_31;
 179 typedef pixman_fixed_1_16_t     xFixed_1_16;
 180 typedef pixman_fixed_16_16_t    xFixed_16_16;
 181
 182 /*
 183  * An unadorned "xFixed" is the same as xFixed_16_16,
 184  * (since it's quite common in the code)
 185  */
 186 typedef pixman_fixed_t  xFixed;
 187 #define XFIXED_BITS     16
 188
 189 #define xFixedToInt(f)  pixman_fixed_to_int(f)
 190 #define IntToxFixed(i)  pixman_int_to_fixed(i)
 191 #define xFixedE         pixman_fixed_e
 192 #define xFixed1         pixman_fixed_1
 193 #define xFixed1MinusE   pixman_fixed_1_minus_e
 194 #define xFixedFrac(f)   pixman_fixed_frac(f)
 195 #define xFixedFloor(f)  pixman_fixed_floor(f)
 196 #define xFixedCeil(f)   pixman_fixed_ceil(f)
 197
 198 #define xFixedFraction(f)       pixman_fixed_fraction(f)
 199 #define xFixedMod2(f)           pixman_fixed_mod2(f)
 200
 201 /* whether 't' is a well defined not obviously empty trapezoid */
 202 #define xTrapezoidValid(t)  ((t)->left.p1.y != (t)->left.p2.y && \
 203                              (t)->right.p1.y != (t)->right.p2.y && \
 204                              (int) ((t)->bottom - (t)->top) > 0)
 205
 206 /*
 207  * Standard NTSC luminance conversions:
 208  *
 209  *  y = r * 0.299 + g * 0.587 + b * 0.114
 210  *
 211  * Approximate this for a bit more speed:
 212  *
 213  *  y = (r * 153 + g * 301 + b * 58) / 512
 214  *
 215  * This gives 17 bits of luminance; to get 15 bits, lop the low two
 216  */
 217
 218 #define CvtR8G8B8toY15(s)       (((((s) >> 16) & 0xff) * 153 + \
 219                                   (((s) >>  8) & 0xff) * 301 + \
 220                                   (((s)      ) & 0xff) * 58) >> 2)
 221
 222 #endif /* _PICTURE_H_ */