src/video/SDL_pixels.c
author Sam Lantinga <slouken@libsdl.org>
Sun, 04 Jan 2009 17:14:27 +0000
changeset 2990 502adab079a4
parent 2967 e4a469d6ddab
child 3163 a252014ce27d
permissions -rw-r--r--
indent
slouken@0
     1
/*
slouken@0
     2
    SDL - Simple DirectMedia Layer
slouken@2859
     3
    Copyright (C) 1997-2009 Sam Lantinga
slouken@0
     4
slouken@0
     5
    This library is free software; you can redistribute it and/or
slouken@1312
     6
    modify it under the terms of the GNU Lesser General Public
slouken@0
     7
    License as published by the Free Software Foundation; either
slouken@1312
     8
    version 2.1 of the License, or (at your option) any later version.
slouken@0
     9
slouken@0
    10
    This library is distributed in the hope that it will be useful,
slouken@0
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
slouken@0
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
slouken@1312
    13
    Lesser General Public License for more details.
slouken@0
    14
slouken@1312
    15
    You should have received a copy of the GNU Lesser General Public
slouken@1312
    16
    License along with this library; if not, write to the Free Software
slouken@1312
    17
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
slouken@0
    18
slouken@0
    19
    Sam Lantinga
slouken@252
    20
    slouken@libsdl.org
slouken@0
    21
*/
slouken@1402
    22
#include "SDL_config.h"
slouken@0
    23
slouken@0
    24
/* General (mostly internal) pixel/color manipulation routines for SDL */
slouken@0
    25
slouken@0
    26
#include "SDL_endian.h"
slouken@0
    27
#include "SDL_video.h"
slouken@0
    28
#include "SDL_sysvideo.h"
slouken@0
    29
#include "SDL_blit.h"
slouken@0
    30
#include "SDL_pixels_c.h"
slouken@0
    31
#include "SDL_RLEaccel_c.h"
slouken@0
    32
slouken@0
    33
/* Helper functions */
slouken@1895
    34
slouken@1895
    35
SDL_bool
slouken@1895
    36
SDL_PixelFormatEnumToMasks(Uint32 format, int *bpp, Uint32 * Rmask,
slouken@1895
    37
                           Uint32 * Gmask, Uint32 * Bmask, Uint32 * Amask)
slouken@1895
    38
{
slouken@1895
    39
    Uint32 masks[4];
slouken@1895
    40
slouken@1895
    41
    /* Initialize the values here */
slouken@1895
    42
    if (SDL_BITSPERPIXEL(format) == 24) {
slouken@1895
    43
        *bpp = SDL_BYTESPERPIXEL(format) * 8;
slouken@1895
    44
    } else {
slouken@1895
    45
        *bpp = SDL_BITSPERPIXEL(format);
slouken@1895
    46
    }
slouken@1895
    47
    *Rmask = *Gmask = *Bmask = *Amask = 0;
slouken@1895
    48
slouken@1965
    49
    if (SDL_PIXELTYPE(format) != SDL_PIXELTYPE_PACKED8 &&
slouken@1965
    50
        SDL_PIXELTYPE(format) != SDL_PIXELTYPE_PACKED16 &&
slouken@1965
    51
        SDL_PIXELTYPE(format) != SDL_PIXELTYPE_PACKED32) {
slouken@1895
    52
        /* Not a format that uses masks */
slouken@1895
    53
        return SDL_TRUE;
slouken@1895
    54
    }
slouken@1895
    55
slouken@1895
    56
    switch (SDL_PIXELLAYOUT(format)) {
slouken@1965
    57
    case SDL_PACKEDLAYOUT_332:
slouken@1895
    58
        masks[0] = 0x00000000;
slouken@1895
    59
        masks[1] = 0x000000E0;
slouken@1895
    60
        masks[2] = 0x0000001C;
slouken@1895
    61
        masks[3] = 0x00000003;
slouken@1895
    62
        break;
slouken@1965
    63
    case SDL_PACKEDLAYOUT_4444:
slouken@1895
    64
        masks[0] = 0x0000F000;
slouken@1895
    65
        masks[1] = 0x00000F00;
slouken@1895
    66
        masks[2] = 0x000000F0;
slouken@1895
    67
        masks[3] = 0x0000000F;
slouken@1895
    68
        break;
slouken@1965
    69
    case SDL_PACKEDLAYOUT_1555:
slouken@1895
    70
        masks[0] = 0x00008000;
slouken@1895
    71
        masks[1] = 0x00007C00;
slouken@1895
    72
        masks[2] = 0x000003E0;
slouken@1895
    73
        masks[3] = 0x0000001F;
slouken@1895
    74
        break;
slouken@1965
    75
    case SDL_PACKEDLAYOUT_565:
slouken@1895
    76
        masks[0] = 0x00000000;
slouken@1895
    77
        masks[1] = 0x0000F800;
slouken@1895
    78
        masks[2] = 0x000007E0;
slouken@1895
    79
        masks[3] = 0x0000001F;
slouken@1895
    80
        break;
slouken@1965
    81
    case SDL_PACKEDLAYOUT_8888:
slouken@1895
    82
        masks[0] = 0xFF000000;
slouken@1895
    83
        masks[1] = 0x00FF0000;
slouken@1895
    84
        masks[2] = 0x0000FF00;
slouken@1895
    85
        masks[3] = 0x000000FF;
slouken@1895
    86
        break;
slouken@1965
    87
    case SDL_PACKEDLAYOUT_2101010:
slouken@1895
    88
        masks[0] = 0xC0000000;
slouken@1895
    89
        masks[1] = 0x3FF00000;
slouken@1895
    90
        masks[2] = 0x000FFC00;
slouken@1895
    91
        masks[3] = 0x000003FF;
slouken@1895
    92
        break;
slouken@1895
    93
    default:
slouken@1895
    94
        /* Unknown layout */
slouken@1895
    95
        return SDL_FALSE;
slouken@1895
    96
    }
slouken@1895
    97
slouken@1895
    98
    switch (SDL_PIXELORDER(format)) {
slouken@1965
    99
    case SDL_PACKEDORDER_XRGB:
slouken@1895
   100
        *Rmask = masks[1];
slouken@1895
   101
        *Gmask = masks[2];
slouken@1895
   102
        *Bmask = masks[3];
slouken@1895
   103
        break;
slouken@1965
   104
    case SDL_PACKEDORDER_RGBX:
slouken@1895
   105
        *Rmask = masks[0];
slouken@1895
   106
        *Gmask = masks[1];
slouken@1895
   107
        *Bmask = masks[2];
slouken@1895
   108
        break;
slouken@1965
   109
    case SDL_PACKEDORDER_ARGB:
slouken@1895
   110
        *Amask = masks[0];
slouken@1895
   111
        *Rmask = masks[1];
slouken@1895
   112
        *Gmask = masks[2];
slouken@1895
   113
        *Bmask = masks[3];
slouken@1895
   114
        break;
slouken@1965
   115
    case SDL_PACKEDORDER_RGBA:
slouken@1895
   116
        *Rmask = masks[0];
slouken@1895
   117
        *Gmask = masks[1];
slouken@1895
   118
        *Bmask = masks[2];
slouken@1895
   119
        *Amask = masks[3];
slouken@1895
   120
        break;
slouken@1965
   121
    case SDL_PACKEDORDER_XBGR:
slouken@1895
   122
        *Bmask = masks[1];
slouken@1895
   123
        *Gmask = masks[2];
slouken@1895
   124
        *Rmask = masks[3];
slouken@1895
   125
        break;
slouken@1965
   126
    case SDL_PACKEDORDER_BGRX:
slouken@1895
   127
        *Bmask = masks[0];
slouken@1895
   128
        *Gmask = masks[1];
slouken@1895
   129
        *Rmask = masks[2];
slouken@1895
   130
        break;
slouken@1965
   131
    case SDL_PACKEDORDER_BGRA:
slouken@1895
   132
        *Bmask = masks[0];
slouken@1895
   133
        *Gmask = masks[1];
slouken@1895
   134
        *Rmask = masks[2];
slouken@1895
   135
        *Amask = masks[3];
slouken@1895
   136
        break;
slouken@1965
   137
    case SDL_PACKEDORDER_ABGR:
slouken@1895
   138
        *Amask = masks[0];
slouken@1895
   139
        *Bmask = masks[1];
slouken@1895
   140
        *Gmask = masks[2];
slouken@1895
   141
        *Rmask = masks[3];
slouken@1895
   142
        break;
slouken@1895
   143
    default:
slouken@1895
   144
        /* Unknown order */
slouken@1895
   145
        return SDL_FALSE;
slouken@1895
   146
    }
slouken@1895
   147
    return SDL_TRUE;
slouken@1895
   148
}
slouken@1895
   149
