Tao.Sdl SDK Documentation

SdlImage Class

SDL_Image bindings for .NET.

A simple library to load images of various formats as SDL surfaces.

For a list of all members of this type, see SdlImage Members.

System.Object
   Tao.Sdl.SdlImage

[Visual Basic]
MustInherit NotInheritable Public Class SdlImage
[C#]
public abstract sealed class SdlImage

Thread Safety

Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.

Remarks

Images provide the basic visual building blocks for any user interface. Colors and fun shapes are the stuff that we as kids looked at for hours at a time while trying to shoot down big aliens and rescue pixelated princesses. Now it's our turn to make the images that others will remember later in life perhaps. Now how do we get this dang images into our SDL programs, and be flexible in the handling of the images so that we don't even have to worry about what various formats they may be in? This is where SDLimage makes all of our lives easier. This document doesn't help you make artwork, but it will give you the functional knowledge on how to get that art into your game. Now go forth and make your Stick Figure of Justice, someone else might fill in for your lack of artistry, at least you won't have to make much of an effort to include the new and better art into your code.

This is a simple library to load images of various formats as SDL surfaces.

This library supports BMP, PNM (PPM/PGM/PBM), XPM, LBM, PCX, GIF, JPEG, PNG, TGA, and TIFF formats.




SDL_image supports loading and decoding images from the following formats:

                TGA TrueVision Targa (MUST have .tga)
                BMP Windows Bitmap(.bmp)
                PNM Portable Anymap (.pnm)
                    .pbm = Portable BitMap (mono)
                    .pgm = Portable GreyMap (256 greys)
                    .ppm = Portable PixMap (full color)
                XPM X11 Pixmap (.xpm) can be #included directly in code
                    This is NOT the same as XBM(X11 Bitmap) format, which is for monocolor
                    images.
                XCF
                GIMP native (.xcf) (XCF = eXperimental Computing Facility?)
                This format is always changing, and since there's no library supplied
                by the GIMP project to load XCF, the loader may frequently fail to
                load much of any image from an XCF file. It's better to load this
                in GIMP and convert to a better supported image format.
                PCX ZSoft IBM PC Paintbrush (.pcx)
                GIF CompuServe Graphics Interchange Format (.gif)
                JPG Joint Photographic Experts Group JFIF format (.jpg or .jpeg)
                TIF Tagged Image File Format (.tif or .tiff)
                LBM Interleaved Bitmap (.lbm or .iff) FORM : ILBM or PBM(packed bitmap)
                HAM6, HAM8, and 24bit types are not supported.
                PNG Portable Network Graphics (.png)
                

Requirements

Namespace: Tao.Sdl

Assembly: Tao.Sdl (in Tao.Sdl.dll)

See Also

SdlImage Members | Tao.Sdl Namespace