#include "../SDL_internal.h"
#include "SDL_video.h"
#include "SDL_blit.h"

Include dependency graph for SDL_fillrect.c:

Functions
static void	SDL_FillRect1 (Uint8 *pixels, int pitch, Uint32 color, int w, int h)
static void	SDL_FillRect2 (Uint8 *pixels, int pitch, Uint32 color, int w, int h)
static void	SDL_FillRect3 (Uint8 *pixels, int pitch, Uint32 color, int w, int h)
static void	SDL_FillRect4 (Uint8 *pixels, int pitch, Uint32 color, int w, int h)
int	SDL_FillRect (SDL_Surface dst, const SDL_Rect rect, Uint32 color)
int	SDL_FillRects (SDL_Surface dst, const SDL_Rect rects, int count, Uint32 color)

Function Documentation

int SDL_FillRect	(	SDL_Surface *	dst,
		const SDL_Rect *	rect,
		Uint32	color
	)

Performs a fast fill of the given rectangle with color.

If rect is NULL, the whole surface will be filled with color.

The color should be a pixel of the format used by the surface, and can be generated by the SDL_MapRGB() function.

Returns: 0 on success, or -1 on error.

Definition at line 237 of file SDL_fillrect.c.

References SDL_PixelFormat::BitsPerPixel, SDL_PixelFormat::BytesPerPixel, SDL_Surface::clip_rect, SDL_Surface::format, SDL_Rect::h, SDL_Surface::pitch, SDL_Surface::pixels, SDL_FillRect1(), SDL_FillRect2(), SDL_FillRect3(), SDL_FillRect4(), SDL_HasSSE, SDL_IntersectRect, SDL_RectEmpty(), SDL_SetError, SDL_Rect::w, SDL_Rect::x, and SDL_Rect::y.

{
    SDL_Rect clipped;
    Uint8 *pixels;
    if (!dst) {
        return SDL_SetError("Passed NULL destination surface");
    }
    /* This function doesn't work on surfaces < 8 bpp */
    if (dst->format->BitsPerPixel < 8) {
        return SDL_SetError("SDL_FillRect(): Unsupported surface format");
    }
    /* If 'rect' == NULL, then fill the whole surface */
    if (rect) {
        /* Perform clipping */
        if (!SDL_IntersectRect(rect, &dst->clip_rect, &clipped)) {
            return 0;
        }
        rect = &clipped;
    } else {
        rect = &dst->clip_rect;
        /* Don't attempt to fill if the surface's clip_rect is empty */
        if (SDL_RectEmpty(rect)) {
            return 0;
        }
    }
    /* Perform software fill */
    if (!dst->pixels) {
        return SDL_SetError("SDL_FillRect(): You must lock the surface");
    }
    pixels = (Uint8 *) dst->pixels + rect->y * dst->pitch +
                                     rect->x * dst->format->BytesPerPixel;
    switch (dst->format->BytesPerPixel) {
    case 1:
        {
            color |= (color << 8);
            color |= (color << 16);
#ifdef __SSE__
            if (SDL_HasSSE()) {
                SDL_FillRect1SSE(pixels, dst->pitch, color, rect->w, rect->h);
                break;
            }
#endif
            SDL_FillRect1(pixels, dst->pitch, color, rect->w, rect->h);
            break;
        }
    case 2:
        {
            color |= (color << 16);
#ifdef __SSE__
            if (SDL_HasSSE()) {
                SDL_FillRect2SSE(pixels, dst->pitch, color, rect->w, rect->h);
                break;
            }
#endif
            SDL_FillRect2(pixels, dst->pitch, color, rect->w, rect->h);
            break;
        }
    case 3:
        /* 24-bit RGB is a slow path, at least for now. */
        {
            SDL_FillRect3(pixels, dst->pitch, color, rect->w, rect->h);
            break;
        }
    case 4:
        {
#ifdef __SSE__
            if (SDL_HasSSE()) {
                SDL_FillRect4SSE(pixels, dst->pitch, color, rect->w, rect->h);
                break;
            }
#endif
            SDL_FillRect4(pixels, dst->pitch, color, rect->w, rect->h);
            break;
        }
    }
    /* We're done! */
    return 0;
}