slouken@1895
   150
Uint32
slouken@1895
   151
SDL_MasksToPixelFormatEnum(int bpp, Uint32 Rmask, Uint32 Gmask, Uint32 Bmask,
slouken@1895
   152
                           Uint32 Amask)
slouken@1895
   153
{
slouken@1895
   154
    switch (bpp) {
slouken@1895
   155
    case 8:
slouken@1895
   156
        switch (Rmask) {
slouken@1895
   157
        case 0:
slouken@1965
   158
            return SDL_PIXELFORMAT_INDEX8;
slouken@1895
   159
        case 0xE0:
slouken@1965
   160
            return SDL_PIXELFORMAT_RGB332;
slouken@1895
   161
        }
slouken@1895
   162
        break;
slouken@1895
   163
    case 12:
slouken@1895
   164
        switch (Rmask) {
slouken@1895
   165
        case 0x0F00:
slouken@1965
   166
            return SDL_PIXELFORMAT_RGB444;
slouken@1895
   167
        }
slouken@1895
   168
        break;
slouken@1895
   169
    case 15:
slouken@1895
   170
        switch (Rmask) {
slouken@2735
   171
        case 0x001F:
slouken@2735
   172
            return SDL_PIXELFORMAT_BGR555;
slouken@1895
   173
        case 0x7C00:
slouken@1965
   174
            return SDL_PIXELFORMAT_RGB555;
slouken@1895
   175
        }
slouken@1895
   176
        break;
slouken@1895
   177
    case 16:
slouken@1895
   178
        switch (Rmask) {
slouken@2735
   179
        case 0x001F:
slouken@2735
   180
            return SDL_PIXELFORMAT_ABGR1555;
slouken@1895
   181
        case 0x0F00:
slouken@1965
   182
            return SDL_PIXELFORMAT_ARGB4444;
slouken@1895
   183
        case 0x7C00:
slouken@1965
   184
            return SDL_PIXELFORMAT_ARGB1555;
slouken@1895
   185
        case 0xF800:
slouken@1965
   186
            return SDL_PIXELFORMAT_RGB565;
slouken@1895
   187
        }
slouken@1895
   188
        break;
slouken@1895
   189
    case 32:
slouken@1895
   190
        switch (Rmask) {
slouken@1895
   191
        case 0xFF000000:
slouken@1895
   192
            if (Amask == 0x000000FF) {
slouken@1965
   193
                return SDL_PIXELFORMAT_RGBA8888;
slouken@1895
   194
            }
slouken@1895
   195
            break;
slouken@1895
   196
        case 0x00FF0000:
slouken@1895
   197
            if (Amask == 0xFF000000) {
slouken@1965
   198
                return SDL_PIXELFORMAT_ARGB8888;
slouken@1895
   199
            } else {
slouken@1965
   200
                return SDL_PIXELFORMAT_RGB888;
slouken@1895
   201
            }
slouken@1895
   202
            break;
slouken@1895
   203
        case 0x0000FF00:
slouken@1895
   204
            if (Amask == 0x000000FF) {
slouken@1965
   205
                return SDL_PIXELFORMAT_BGRA8888;
slouken@1895
   206
            }
slouken@1895
   207
            break;
slouken@1895
   208
        case 0x000000FF:
slouken@1895
   209
            if (Amask == 0xFF000000) {
slouken@1965
   210
                return SDL_PIXELFORMAT_ABGR8888;
slouken@1895
   211
            } else {
slouken@1965
   212
                return SDL_PIXELFORMAT_BGR888;
slouken@1895
   213
            }
slouken@1895
   214
            break;
slouken@1895
   215
        case 0x3FF00000:
slouken@1965
   216
            return SDL_PIXELFORMAT_ARGB2101010;
slouken@1895
   217
        }
slouken@1895
   218
    }
slouken@1965
   219
    return SDL_PIXELFORMAT_UNKNOWN;
slouken@1895
   220
}
slouken@1895
   221
