src_c/surface.c

This extension module defines Python type pygame.Surfacepygame object for representing images.

Header file: src_c/include/pygame.h

type pgSurfaceObject

A pygame.Surface instance.

PyTypeObject *pgSurface_Type

The pygame.Surface Python type.

int pgSurface_Check(PyObject *x)

Return true if x is a pygame.Surface instance

Will return false if x is a subclass of Surface. This is a macro. No check is made that x is not NULL.

pgSurfaceObject *pgSurface_New(SDL_Surface *s)

Return a new new pygame surface instance for SDL surface s. Return NULL on error.

pgSurfaceObject *pgSurface_New2(SDL_Surface *s, int owner)

Return a new new pygame surface instance for SDL surface s. If owner is true, the surface will be freed when the python object is destroyed. Return NULL on error.

SDL_Surface *pgSurface_AsSurface(PyObject *x)

Return a pointer the SDL surface represented by the pygame Surface instance x.

This is a macro. Argument x is assumed to be a Surface, or subclass of Surface, instance.

int pgSurface_Blit(PyObject *dstobj, PyObject *srcobj, SDL_Rect *dstrect, SDL_Rect *srcrect, int the_args)

Blit the srcrect portion of Surface srcobj onto Surface dstobj at srcobj

Argument the_args indicates the type of blit to perform: Normal blit (0), PYGAME_BLEND_ADD, PYGAME_BLEND_SUB, PYGAME_BLEND_SUB, PYGAME_BLEND_MULT, PYGAME_BLEND_MIN, PYGAME_BLEND_MAX, PYGAME_BLEND_RGBA_ADD, PYGAME_BLEND_RGBA_SUB, PYGAME_BLEND_RGBA_MULT, PYGAME_BLEND_RGBA_MIN, PYGAME_BLEND_RGBA_MAX, PYGAME_BLEND_ALPHA_SDL2 and PYGAME_BLEND_PREMULTIPLIED. Argument dstrect is updated to the actual area on dstobj affected by the blit.

The C version of the pygame.Surface.blit() method. Return 0 on success, -1 or -2` on an exception.

---

Edit on GitHub