static void SDL_FillRect1	(	Uint8 *	pixels,
		int	pitch,
		Uint32	color,
		int	w,
		int	h
	)

static

Definition at line 134 of file SDL_fillrect.c.

References NULL, and SDL_memset4().

Referenced by SDL_FillRect().

{
    int n;
    Uint8 *p = NULL;
    
    while (h--) {
        n = w;
        p = pixels;
        if (n > 3) {
            switch ((uintptr_t) p & 3) {
            case 1:
                *p++ = (Uint8) color;
                --n;                    /* fallthrough */
            case 2:
                *p++ = (Uint8) color;
                --n;                    /* fallthrough */
            case 3:
                *p++ = (Uint8) color;
                --n;                    /* fallthrough */
            }
            SDL_memset4(p, color, (n >> 2));
        }
        if (n & 3) {
            p += (n & ~3);
            switch (n & 3) {
            case 3:
                *p++ = (Uint8) color;   /* fallthrough */
            case 2:
                *p++ = (Uint8) color;   /* fallthrough */
            case 1:
                *p++ = (Uint8) color;   /* fallthrough */
            }
        }
        pixels += pitch;
    }
}

static void SDL_FillRect2	(	Uint8 *	pixels,
		int	pitch,
		Uint32	color,
		int	w,
		int	h
	)

static

Definition at line 173 of file SDL_fillrect.c.

References NULL, and SDL_memset4().

Referenced by SDL_FillRect().

{
    int n;
    Uint16 *p = NULL;
    
    while (h--) {
        n = w;
        p = (Uint16 *) pixels;
        if (n > 1) {
            if ((uintptr_t) p & 2) {
                *p++ = (Uint16) color;
                --n;
            }
            SDL_memset4(p, color, (n >> 1));
        }
        if (n & 1) {
            p[n - 1] = (Uint16) color;
        }
        pixels += pitch;
    }
}

static void SDL_FillRect3	(	Uint8 *	pixels,
		int	pitch,
		Uint32	color,
		int	w,
		int	h
	)

static

Definition at line 197 of file SDL_fillrect.c.

References NULL.

Referenced by SDL_FillRect().

{
#if SDL_BYTEORDER == SDL_LIL_ENDIAN
    Uint8 b1 = (Uint8) (color & 0xFF);
    Uint8 b2 = (Uint8) ((color >> 8) & 0xFF);
    Uint8 b3 = (Uint8) ((color >> 16) & 0xFF);
#elif SDL_BYTEORDER == SDL_BIG_ENDIAN
    Uint8 b1 = (Uint8) ((color >> 16) & 0xFF);
    Uint8 b2 = (Uint8) ((color >> 8) & 0xFF);
    Uint8 b3 = (Uint8) (color & 0xFF);
#endif
    int n;
    Uint8 *p = NULL;
    while (h--) {
        n = w;
        p = pixels;
        while (n--) {
            *p++ = b1;
            *p++ = b2;
            *p++ = b3;
        }
        pixels += pitch;
    }
}

static void SDL_FillRect4	(	Uint8 *	pixels,
		int	pitch,
		Uint32	color,
		int	w,
		int	h
	)

static

Definition at line 225 of file SDL_fillrect.c.

References SDL_memset4().

Referenced by SDL_FillRect().

{
    while (h--) {
        SDL_memset4(pixels, color, w);
        pixels += pitch;
    }
}

int SDL_FillRects	(	SDL_Surface *	dst,
		const SDL_Rect *	rects,
		int	count,
		Uint32	color
	)

Definition at line 327 of file SDL_fillrect.c.

References i, SDL_FillRect, and SDL_SetError.

{
    int i;
    int status = 0;
    if (!rects) {
        return SDL_SetError("SDL_FillRects() passed NULL rects");
    }
    for (i = 0; i < count; ++i) {
        status += SDL_FillRect(dst, &rects[i], color);
    }
    return status;
}

Functions

Function Documentation