slouken@1895
   222
slouken@1895
   223
SDL_Palette *
slouken@1895
   224
SDL_AllocPalette(int ncolors)
slouken@1895
   225
{
slouken@1895
   226
    SDL_Palette *palette;
slouken@1895
   227
slouken@1895
   228
    palette = (SDL_Palette *) SDL_malloc(sizeof(*palette));
slouken@1895
   229
    if (!palette) {
slouken@1895
   230
        SDL_OutOfMemory();
slouken@1895
   231
        return NULL;
slouken@1895
   232
    }
slouken@1895
   233
    palette->colors =
slouken@1895
   234
        (SDL_Color *) SDL_malloc(ncolors * sizeof(*palette->colors));
slouken@1895
   235
    if (!palette->colors) {
slouken@1895
   236
        SDL_free(palette);
slouken@1895
   237
        return NULL;
slouken@1895
   238
    }
slouken@1895
   239
    palette->ncolors = ncolors;
slouken@1895
   240
    palette->watch = NULL;
slouken@1895
   241
    palette->refcount = 1;
slouken@1895
   242
slouken@1895
   243
    SDL_memset(palette->colors, 0xFF, ncolors * sizeof(*palette->colors));
slouken@1895
   244
slouken@1895
   245
    return palette;
slouken@1895
   246
}
slouken@1895
   247
slouken@1895
   248
int
slouken@1895
   249
SDL_AddPaletteWatch(SDL_Palette * palette, SDL_PaletteChangedFunc callback,
slouken@1895
   250
                    void *userdata)
slouken@1895
   251
{
slouken@1895
   252
    SDL_PaletteWatch *watch;
slouken@1895
   253
slouken@1895
   254
    if (!palette) {
slouken@1895
   255
        return -1;
slouken@1895
   256
    }
slouken@1895
   257
slouken@1895
   258
    watch = (SDL_PaletteWatch *) SDL_malloc(sizeof(*watch));
slouken@1895
   259
    if (!watch) {
slouken@1895
   260
        SDL_OutOfMemory();
slouken@1895
   261
        return -1;
slouken@1895
   262
    }
slouken@1895
   263
slouken@1895
   264
    watch->callback = callback;
slouken@1895
   265
    watch->userdata = userdata;
slouken@1895
   266
    watch->next = palette->watch;
slouken@1895
   267
    palette->watch = watch;
slouken@1895
   268
    ++palette->refcount;
slouken@1895
   269
    return 0;
slouken@1895
   270
}
slouken@1895
   271
slouken@1895
   272
void
slouken@1895
   273
SDL_DelPaletteWatch(SDL_Palette * palette, SDL_PaletteChangedFunc callback,
slouken@1895
   274
                    void *userdata)
slouken@1895
   275
{
slouken@1895
   276
    SDL_PaletteWatch *prev, *watch;
slouken@1895
   277
slouken@1895
   278
    if (!palette) {
slouken@1895
   279
        return;
slouken@1895
   280
    }
slouken@1895
   281
slouken@1895
   282
    for (prev = NULL, watch = palette->watch; watch;
slouken@1895
   283
         prev = watch, watch = watch->next) {
slouken@1895
   284
        if (watch->callback == callback && watch->userdata == userdata) {
slouken@1895
   285
            if (prev) {
slouken@1895
   286
                prev->next = watch->next;
slouken@1895
   287
            } else {
slouken@1895
   288
                palette->watch = watch->next;
slouken@1895
   289
            }
slouken@1895
   290
            SDL_free(watch);
slouken@1895
   291
            SDL_FreePalette(palette);
slouken@1895
   292
            return;
slouken@1895
   293
        }
slouken@1895
   294
    }
slouken@1895
   295
}
slouken@1895
   296
slouken@1895
   297
int
slouken@1895
   298
SDL_SetPaletteColors(SDL_Palette * palette, const SDL_Color * colors,
slouken@1895
   299
                     int firstcolor, int ncolors)
slouken@1895
   300
{
slouken@1895
   301
    SDL_PaletteWatch *watch;
slouken@1895
   302
    int status = 0;
slouken@1895
   303
slouken@1895
   304
    /* Verify the parameters */
slouken@1895
   305
    if (!palette) {
slouken@1895
   306
        return -1;
slouken@1895
   307
    }
slouken@1895
   308
    if (ncolors > (palette->ncolors - firstcolor)) {
slouken@1895
   309
        ncolors = (palette->ncolors - firstcolor);
slouken@1895
   310
        status = -1;
slouken@1895
   311
    }
slouken@1895
   312
slouken@1895
   313
    if (colors != (palette->colors + firstcolor)) {
slouken@1895
   314
        SDL_memcpy(palette->colors + firstcolor, colors,
slouken@1895
   315
                   ncolors * sizeof(*colors));
slouken@1895
   316
    }
slouken@1895
   317
slouken@1895
   318
    for (watch = palette->watch; watch; watch = watch->next) {
slouken@1895
   319
        if (watch->callback(watch->userdata, palette) < 0) {
slouken@1895
   320
            status = -1;
slouken@1895
   321
        }
slouken@1895
   322
    }
slouken@1895
   323
slouken@1895
   324
    return status;
slouken@1895
   325
}
slouken@1895
   326
