You are looking at historical revision 28285 of this page. It may differ significantly from its current revision.

The sdl-base egg is a successor to the sdl egg (the latter is expected to become deprecated in the future).

Unlike sdl, sdl-base has only the binding for the basic SDL library. This allows for a fine-grained control over what gets linked with your program. For bindings to the complementary libraries see their respective eggs: sdl-img for SDL_Image, sdl-mixer for SDL_Mixer and sdl-ttf for SDL_TTF.

Naming conventions

The sdl-base egg uses roughtly the same naming conventions as the sdl egg and as the guile-sdl: SDL_ prefix is replaced with sdl-, and hyphens are used to separate words instead of camel-case.

Procedures

sdl-version

sdl-version is a structure for holding the version of the SDL library. This is a wrapper for SDL_version structure in the C library. SDL_version consists of 3 fields: major version number, minor version number and patch number. You don’t usually need to create new instances of this structure: you obtain the version of SDL program was compiled with or linked with, and then get individual fields or check if the version is not too old with ``sdl-version-at-least``.

[procedure] (make-sdl-version pointer)

Creates a new wrapper over the C’s SDL_version structure. Usually you won’t need to use this function directly. Instead, use (sdl-compiled-version) and (sdl-linked-version) to obtain the version information.

[procedure] (sdl-version-major sdl-version)

Evaluates to the major version number for an SDL version in question.

[procedure] (sdl-version-minor sdl-version)

Evaluates to the minor version number for an SDL version in question.

[procedure] (sdl-version-patch sdl-version)

Evaluates to the patch number for an SDL version in question.

[procedure] (sdl-version-at-least sdl-version major minor patch)

Convenient function to check all the three components at once: evaluates to #t if the version is newer or equal to the version denoted by the major, minor and patch arguments, or to #f otherwise. This is analogous to the SDL_VERSION_ATLEAST in the C interface.

[procedure] (sdl-compiled-version)

Returns the sdl-version structure describing the SDL version number of the SDL library used during the compilation. This is analogous to the SDL_COMPILEDVERSION macro in the C interface.

[procedure] (sdl-linked-version)

Returns the sdl-version structure describing the SDL version number of the SDL library used the program is linked against. This is analogous to the SDL_VERSION macro in the C interface.

sdl-rect

sdl-rect is a structure for describing a rectangle. It is widely used in the SDL library. It has two fields, x and y, denoting its position and two fields, w and h denoting width and height respectively. All the values are integers and measured in pixels.

[procedure] (make-sdl-rect x y w h)

Creates a new sdl-rect structure with the values given in the arguments.

[procedure] (sdl-rect-buffer sdl-rect)

???

[procedure] (sdl-rect? obj)

Evaluates to #t if obj is sdl-rect, or #f otherwise.

[procedure] (sdl-rect-x sdl-rect)

Evaluates to the horizontal position of the leftmost part of a given sdl-rect in pixels.

[procedure] (sdl-rect-y sdl-rect)

Evaluates to the vertical position of the topmost part a given sdl-rect in pixels. Like in many programming libraries, in SDL the y axis runs from top to bottom.

[procedure] (sdl-rect-w sdl-rect)

Evaluates to the width of a given sdl-rect in pixels.

[procedure] (sdl-rect-h sdl-rect)

Evaluates to the height of a given sdl-rect in pixels.

sdl-pixel-format

The sdl-pixel-format structure describes the way pixels are stored in the surface. It is a wrapper for the SDL_PixelFormat structure in SDL’s C interface.

Currently the sdl egg exposes no function to work with the SDL_Palette structure.

[procedure] (make-sdl-pixel-format pointer)

Creates a new wrapper over the C’s SDL_PixelFormat structure. Usually you won’t need to use this function directly.

[procedure] (sdl-pixel-format? obj)

Evaluates to #t if obj is sdl-pixel-format, or to #f otherwise.

[procedure] (sdl-rect-bytes-per-pixel sdl-rect)

Evaluates to the number of bytes used to store one pixel in a given sdl-pixel-format. The result is always an integer value.

[procedure] (sdl-rect-rmask sdl-rect)

Evaluates to the red mask, 32-bit integer number describing the way red-colour component is stored in a given sdl-pixel-format. The result is always an integer value. The red mask is an integer value in which the bits set to 1 represent bits used to store the red value. Red mask is not used for 8-bit (1-byte) pixel formats.

[procedure] (sdl-rect-gmask sdl-rect)

Evaluates to the green mask, 32-bit integer value. Green mask is not used for 8-bit (1-byte) pixel formats.

[procedure] (sdl-rect-bmask sdl-rect)

Evaluates to the blue mask, 32-bit integer value. Blue mask is not used for 8-bit (1-byte) pixel formats.

[procedure] (sdl-rect-amask sdl-rect)

Evaluates to the alpha mask, 32-bit integer value. Alpha mask is not used for 8-bit (1-byte) pixel formats.

sdl-surface

The sdl_surface structure represents the object used to store image data. It is characterised by width (w), height (h), pixel format (pixel-format), flags describing additional information, the actual pixel values (pixels) and some other information. It is a wrapper over SDL_Surface structure in SDL’s C interface.

Unlike most other objects, surfaces must be explicitly disposed of after using with the sdl-free-surface function.

[procedure] (make-sdl-surface pointer)

Creates a new wrapper over the C’s SDL_PixelFormat structure. Usually you won’t need to use this function directly, its main purpose is interoperability with foreign C code. To create new empty surfaces, use the sdl-create-rgb-surface function. To create surface from files, use

[procedure] (sdl-surface? obj)

Evaluates to #t if obj is sdl-surface, or to #f otherwise.

[procedure] (sdl-create-rgb-surface flags width height depth rmask gmask bmask amask)

Creates a RGB(A) surface with the given height, width, rmask, gmask, bmask and amask. This is a wrapper for SDL_CreateRGBSurface function.

Flags can be: SDL_SWSURFACE (store surface in general-purpose memory) or SDL_HWSURFACE (store surface in video memory), SDL_SRCCOLORKEY (turn on colour-keying; use sdl-set-color-key! to change the value of this flag after surface creation), SDL_SRCALPHA (use alpha-channel for surface; this flag is automatically set if amask is non-zero; sdl-set-alpha! allows to change this flag later). Flags can be combined with +.

[procedure] (sdl-surface-flags sdl-surface)

Evaluates to flags describing the given surface.

[procedure] (sdl-surface-pixel-format sdl-surface)

Evaluates to pixel format describing the given surface.

[procedure] (sdl-surface-width sdl-surface)

Evaluates to the width of a given surface.

[procedure] (sdl-surface-height sdl-surface)

Evaluates to the height of a given surface.

[procedure] (sdl-surface-pitch sdl-surface)

Evaluates to the actual number of bytes describing each row of a given surface.

[procedure] (sdl-surface-pixels sdl-surface)

Evaluates to the pixel data (??? how is it mapped to Scheme objects???) a given surface.

[procedure] (sdl-surface-pixels-length sdl-surface)

Evaluates to the size of pixel data in bytes.