SDL_fillrect.c File Reference

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

Include dependency graph for SDL_fillrect.c:

Go to the source code of this file.

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

SDL_FillRect()

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 238 of file SDL_fillrect.c.

{
    if (!dst) {
        return SDL_SetError("Passed NULL destination surface");
    }
 
    /* If 'rect' == NULL, then fill the whole surface */
    if (!rect) {
        rect = &dst->clip_rect;
        /* Don't attempt to fill if the surface's clip_rect is empty */
        if (SDL_RectEmpty(rect)) {
            return 0;
        }
    }
 
    return SDL_FillRects(dst, rect, 1, color);
}

References rect, SDL_FillRects(), SDL_RectEmpty(), and SDL_SetError.

SDL_FillRect1()

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

static

Definition at line 135 of file SDL_fillrect.c.

{
    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;
    }
}

References NULL, and SDL_memset4().

Referenced by SDL_FillRects().

SDL_FillRect2()

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

static

Definition at line 174 of file SDL_fillrect.c.

{
    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;
    }
}

References NULL, and SDL_memset4().

Referenced by SDL_FillRects().

SDL_FillRect3()

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

static

Definition at line 198 of file SDL_fillrect.c.

{
#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;
    }
}

References NULL.

Referenced by SDL_FillRects().

SDL_FillRect4()

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

static

Definition at line 226 of file SDL_fillrect.c.

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

References SDL_memset4().

Referenced by SDL_FillRects().

SDL_FillRects()

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

Definition at line 299 of file SDL_fillrect.c.

{
    SDL_Rect clipped;
    Uint8 *pixels;
    const SDL_Rect* rect;
    void (*fill_function)(Uint8 * pixels, int pitch, Uint32 color, int w, int h) = NULL;
    int i;
 
    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");
    }
 
    /* Nothing to do */
    if (dst->w == 0 || dst->h == 0) {
        return 0;
    }
 
    /* Perform software fill */
    if (!dst->pixels) {
        return SDL_SetError("SDL_FillRect(): You must lock the surface");
    }
 
    if (!rects) {
        return SDL_SetError("SDL_FillRects() passed NULL rects");
    }
 
#if SDL_ARM_NEON_BLITTERS
    if (SDL_HasNEON() && dst->format->BytesPerPixel != 3 && fill_function == NULL) {
        switch (dst->format->BytesPerPixel) {
        case 1:
            fill_function = fill_8_neon;
            break;
        case 2:
            fill_function = fill_16_neon;
            break;
        case 4:
            fill_function = fill_32_neon;
            break;
        }
    }
#endif
#if SDL_ARM_SIMD_BLITTERS
    if (SDL_HasARMSIMD() && dst->format->BytesPerPixel != 3 && fill_function == NULL) {
        switch (dst->format->BytesPerPixel) {
        case 1:
            fill_function = fill_8_simd;
            break;
        case 2:
            fill_function = fill_16_simd;
            break;
        case 4:
            fill_function = fill_32_simd;
            break;
        }
    }
#endif
 
    if (fill_function == NULL) {
        switch (dst->format->BytesPerPixel) {
        case 1:
            {
                color |= (color << 8);
                color |= (color << 16);
#ifdef __SSE__
                if (SDL_HasSSE()) {
                    fill_function = SDL_FillRect1SSE;
                    break;
                }
#endif
                fill_function = SDL_FillRect1;
                break;
            }
 
        case 2:
            {
                color |= (color << 16);
#ifdef __SSE__
                if (SDL_HasSSE()) {
                    fill_function = SDL_FillRect2SSE;
                    break;
                }
#endif
                fill_function = SDL_FillRect2;
                break;
            }
 
        case 3:
            /* 24-bit RGB is a slow path, at least for now. */
            {
                fill_function = SDL_FillRect3;
                break;
            }
 
        case 4:
            {
#ifdef __SSE__
                if (SDL_HasSSE()) {
                    fill_function = SDL_FillRect4SSE;
                    break;
                }
#endif
                fill_function = SDL_FillRect4;
                break;
            }
 
        default:
            return SDL_SetError("Unsupported pixel format");
        }
    }
 
    for (i = 0; i < count; ++i) {
        rect = &rects[i];
        /* Perform clipping */
        if (!SDL_IntersectRect(rect, &dst->clip_rect, &clipped)) {
            continue;
        }
        rect = &clipped;
 
        pixels = (Uint8 *) dst->pixels + rect->y * dst->pitch +
                                         rect->x * dst->format->BytesPerPixel;
 
        fill_function(pixels, dst->pitch, color, rect->w, rect->h);
    }
 
    /* We're done! */
    return 0;
}

References SDL_Rect::h, i, NULL, rect, SDL_FillRect1(), SDL_FillRect2(), SDL_FillRect3(), SDL_FillRect4(), SDL_HasARMSIMD, SDL_HasNEON, SDL_HasSSE, SDL_IntersectRect, SDL_SetError, void, SDL_Rect::w, SDL_Rect::x, and SDL_Rect::y.

Referenced by SDL_FillRect().