slouken@1895
   327
void
slouken@1895
   328
SDL_FreePalette(SDL_Palette * palette)
slouken@1895
   329
{
slouken@1895
   330
    if (!palette) {
slouken@1895
   331
        return;
slouken@1895
   332
    }
slouken@1895
   333
    if (--palette->refcount > 0) {
slouken@1895
   334
        return;
slouken@1895
   335
    }
slouken@1895
   336
    if (palette->colors) {
slouken@1895
   337
        SDL_free(palette->colors);
slouken@1895
   338
    }
slouken@1895
   339
    SDL_free(palette);
slouken@1895
   340
}
slouken@1895
   341
slouken@0
   342
/*
slouken@0
   343
 * Allocate a pixel format structure and fill it according to the given info.
slouken@0
   344
 */
slouken@1895
   345
SDL_PixelFormat *
slouken@1895
   346
SDL_AllocFormat(int bpp,
slouken@1895
   347
                Uint32 Rmask, Uint32 Gmask, Uint32 Bmask, Uint32 Amask)
slouken@0
   348
{
slouken@1895
   349
    SDL_PixelFormat *format;
slouken@0
   350
slouken@1895
   351
    /* Allocate an empty pixel format structure */
slouken@2967
   352
    format = SDL_malloc(sizeof(*format));
slouken@1895
   353
    if (format == NULL) {
slouken@1895
   354
        SDL_OutOfMemory();
slouken@1895
   355
        return (NULL);
slouken@1895
   356
    }
slouken@0
   357
slouken@1895
   358
    /* Set up the format */
slouken@2967
   359
    return SDL_InitFormat(format, bpp, Rmask, Gmask, Bmask, Amask);
slouken@2967
   360
}
slouken@2967
   361
slouken@2967
   362
SDL_PixelFormat *
slouken@2990
   363
SDL_InitFormat(SDL_PixelFormat * format, int bpp, Uint32 Rmask, Uint32 Gmask,
slouken@2990
   364
               Uint32 Bmask, Uint32 Amask)
slouken@2967
   365
{
slouken@2967
   366
    Uint32 mask;
slouken@2967
   367
slouken@2967
   368
    /* Set up the format */
slouken@2967
   369
    SDL_zerop(format);
slouken@1895
   370
    format->BitsPerPixel = bpp;
slouken@1895
   371
    format->BytesPerPixel = (bpp + 7) / 8;
slouken@1895
   372
    if (Rmask || Bmask || Gmask) {      /* Packed pixels with custom mask */
slouken@1895
   373
        format->Rshift = 0;
slouken@1895
   374
        format->Rloss = 8;
slouken@1895
   375
        if (Rmask) {
slouken@1895
   376
            for (mask = Rmask; !(mask & 0x01); mask >>= 1)
slouken@1895
   377
                ++format->Rshift;
slouken@1895
   378
            for (; (mask & 0x01); mask >>= 1)
slouken@1895
   379
                --format->Rloss;
slouken@1895
   380
        }
slouken@1895
   381
        format->Gshift = 0;
slouken@1895
   382
        format->Gloss = 8;
slouken@1895
   383
        if (Gmask) {
slouken@1895
   384
            for (mask = Gmask; !(mask & 0x01); mask >>= 1)
slouken@1895
   385
                ++format->Gshift;
slouken@1895
   386
            for (; (mask & 0x01); mask >>= 1)
slouken@1895
   387
                --format->Gloss;
slouken@1895
   388
        }
slouken@1895
   389
        format->Bshift = 0;
slouken@1895
   390
        format->Bloss = 8;
slouken@1895
   391
        if (Bmask) {
slouken@1895
   392
            for (mask = Bmask; !(mask & 0x01); mask >>= 1)
slouken@1895
   393
                ++format->Bshift;
slouken@1895
   394
            for (; (mask & 0x01); mask >>= 1)
slouken@1895
   395
                --format->Bloss;
slouken@1895
   396
        }
slouken@1895
   397
        format->Ashift = 0;
slouken@1895
   398
        format->Aloss = 8;
slouken@1895
   399
        if (Amask) {
slouken@1895
   400
            for (mask = Amask; !(mask & 0x01); mask >>= 1)
slouken@1895
   401
                ++format->Ashift;
slouken@1895
   402
            for (; (mask & 0x01); mask >>= 1)
slouken@1895
   403
                --format->Aloss;
slouken@1895
   404
        }
slouken@1895
   405
        format->Rmask = Rmask;
slouken@1895
   406
        format->Gmask = Gmask;
slouken@1895
   407
        format->Bmask = Bmask;
slouken@1895
   408
        format->Amask = Amask;
slouken@1895
   409
    } else if (bpp > 8) {       /* Packed pixels with standard mask */
slouken@1895
   410
        /* R-G-B */
slouken@1895
   411
        if (bpp > 24)
slouken@1895
   412
            bpp = 24;
slouken@1895
   413
        format->Rloss = 8 - (bpp / 3);
slouken@1895
   414
        format->Gloss = 8 - (bpp / 3) - (bpp % 3);
slouken@1895
   415
        format->Bloss = 8 - (bpp / 3);
slouken@1895
   416
        format->Rshift = ((bpp / 3) + (bpp % 3)) + (bpp / 3);
slouken@1895
   417
        format->Gshift = (bpp / 3);
slouken@1895
   418
        format->Bshift = 0;
slouken@1895
   419
        format->Rmask = ((0xFF >> format->Rloss) << format->Rshift);
slouken@1895
   420
        format->Gmask = ((0xFF >> format->Gloss) << format->Gshift);
slouken@1895
   421
        format->Bmask = ((0xFF >> format->Bloss) << format->Bshift);
slouken@1895
   422
    } else {
slouken@1895
   423
        /* Palettized formats have no mask info */
slouken@1895
   424
        format->Rloss = 8;
slouken@1895
   425
        format->Gloss = 8;
slouken@1895
   426
        format->Bloss = 8;
slouken@1895
   427
        format->Aloss = 8;
slouken@1895
   428
        format->Rshift = 0;
slouken@1895
   429
        format->Gshift = 0;
slouken@1895
   430
        format->Bshift = 0;
slouken@1895
   431
        format->Ashift = 0;
slouken@1895
   432
        format->Rmask = 0;
slouken@1895
   433
        format->Gmask = 0;
slouken@1895
   434
        format->Bmask = 0;
slouken@1895
   435
        format->Amask = 0;
slouken@1895
   436
    }
slouken@1895
   437
    format->palette = NULL;
slouken@1057
   438
slouken@2967
   439
    return format;
slouken@0
   440
}
slouken@0
   441
