This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
/
SDL_surface.c
766 lines (669 loc) · 19.5 KB
1
2
/*
SDL - Simple DirectMedia Layer
3
Copyright (C) 1997-2006 Sam Lantinga
4
5
This library is free software; you can redistribute it and/or
6
modify it under the terms of the GNU Lesser General Public
7
License as published by the Free Software Foundation; either
8
version 2.1 of the License, or (at your option) any later version.
9
10
11
12
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
Lesser General Public License for more details.
14
15
16
17
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
19
Sam Lantinga
20
slouken@libsdl.org
21
*/
22
#include "SDL_config.h"
23
24
#include "SDL_video.h"
25
#include "SDL_compat.h"
26
27
28
29
30
31
#include "SDL_sysvideo.h"
#include "SDL_blit.h"
#include "SDL_RLEaccel_c.h"
#include "SDL_pixels_c.h"
#include "SDL_leaks.h"
32
33
34
35
36
/* Public routines */
/*
* Create an empty RGB surface of the appropriate depth
*/
37
38
39
40
SDL_Surface *
SDL_CreateRGBSurface(Uint32 flags,
int width, int height, int depth,
Uint32 Rmask, Uint32 Gmask, Uint32 Bmask, Uint32 Amask)
41
{
42
43
44
SDL_Surface *surface;
/* Allocate the surface */
45
surface = (SDL_Surface *) SDL_calloc(1, sizeof(*surface));
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
if (surface == NULL) {
SDL_OutOfMemory();
return NULL;
}
surface->format = SDL_AllocFormat(depth, Rmask, Gmask, Bmask, Amask);
if (!surface->format) {
SDL_FreeSurface(surface);
return NULL;
}
if (Amask) {
surface->flags |= SDL_SRCALPHA;
}
surface->w = width;
surface->h = height;
surface->pitch = SDL_CalculatePitch(surface);
SDL_SetClipRect(surface, NULL);
if (surface->format->BitsPerPixel <= 8) {
SDL_Palette *palette =
SDL_AllocPalette((1 << surface->format->BitsPerPixel));
if (!palette) {
SDL_FreeSurface(surface);
return NULL;
}
if (Rmask || Bmask || Gmask) {
const SDL_PixelFormat *format = surface->format;
/* create palette according to masks */
int i;
int Rm = 0, Gm = 0, Bm = 0;
int Rw = 0, Gw = 0, Bw = 0;
if (Rmask) {
Rw = 8 - format->Rloss;
for (i = format->Rloss; i > 0; i -= Rw)
Rm |= 1 << i;
}
if (Gmask) {
Gw = 8 - format->Gloss;
for (i = format->Gloss; i > 0; i -= Gw)
Gm |= 1 << i;
}
if (Bmask) {
Bw = 8 - format->Bloss;
for (i = format->Bloss; i > 0; i -= Bw)
Bm |= 1 << i;
}
for (i = 0; i < palette->ncolors; ++i) {
int r, g, b;
r = (i & Rmask) >> format->Rshift;
r = (r << format->Rloss) | ((r * Rm) >> Rw);
palette->colors[i].r = r;
g = (i & Gmask) >> format->Gshift;
g = (g << format->Gloss) | ((g * Gm) >> Gw);
palette->colors[i].g = g;
b = (i & Bmask) >> format->Bshift;
b = (b << format->Bloss) | ((b * Bm) >> Bw);
palette->colors[i].b = b;
}
} else if (palette->ncolors == 2) {
/* Create a black and white bitmap palette */
palette->colors[0].r = 0xFF;
palette->colors[0].g = 0xFF;
palette->colors[0].b = 0xFF;
palette->colors[1].r = 0x00;
palette->colors[1].g = 0x00;
palette->colors[1].b = 0x00;
}
SDL_SetSurfacePalette(surface, palette);
SDL_FreePalette(palette);
}
/* Get the pixels */
if (surface->w && surface->h) {
surface->pixels = SDL_malloc(surface->h * surface->pitch);
if (!surface->pixels) {
SDL_FreeSurface(surface);
SDL_OutOfMemory();
return NULL;
}
/* This is important for bitmaps */
SDL_memset(surface->pixels, 0, surface->h * surface->pitch);
}
/* Allocate an empty mapping */
surface->map = SDL_AllocBlitMap();
if (!surface->map) {
SDL_FreeSurface(surface);
return NULL;
}
SDL_FormatChanged(surface);
/* The surface is ready to go */
surface->refcount = 1;
143
#ifdef CHECK_LEAKS
144
++surfaces_allocated;
145
#endif
146
return surface;
147
}
148
149
150
151
/*
* Create an RGB surface from an existing memory buffer
*/
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
SDL_Surface *
SDL_CreateRGBSurfaceFrom(void *pixels,
int width, int height, int depth, int pitch,
Uint32 Rmask, Uint32 Gmask, Uint32 Bmask,
Uint32 Amask)
{
SDL_Surface *surface;
surface =
SDL_CreateRGBSurface(0, 0, 0, depth, Rmask, Gmask, Bmask, Amask);
if (surface != NULL) {
surface->flags |= SDL_PREALLOC;
surface->pixels = pixels;
surface->w = width;
surface->h = height;
surface->pitch = pitch;
SDL_SetClipRect(surface, NULL);
}
return surface;
}
static int
SDL_SurfacePaletteChanged(void *userdata, SDL_Palette * palette)
{
SDL_Surface *surface = (SDL_Surface *) userdata;
SDL_FormatChanged(surface);
return 0;
}
int
SDL_SetSurfacePalette(SDL_Surface * surface, SDL_Palette * palette)
185
{
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
if (!surface || !surface->format) {
SDL_SetError("SDL_SetSurfacePalette() passed a NULL surface");
return -1;
}
if (palette && palette->ncolors != (1 << surface->format->BitsPerPixel)) {
SDL_SetError
("SDL_SetSurfacePalette() passed a palette that doesn't match the surface format");
return -1;
}
if (surface->format->palette == palette) {
return 0;
}
if (surface->format->palette) {
SDL_DelPaletteWatch(surface->format->palette,
SDL_SurfacePaletteChanged, surface);
}
surface->format->palette = palette;
if (surface->format->palette) {
SDL_AddPaletteWatch(surface->format->palette,
SDL_SurfacePaletteChanged, surface);
}
return 0;
213
}
214
215
int SDL_SetSurfaceRLE(SDL_Surface *surface, int flag)
216
{
217
218
219
220
221
222
223
224
Uint32 flags;
if (!surface) {
return -1;
}
if (flag) {
surface->flags |= SDL_RLEACCELOK;
225
} else {
226
227
228
229
surface->flags &= ~SDL_RLEACCELOK;
}
if (surface->flags != flags) {
SDL_InvalidateMap(surface->map);
230
}
231
232
return 0;
}
233
234
235
236
237
238
239
int SDL_SetColorKey(SDL_Surface *surface, Uint32 flag, Uint32 key)
{
int flags;
if (!surface) {
return -1;
240
241
}
242
243
if (flag & SDL_RLEACCEL) {
SDL_SetSurfaceRLE(surface, 1);
244
245
}
246
flags = surface->map->info.flags;
247
if (flag) {
248
249
surface->map->info.flags |= SDL_COPY_COLORKEY;
surface->map->info.colorkey = key;
250
} else {
251
surface->map->info.flags &= ~SDL_COPY_COLORKEY;
252
}
253
254
255
256
if (surface->map->info.flags != flags) {
SDL_InvalidateMap(surface->map);
}
return 0;
257
}
258
259
int SDL_SetSurfaceColorMod(SDL_Surface *surface, Uint8 r, Uint8 g, Uint8 b)
260
{
261
262
263
264
265
266
267
268
269
270
271
272
273
int flags;
if (!surface) {
return -1;
}
surface->map->info.r = r;
surface->map->info.g = g;
surface->map->info.b = b;
flags = surface->map->info.flags;
if (r != 0xFF || g != 0xFF || b != 0xFF) {
surface->map->info.flags |= SDL_COPY_MODULATE_COLOR;
274
} else {
275
276
277
278
surface->map->info.flags &= ~SDL_COPY_MODULATE_COLOR;
}
if (surface->map->info.flags != flags) {
SDL_InvalidateMap(surface->map);
279
}
280
281
282
return 0;
}
283
284
285
286
287
int SDL_GetSurfaceColorMod(SDL_Surface *surface, Uint8 * r, Uint8 * g, Uint8 * b)
{
if (!surface) {
return -1;
288
289
}
290
291
292
293
294
295
296
297
298
299
300
if (r) {
*r = surface->map->info.r;
}
if (g) {
*g = surface->map->info.g;
}
if (b) {
*b = surface->map->info.b;
}
return 0;
}
301
302
303
304
305
306
307
308
309
310
311
312
313
314
int SDL_SetSurfaceAlphaMod(SDL_Surface *surface, Uint8 alpha)
{
int flags;
if (!surface) {
return -1;
}
surface->map->info.a = alpha;
flags = surface->map->info.flags;
if (alpha != 0xFF) {
surface->map->info.flags |= SDL_COPY_MODULATE_ALPHA;
315
} else {
316
317
318
surface->map->info.flags &= ~SDL_COPY_MODULATE_ALPHA;
}
if (surface->map->info.flags != flags) {
319
320
SDL_InvalidateMap(surface->map);
}
321
return 0;
322
}
323
324
int SDL_GetSurfaceAlphaMod(SDL_Surface *surface, Uint8 * alpha)
325
{
326
327
328
329
330
331
332
333
334
if (!surface) {
return -1;
}
if (alpha) {
*alpha = surface->map->info.a;
}
return 0;
}
335
336
337
338
339
340
int SDL_SetSurfaceBlendMode(SDL_Surface *surface, int blendMode)
{
int flags, status;
if (!surface) {
341
342
return -1;
}
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
status = 0;
flags = surface->map->info.flags;
surface->map->info.flags &= ~(SDL_COPY_MASK|SDL_COPY_BLEND|SDL_COPY_ADD|SDL_COPY_MOD);
switch (blendMode) {
case SDL_TEXTUREBLENDMODE_NONE:
break;
case SDL_TEXTUREBLENDMODE_MASK:
surface->map->info.flags |= SDL_COPY_MASK;
break;
case SDL_TEXTUREBLENDMODE_BLEND:
surface->map->info.flags |= SDL_COPY_BLEND;
break;
case SDL_TEXTUREBLENDMODE_ADD:
surface->map->info.flags |= SDL_COPY_ADD;
break;
case SDL_TEXTUREBLENDMODE_MOD:
surface->map->info.flags |= SDL_COPY_MOD;
break;
default:
SDL_Unsupported();
status = -1;
break;
}
if (surface->map->info.flags != flags) {
SDL_InvalidateMap(surface->map);
370
}
371
372
373
374
375
376
377
return status;
}
int SDL_GetSurfaceBlendMode(SDL_Surface *surface, int *blendMode)
{
if (!surface) {
return -1;
378
}
379
380
381
if (!blendMode) {
return 0;
382
}
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
switch(surface->map->info.flags & (SDL_COPY_MASK|SDL_COPY_BLEND|SDL_COPY_ADD|SDL_COPY_MOD)) {
case SDL_COPY_MASK:
*blendMode = SDL_TEXTUREBLENDMODE_MASK:
break;
case SDL_COPY_BLEND:
*blendMode = SDL_TEXTUREBLENDMODE_BLEND:
break;
case SDL_COPY_ADD:
*blendMode = SDL_TEXTUREBLENDMODE_ADD:
break;
case SDL_COPY_MOD:
*blendMode = SDL_TEXTUREBLENDMODE_MOD:
break;
default:
*blendMode = SDL_TEXTUREBLENDMODE_NONE:
break;
400
}
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
return 0;
}
int SDL_SetSurfaceScaleMode(SDL_Surface *surface, int scaleMode)
{
int flags, status;
if (!surface) {
return -1;
}
status = 0;
flags = surface->map->info.flags;
surface->map->info.flags &= ~(SDL_COPY_NEAREST);
switch (scaleMode) {
case SDL_TEXTURESCALEMODE_NONE:
break;
case SDL_TEXTURESCALEMODE_FAST:
surface->map->info.flags |= SDL_COPY_NEAREST;
break;
case SDL_TEXTURESCALEMODE_SLOW:
case SDL_TEXTURESCALEMODE_BEST:
SDL_Unsupported();
surface->map->info.flags |= SDL_COPY_NEAREST;
status = -1;
break;
default:
SDL_Unsupported();
status = -1;
break;
}
if (surface->map->info.flags != flags) {
SDL_InvalidateMap(surface->map);
}
return status;
}
int SDL_GetSurfaceScaleMode(SDL_Surface *surface, int *scaleMode)
{
if (!surface) {
return -1;
}
if (!scaleMode) {
return 0;
}
switch(surface->map->info.flags & (SDL_COPY_LINEAR)) {
case SDL_COPY_LINEAR:
*scaleMode = SDL_TEXTURESCALEMODE_FAST:
break;
default:
*scaleMode = SDL_TEXTURESCALEMODE_NONE:
break;
456
457
}
return 0;
458
}
459
460
461
SDL_bool
SDL_SetClipRect(SDL_Surface * surface, const SDL_Rect * rect)
462
{
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
SDL_Rect full_rect;
/* Don't do anything if there's no surface to act on */
if (!surface) {
return SDL_FALSE;
}
/* Set up the full surface rectangle */
full_rect.x = 0;
full_rect.y = 0;
full_rect.w = surface->w;
full_rect.h = surface->h;
/* Set the clipping rectangle */
if (!rect) {
surface->clip_rect = full_rect;
return 1;
}
return SDL_IntersectRect(rect, &full_rect, &surface->clip_rect);
482
}
483
484
485
void
SDL_GetClipRect(SDL_Surface * surface, SDL_Rect * rect)
486
{
487
488
489
if (surface && rect) {
*rect = surface->clip_rect;
}
490
}
491
492
493
494
495
496
497
498
499
500
501
502
/*
* Set up a blit between two surfaces -- split into three parts:
* The upper part, SDL_UpperBlit(), performs clipping and rectangle
* verification. The lower part is a pointer to a low level
* accelerated blitting function.
*
* These parts are separated out and each used internally by this
* library in the optimimum places. They are exported so that if
* you know exactly what you are doing, you can optimize your code
* by calling the one(s) you need.
*/
503
504
505
int
SDL_LowerBlit(SDL_Surface * src, SDL_Rect * srcrect,
SDL_Surface * dst, SDL_Rect * dstrect)
506
{
507
508
509
510
511
512
513
/* Check to make sure the blit mapping is valid */
if ((src->map->dst != dst) ||
(src->map->dst->format_version != src->map->format_version)) {
if (SDL_MapSurface(src, dst) < 0) {
return (-1);
}
}
514
return (src->map->blit(src, srcrect, dst, dstrect));
515
516
517
}
518
519
520
int
SDL_UpperBlit(SDL_Surface * src, SDL_Rect * srcrect,
SDL_Surface * dst, SDL_Rect * dstrect)
521
{
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
SDL_Rect fulldst;
int srcx, srcy, w, h;
/* Make sure the surfaces aren't locked */
if (!src || !dst) {
SDL_SetError("SDL_UpperBlit: passed a NULL surface");
return (-1);
}
if (src->locked || dst->locked) {
SDL_SetError("Surfaces must not be locked during blit");
return (-1);
}
/* If the destination rectangle is NULL, use the entire dest surface */
if (dstrect == NULL) {
fulldst.x = fulldst.y = 0;
dstrect = &fulldst;
}
/* clip the source rectangle to the source surface */
if (srcrect) {
int maxw, maxh;
srcx = srcrect->x;
w = srcrect->w;
if (srcx < 0) {
w += srcx;
dstrect->x -= srcx;
srcx = 0;
}
maxw = src->w - srcx;
if (maxw < w)
w = maxw;
srcy = srcrect->y;
h = srcrect->h;
if (srcy < 0) {
h += srcy;
dstrect->y -= srcy;
srcy = 0;
}
maxh = src->h - srcy;
if (maxh < h)
h = maxh;
} else {
srcx = srcy = 0;
w = src->w;
h = src->h;
}
/* clip the destination rectangle against the clip rectangle */
{
SDL_Rect *clip = &dst->clip_rect;
int dx, dy;
dx = clip->x - dstrect->x;
if (dx > 0) {
w -= dx;
dstrect->x += dx;
srcx += dx;
}
dx = dstrect->x + w - clip->x - clip->w;
if (dx > 0)
w -= dx;
dy = clip->y - dstrect->y;
if (dy > 0) {
h -= dy;
dstrect->y += dy;
srcy += dy;
}
dy = dstrect->y + h - clip->y - clip->h;
if (dy > 0)
h -= dy;
}
if (w > 0 && h > 0) {
SDL_Rect sr;
sr.x = srcx;
sr.y = srcy;
sr.w = dstrect->w = w;
sr.h = dstrect->h = h;
return SDL_LowerBlit(src, &sr, dst, dstrect);
}
dstrect->w = dstrect->h = 0;
return 0;
609
610
611
612
613
}
/*
* Lock a surface to directly access the pixels
*/
614
615
int
SDL_LockSurface(SDL_Surface * surface)
616
{
617
618
619
620
621
622
623
624
625
626
627
628
629
if (!surface->locked) {
/* Perform the lock */
if (surface->flags & SDL_RLEACCEL) {
SDL_UnRLESurface(surface, 1);
surface->flags |= SDL_RLEACCEL; /* save accel'd state */
}
}
/* Increment the surface lock count, for recursive locks */
++surface->locked;
/* Ready to go.. */
return (0);
630
}
631
632
633
634
/*
* Unlock a previously locked surface
*/
635
636
void
SDL_UnlockSurface(SDL_Surface * surface)
637
{
638
639
640
641
642
643
644
645
646
647
/* Only perform an unlock if we are locked */
if (!surface->locked || (--surface->locked > 0)) {
return;
}
/* Update RLE encoded surface with new data */
if ((surface->flags & SDL_RLEACCEL) == SDL_RLEACCEL) {
surface->flags &= ~SDL_RLEACCEL; /* stop lying */
SDL_RLESurface(surface);
}
648
649
650
651
652
}
/*
* Convert a surface into the specified pixel format.
*/
653
654
655
SDL_Surface *
SDL_ConvertSurface(SDL_Surface * surface,
SDL_PixelFormat * format, Uint32 flags)
656
{
657
SDL_Surface *convert;
658
Uint32 copy_flags;
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
SDL_Rect bounds;
/* Check for empty destination palette! (results in empty image) */
if (format->palette != NULL) {
int i;
for (i = 0; i < format->palette->ncolors; ++i) {
if ((format->palette->colors[i].r != 0xFF) ||
(format->palette->colors[i].g != 0xFF) ||
(format->palette->colors[i].b != 0xFF))
break;
}
if (i == format->palette->ncolors) {
SDL_SetError("Empty destination palette");
return (NULL);
}
}
/* Create a new surface with the desired format */
677
convert = SDL_CreateRGBSurface(0, surface->w, surface->h,
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
format->BitsPerPixel, format->Rmask,
format->Gmask, format->Bmask,
format->Amask);
if (convert == NULL) {
return (NULL);
}
/* Copy the palette if any */
if (format->palette && convert->format->palette) {
SDL_memcpy(convert->format->palette->colors,
format->palette->colors,
format->palette->ncolors * sizeof(SDL_Color));
convert->format->palette->ncolors = format->palette->ncolors;
}
693
694
695
/* Save the original copy flags */
copy_flags = surface->map->info.flags;
surface->map->info.flags = 0;
696
697
698
699
700
701
702
703
704
/* Copy over the image data */
bounds.x = 0;
bounds.y = 0;
bounds.w = surface->w;
bounds.h = surface->h;
SDL_LowerBlit(surface, &bounds, convert, &bounds);
/* Clean up the original surface, and update converted surface */
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
SDL_SetClipRect(convert, &surface->clip_rect);
if (copy_flags & SDL_COPY_COLORKEY) {
Uint8 keyR, keyG, keyB, keyA;
SDL_GetRGBA(colorkey, surface->format, &keyR, &keyG, &keyB, &keyA);
SDL_SetColorKey(convert, 1,
SDL_MapRGBA(convert->format, keyR, keyG, keyB, keyA));
}
convert->map->info.r = surface->map->info.r;
convert->map->info.g = surface->map->info.g;
convert->map->info.b = surface->map->info.b;
convert->map->info.a = surface->map->info.a;
convert->map->info.flags = copy_flags;
surface->map->info.flags = copy_flags;
/* Enable alpha blending by default if the new surface has an
* alpha channel or alpha modulation */
if (format->Amask || (copy_flags & SDL_COPY_MODULATE_ALPHA)) {
SDL_SetSurfaceBlendMode(convert, SDL_TEXTUREBLENDMODE_BLEND);
724
725
726
727
}
/* We're ready to go! */
return (convert);
728
729
730
731
732
}
/*
* Free a surface created by the above function.
*/
733
734
void
SDL_FreeSurface(SDL_Surface * surface)
735
{
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
if (surface == NULL) {
return;
}
if (--surface->refcount > 0) {
return;
}
while (surface->locked > 0) {
SDL_UnlockSurface(surface);
}
if (surface->flags & SDL_RLEACCEL) {
SDL_UnRLESurface(surface, 0);
}
if (surface->format) {
SDL_SetSurfacePalette(surface, NULL);
SDL_FreeFormat(surface->format);
surface->format = NULL;
}
if (surface->map != NULL) {
SDL_FreeBlitMap(surface->map);
surface->map = NULL;
}
if (surface->pixels && ((surface->flags & SDL_PREALLOC) != SDL_PREALLOC)) {
SDL_free(surface->pixels);
}
SDL_free(surface);
761
#ifdef CHECK_LEAKS
762
--surfaces_allocated;
763
764
#endif
}
765
766
/* vi: set ts=4 sw=4 expandtab: */