slouken@0
   442
/*
slouken@0
   443
 * Change any previous mappings from/to the new surface format
slouken@0
   444
 */
slouken@1895
   445
void
slouken@1895
   446
SDL_FormatChanged(SDL_Surface * surface)
slouken@0
   447
{
slouken@1895
   448
    static int format_version = 0;
slouken@1895
   449
    ++format_version;
slouken@1895
   450
    if (format_version < 0) {   /* It wrapped... */
slouken@1895
   451
        format_version = 1;
slouken@1895
   452
    }
slouken@1895
   453
    surface->format_version = format_version;
slouken@1895
   454
    SDL_InvalidateMap(surface->map);
slouken@0
   455
}
slouken@1895
   456
slouken@0
   457
/*
slouken@0
   458
 * Free a previously allocated format structure
slouken@0
   459
 */
slouken@1895
   460
void
slouken@1895
   461
SDL_FreeFormat(SDL_PixelFormat * format)
slouken@0
   462
{
slouken@1895
   463
    if (!format) {
slouken@1895
   464
        return;
slouken@1895
   465
    }
slouken@1895
   466
    SDL_free(format);
slouken@0
   467
}
slouken@1895
   468
slouken@0
   469
/*
slouken@0
   470
 * Calculate an 8-bit (3 red, 3 green, 2 blue) dithered palette of colors
slouken@0
   471
 */
slouken@1895
   472
void
slouken@1895
   473
SDL_DitherColors(SDL_Color * colors, int bpp)
slouken@0
   474
{
slouken@1895
   475
    int i;
slouken@1895
   476
    if (bpp != 8)
slouken@1895
   477
        return;                 /* only 8bpp supported right now */
slouken@0
   478
slouken@1895
   479
    for (i = 0; i < 256; i++) {
slouken@1895
   480
        int r, g, b;
slouken@1895
   481
        /* map each bit field to the full [0, 255] interval,
slouken@1895
   482
           so 0 is mapped to (0, 0, 0) and 255 to (255, 255, 255) */
slouken@1895
   483
        r = i & 0xe0;
slouken@1895
   484
        r |= r >> 3 | r >> 6;
slouken@1895
   485
        colors[i].r = r;
slouken@1895
   486
        g = (i << 3) & 0xe0;
slouken@1895
   487
        g |= g >> 3 | g >> 6;
slouken@1895
   488
        colors[i].g = g;
slouken@1895
   489
        b = i & 0x3;
slouken@1895
   490
        b |= b << 2;
slouken@1895
   491
        b |= b << 4;
slouken@1895
   492
        colors[i].b = b;
slouken@1895
   493
        colors[i].unused = SDL_ALPHA_OPAQUE;
slouken@1895
   494
    }
slouken@0
   495
}
slouken@1895
   496
slouken@0
   497
/* 
slouken@0
   498
 * Calculate the pad-aligned scanline width of a surface
slouken@0
   499
 */
slouken@1895
   500
int
slouken@1895
   501
SDL_CalculatePitch(SDL_Surface * surface)
slouken@0
   502
{
slouken@1895
   503
    int pitch;
slouken@0
   504
slouken@1895
   505
    /* Surface should be 4-byte aligned for speed */
slouken@1895
   506
    pitch = surface->w * surface->format->BytesPerPixel;
slouken@1895
   507
    switch (surface->format->BitsPerPixel) {
slouken@1895
   508
    case 1:
slouken@1895
   509
        pitch = (pitch + 7) / 8;
slouken@1895
   510
        break;
slouken@1895
   511
    case 4:
slouken@1895
   512
        pitch = (pitch + 1) / 2;
slouken@1895
   513
        break;
slouken@1895
   514
    default:
slouken@1895
   515
        break;
slouken@1895
   516
    }
slouken@1895
   517
    pitch = (pitch + 3) & ~3;   /* 4-byte aligning */
slouken@1895
   518
    return (pitch);
slouken@0
   519
}
slouken@1895
   520
slouken@0
   521
/*
slouken@0
   522
 * Match an RGB value to a particular palette index
slouken@0
   523
 */
slouken@1895
   524
Uint8
slouken@1895
   525
SDL_FindColor(SDL_Palette * pal, Uint8 r, Uint8 g, Uint8 b)
slouken@0
   526
{
slouken@1895
   527
    /* Do colorspace distance matching */
slouken@1895
   528
    unsigned int smallest;
slouken@1895
   529
    unsigned int distance;
slouken@1895
   530
    int rd, gd, bd;
slouken@1895
   531
    int i;
slouken@1895
   532
    Uint8 pixel = 0;
slouken@1895
   533
slouken@1895
   534
    smallest = ~0;
slouken@1895
   535
    for (i = 0; i < pal->ncolors; ++i) {
slouken@1895
   536
        rd = pal->colors[i].r - r;
slouken@1895
   537
        gd = pal->colors[i].g - g;
slouken@1895
   538
        bd = pal->colors[i].b - b;
slouken@1895
   539
        distance = (rd * rd) + (gd * gd) + (bd * bd);
slouken@1895
   540
        if (distance < smallest) {
slouken@1895
   541
            pixel = i;
slouken@1895
   542
            if (distance == 0) {        /* Perfect match! */
slouken@1895
   543
                break;
slouken@1895
   544
            }
slouken@1895
   545
            smallest = distance;
slouken@1895
   546
        }
slouken@1895
   547
    }
slouken@1895
   548
    return (pixel);
slouken@0
   549
}
slouken@0
   550
slouken@0
   551
/* Find the opaque pixel value corresponding to an RGB triple */
slouken@1895
   552
Uint32
slouken@2275
   553
SDL_MapRGB(const SDL_PixelFormat * format, Uint8 r, Uint8 g, Uint8 b)
slouken@0
   554
{
slouken@1895
   555
    if (format->palette == NULL) {
slouken@1895
   556
        return (r >> format->Rloss) << format->Rshift
slouken@1895
   557
            | (g >> format->Gloss) << format->Gshift
slouken@1895
   558
            | (b >> format->Bloss) << format->Bshift | format->Amask;
slouken@1895
   559
    } else {
slouken@1895
   560
        return SDL_FindColor(format->palette, r, g, b);
slouken@1895
   561
    }
slouken@0
   562
}
slouken@0
   563
slouken@0
   564
/* Find the pixel value corresponding to an RGBA quadruple */
slouken@1895
   565
Uint32
slouken@2275
   566
SDL_MapRGBA(const SDL_PixelFormat * format, Uint8 r, Uint8 g, Uint8 b,
slouken@2275
   567
            Uint8 a)
slouken@0
   568
{
slouken@1895
   569
    if (format->palette == NULL) {
slouken@1895
   570
        return (r >> format->Rloss) << format->Rshift
slouken@1895
   571
            | (g >> format->Gloss) << format->Gshift
slouken@1895
   572
            | (b >> format->Bloss) << format->Bshift
slouken@1895
   573
            | ((a >> format->Aloss) << format->Ashift & format->Amask);
slouken@1895
   574
    } else {
slouken@1895
   575
        return SDL_FindColor(format->palette, r, g, b);
slouken@1895
   576
    }
slouken@0
   577
}
slouken@0
   578
slouken@1895
   579
void
slouken@2275
   580
SDL_GetRGB(Uint32 pixel, const SDL_PixelFormat * format, Uint8 * r, Uint8 * g,
slouken@2275
   581
           Uint8 * b)
slouken@2275
   582
{
slouken@2275
   583
    if (format->palette == NULL) {
slouken@2275
   584
        /*
slouken@2275
   585
         * This makes sure that the result is mapped to the
slouken@2275
   586
         * interval [0..255], and the maximum value for each
slouken@2275
   587
         * component is 255. This is important to make sure
slouken@2275
   588
         * that white is indeed reported as (255, 255, 255).
slouken@2275
   589
         * This only works for RGB bit fields at least 4 bit
slouken@2275
   590
         * wide, which is almost always the case.
slouken@2275
   591
         */
slouken@2275
   592
        unsigned v;
slouken@2275
   593
        v = (pixel & format->Rmask) >> format->Rshift;
slouken@2275
   594
        *r = (v << format->Rloss) + (v >> (8 - (format->Rloss << 1)));
slouken@2275
   595
        v = (pixel & format->Gmask) >> format->Gshift;
slouken@2275
   596
        *g = (v << format->Gloss) + (v >> (8 - (format->Gloss << 1)));
slouken@2275
   597
        v = (pixel & format->Bmask) >> format->Bshift;
slouken@2275
   598
        *b = (v << format->Bloss) + (v >> (8 - (format->Bloss << 1)));
slouken@2275
   599
    } else {
slouken@2275
   600
        *r = format->palette->colors[pixel].r;
slouken@2275
   601
        *g = format->palette->colors[pixel].g;
slouken@2275
   602
        *b = format->palette->colors[pixel].b;
slouken@2275
   603
    }
slouken@2275
   604
}
slouken@2275
   605
slouken@2275
   606
void
slouken@2275
   607
SDL_GetRGBA(Uint32 pixel, const SDL_PixelFormat * format,
slouken@1895
   608
            Uint8 * r, Uint8 * g, Uint8 * b, Uint8 * a)
slouken@0
   609
{
slouken@2275
   610
    if (format->palette == NULL) {
slouken@1895
   611
        /*
slouken@1895
   612
         * This makes sure that the result is mapped to the
slouken@1895
   613
         * interval [0..255], and the maximum value for each
slouken@1895
   614
         * component is 255. This is important to make sure
slouken@1895
   615
         * that white is indeed reported as (255, 255, 255),
slouken@1895
   616
         * and that opaque alpha is 255.
slouken@1895
   617
         * This only works for RGB bit fields at least 4 bit
slouken@1895
   618
         * wide, which is almost always the case.
slouken@1895
   619
         */
slouken@1895
   620
        unsigned v;
slouken@2275
   621
        v = (pixel & format->Rmask) >> format->Rshift;
slouken@2275
   622
        *r = (v << format->Rloss) + (v >> (8 - (format->Rloss << 1)));
slouken@2275
   623
        v = (pixel & format->Gmask) >> format->Gshift;
slouken@2275
   624
        *g = (v << format->Gloss) + (v >> (8 - (format->Gloss << 1)));
slouken@2275
   625
        v = (pixel & format->Bmask) >> format->Bshift;
slouken@2275
   626
        *b = (v << format->Bloss) + (v >> (8 - (format->Bloss << 1)));
slouken@2275
   627
        if (format->Amask) {
slouken@2275
   628
            v = (pixel & format->Amask) >> format->Ashift;
slouken@2275
   629
            *a = (v << format->Aloss) + (v >> (8 - (format->Aloss << 1)));
slouken@1895
   630
        } else {
slouken@1895
   631
            *a = SDL_ALPHA_OPAQUE;
slouken@1895
   632
        }
slouken@1895
   633
    } else {
slouken@2275
   634
        *r = format->palette->colors[pixel].r;
slouken@2275
   635
        *g = format->palette->colors[pixel].g;
slouken@2275
   636
        *b = format->palette->colors[pixel].b;
slouken@1895
   637
        *a = SDL_ALPHA_OPAQUE;
slouken@1895
   638
    }
slouken@0
   639
}
slouken@0
   640
slouken@0
   641
/* Apply gamma to a set of colors - this is easy. :) */
slouken@1895
   642
void
slouken@1895
   643
SDL_ApplyGamma(Uint16 * gamma, SDL_Color * colors, SDL_Color * output,
slouken@1895
   644
               int ncolors)
slouken@0
   645
{
slouken@1895
   646
    int i;
slouken@0
   647
slouken@1895
   648
    for (i = 0; i < ncolors; ++i) {
slouken@1895
   649
        output[i].r = gamma[0 * 256 + colors[i].r] >> 8;
slouken@1895
   650
        output[i].g = gamma[1 * 256 + colors[i].g] >> 8;
slouken@1895
   651
        output[i].b = gamma[2 * 256 + colors[i].b] >> 8;
slouken@1895
   652
    }
slouken@0
   653
}
slouken@0
   654
slouken@0
   655
/* Map from Palette to Palette */
slouken@1895
   656
static Uint8 *
slouken@1895
   657
Map1to1(SDL_Palette * src, SDL_Palette * dst, int *identical)
slouken@0
   658
{
slouken@1895
   659
    Uint8 *map;
slouken@1895
   660
    int i;
slouken@0
   661
slouken@1895
   662
    if (identical) {
slouken@1895
   663
        if (src->ncolors <= dst->ncolors) {
slouken@1895
   664
            /* If an identical palette, no need to map */
slouken@1895
   665
            if (src == dst
slouken@1895
   666
                ||
slouken@1895
   667
                (SDL_memcmp
slouken@1895
   668
                 (src->colors, dst->colors,
slouken@1895
   669
                  src->ncolors * sizeof(SDL_Color)) == 0)) {
slouken@1895
   670
                *identical = 1;
slouken@1895
   671
                return (NULL);
slouken@1895
   672
            }
slouken@1895
   673
        }
slouken@1895
   674
        *identical = 0;
slouken@1895
   675
    }
slouken@1895
   676
    map = (Uint8 *) SDL_malloc(src->ncolors);
slouken@1895
   677
    if (map == NULL) {
slouken@1895
   678
        SDL_OutOfMemory();
slouken@1895
   679
        return (NULL);
slouken@1895
   680
    }
slouken@1895
   681
    for (i = 0; i < src->ncolors; ++i) {
slouken@1895
   682
        map[i] = SDL_FindColor(dst,
slouken@1895
   683
                               src->colors[i].r, src->colors[i].g,
slouken@1895
   684
                               src->colors[i].b);
slouken@1895
   685
    }
slouken@1895
   686
    return (map);
slouken@0
   687
}
slouken@0
   688
slouken@1895
   689
/* Map from Palette to BitField */
slouken@1895
   690
static Uint8 *
slouken@2267
   691
Map1toN(SDL_PixelFormat * src, Uint8 Rmod, Uint8 Gmod, Uint8 Bmod, Uint8 Amod,
slouken@2267
   692
        SDL_PixelFormat * dst)
slouken@0
   693
{
slouken@1895
   694
    Uint8 *map;
slouken@1895
   695
    int i;
slouken@1895
   696
    int bpp;
slouken@1895
   697
    SDL_Palette *pal = src->palette;
slouken@0
   698
slouken@1895
   699
    bpp = ((dst->BytesPerPixel == 3) ? 4 : dst->BytesPerPixel);
slouken@1895
   700
    map = (Uint8 *) SDL_malloc(pal->ncolors * bpp);
slouken@1895
   701
    if (map == NULL) {
slouken@1895
   702
        SDL_OutOfMemory();
slouken@1895
   703
        return (NULL);
slouken@1895
   704
    }
slouken@0
   705
slouken@1895
   706
    /* We memory copy to the pixel map so the endianness is preserved */
slouken@1895
   707
    for (i = 0; i < pal->ncolors; ++i) {
slouken@2257
   708
        Uint8 A = Amod;
slouken@2267
   709
        Uint8 R = (Uint8) ((pal->colors[i].r * Rmod) / 255);
slouken@2267
   710
        Uint8 G = (Uint8) ((pal->colors[i].g * Gmod) / 255);
slouken@2267
   711
        Uint8 B = (Uint8) ((pal->colors[i].b * Bmod) / 255);
slouken@2257
   712
        ASSEMBLE_RGBA(&map[i * bpp], dst->BytesPerPixel, dst, R, G, B, A);
slouken@1895
   713
    }
slouken@1895
   714
    return (map);
slouken@1895
   715
}
slouken@0
   716
slouken@1895
   717
/* Map from BitField to Dithered-Palette to Palette */
slouken@1895
   718
static Uint8 *
slouken@1895
   719
MapNto1(SDL_PixelFormat * src, SDL_PixelFormat * dst, int *identical)
slouken@1895
   720
{
slouken@1895
   721
    /* Generate a 256 color dither palette */
slouken@1895
   722
    SDL_Palette dithered;
slouken@1895
   723
    SDL_Color colors[256];
slouken@1895
   724
    SDL_Palette *pal = dst->palette;
slouken@1895
   725
slouken@1895
   726
    dithered.ncolors = 256;
slouken@1895
   727
    SDL_DitherColors(colors, 8);
slouken@1895
   728
    dithered.colors = colors;
slouken@1895
   729
    return (Map1to1(&dithered, pal, identical));
slouken@0
   730
}
slouken@1895
   731
slouken@1895
   732
SDL_BlitMap *
slouken@1895
   733
SDL_AllocBlitMap(void)
slouken@0
   734
{
slouken@1895
   735
    SDL_BlitMap *map;
slouken@1895
   736
slouken@1895
   737
    /* Allocate the empty map */
slouken@1920
   738
    map = (SDL_BlitMap *) SDL_calloc(1, sizeof(*map));
slouken@1895
   739
    if (map == NULL) {
slouken@1895
   740
        SDL_OutOfMemory();
slouken@1895
   741
        return (NULL);
slouken@1895
   742
    }
slouken@2267
   743
    map->info.r = 0xFF;
slouken@2267
   744
    map->info.g = 0xFF;
slouken@2267
   745
    map->info.b = 0xFF;
slouken@2267
   746
    map->info.a = 0xFF;
slouken@1895
   747
slouken@1895
   748
    /* It's ready to go */
slouken@1895
   749
    return (map);
slouken@0
   750
}
slouken@1895
   751
slouken@1895
   752
void
slouken@1895
   753
SDL_InvalidateMap(SDL_BlitMap * map)
slouken@0
   754
{
slouken@1895
   755
    if (!map) {
slouken@1895
   756
        return;
slouken@1895
   757
    }
slouken@1895
   758
    map->dst = NULL;
slouken@1895
   759
    map->format_version = (unsigned int) -1;
slouken@2267
   760
    if (map->info.table) {
slouken@2267
   761
        SDL_free(map->info.table);
slouken@2267
   762
        map->info.table = NULL;
slouken@1895
   763
    }
slouken@1895
   764
}
slouken@2735
   765
slouken@1895
   766
int
slouken@1895
   767
SDL_MapSurface(SDL_Surface * src, SDL_Surface * dst)
slouken@1895
   768
{
slouken@1895
   769
    SDL_PixelFormat *srcfmt;
slouken@1895
   770
    SDL_PixelFormat *dstfmt;
slouken@1895
   771
    SDL_BlitMap *map;
slouken@0
   772
slouken@1895
   773
    /* Clear out any previous mapping */
slouken@1895
   774
    map = src->map;
slouken@1895
   775
    if ((src->flags & SDL_RLEACCEL) == SDL_RLEACCEL) {
slouken@1895
   776
        SDL_UnRLESurface(src, 1);
slouken@1895
   777
    }
slouken@1895
   778
    SDL_InvalidateMap(map);
slouken@0
   779
slouken@1895
   780
    /* Figure out what kind of mapping we're doing */
slouken@1895
   781
    map->identity = 0;
slouken@1895
   782
    srcfmt = src->format;
slouken@1895
   783
    dstfmt = dst->format;
slouken@1895
   784
    switch (srcfmt->BytesPerPixel) {
slouken@1895
   785
    case 1:
slouken@1895
   786
        switch (dstfmt->BytesPerPixel) {
slouken@1895
   787
        case 1:
slouken@1895
   788
            /* Palette --> Palette */
slouken@2267
   789
            map->info.table =
slouken@1895
   790
                Map1to1(srcfmt->palette, dstfmt->palette, &map->identity);
slouken@1895
   791
            if (!map->identity) {
slouken@2267
   792
                if (map->info.table == NULL) {
slouken@1895
   793
                    return (-1);
slouken@1895
   794
                }
slouken@1895
   795
            }
slouken@1895
   796
            if (srcfmt->BitsPerPixel != dstfmt->BitsPerPixel)
slouken@1895
   797
                map->identity = 0;
slouken@1895
   798
            break;
slouken@0
   799
slouken@1895
   800
        default:
slouken@1895
   801
            /* Palette --> BitField */
slouken@2267
   802
            map->info.table =
slouken@2267
   803
                Map1toN(srcfmt, src->map->info.r, src->map->info.g,
slouken@2267
   804
                        src->map->info.b, src->map->info.a, dstfmt);
slouken@2267
   805
            if (map->info.table == NULL) {
slouken@1895
   806
                return (-1);
slouken@1895
   807
            }
slouken@1895
   808
            break;
slouken@1895
   809
        }
slouken@1895
   810
        break;
slouken@1895
   811
    default:
slouken@1895
   812
        switch (dstfmt->BytesPerPixel) {
slouken@1895
   813
        case 1:
slouken@1895
   814
            /* BitField --> Palette */
slouken@2267
   815
            map->info.table = MapNto1(srcfmt, dstfmt, &map->identity);
slouken@1895
   816
            if (!map->identity) {
slouken@2267
   817
                if (map->info.table == NULL) {
slouken@1895
   818
                    return (-1);
slouken@1895
   819
                }
slouken@1895
   820
            }
slouken@1895
   821
            map->identity = 0;  /* Don't optimize to copy */
slouken@1895
   822
            break;
slouken@1895
   823
        default:
slouken@1895
   824
            /* BitField --> BitField */
slouken@1895
   825
            if (FORMAT_EQUAL(srcfmt, dstfmt))
slouken@1895
   826
                map->identity = 1;
slouken@1895
   827
            break;
slouken@1895
   828
        }
slouken@1895
   829
        break;
slouken@1895
   830
    }
slouken@0
   831
slouken@1895
   832
    map->dst = dst;
slouken@1895
   833
    map->format_version = dst->format_version;
slouken@0
   834
slouken@1895
   835
    /* Choose your blitters wisely */
slouken@1895
   836
    return (SDL_CalculateBlit(src));
slouken@0
   837
}
slouken@1895
   838
slouken@1895
   839
void
slouken@1895
   840
SDL_FreeBlitMap(SDL_BlitMap * map)
slouken@0
   841
{
slouken@1895
   842
    if (map) {
slouken@1895
   843
        SDL_InvalidateMap(map);
slouken@1895
   844
        SDL_free(map);
slouken@1895
   845
    }
slouken@0
   846
}
slouken@1895
   847
slouken@1895
   848
/* vi: set ts=4 sw=4 expandtab: */