Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sdl_surface(3) [centos man page]

SDL_Surface(3)							 SDL API Reference						    SDL_Surface(3)

SDL_Surface - Graphical Surface Structure STRUCTURE DEFINITION
typedef struct SDL_Surface { Uint32 flags; /* Read-only */ SDL_PixelFormat *format; /* Read-only */ int w, h; /* Read-only */ Uint16 pitch; /* Read-only */ void *pixels; /* Read-write */ /* clipping information */ SDL_Rect clip_rect; /* Read-only */ /* Reference count -- used when freeing surface */ int refcount; /* Read-mostly */ /* This structure also contains private fields not shown here */ } SDL_Surface; STRUCTURE DATA
flags Surface flags format Pixel format w, h Width and height of the surface pitch Length of a surface scanline in bytes pixels Pointer to the actual pixel data clip_rect surface clip rectangle DESCRIPTION
SDL_Surface's represent areas of "graphical" memory, memory that can be drawn to. The video framebuffer is returned as a SDL_Surface by SDL_SetVideoMode and SDL_GetVideoSurface. Most of the fields should be pretty obvious. w and h are the width and height of the surface in pixels. pixels is a pointer to the actual pixel data, the surface should be locked before accessing this field. The clip_rect field is the clipping rectangle as set by SDL_SetClipRect. The following are supported in the flags field. SDL_SWSURFACE Surface is stored in system memory SDL_HWSURFACE Surface is stored in video memory SDL_ASYNCBLIT Surface uses asynchronous blits if possible SDL_ANYFORMAT Allows any pixel-format (Display surface) SDL_HWPALETTE Surface has exclusive palette SDL_DOUBLEBUF Surface is double buffered (Display surface) SDL_FULLSCREEN Surface is full screen (Display Surface) SDL_OPENGL Surface has an OpenGL context (Display Surface) SDL_OPENGLBLIT Surface supports OpenGL blitting (Display Surface) SDL_RESIZABLE Surface is resizable (Display Surface) SDL_HWACCEL Surface blit uses hardware acceleration SDL_SRCCOLORKEY Surface use colorkey blitting SDL_RLEACCEL Colorkey blitting is accelerated with RLE SDL_SRCALPHA Surface blit uses alpha blending SDL_PREALLOC Surface uses preallocated memory SEE ALSO
SDL_PixelFormat SDL
Tue 11 Sep 2001, 23:01 SDL_Surface(3)

Check Out this Related Man Page

SDL::Surface(3) 					User Contributed Perl Documentation					   SDL::Surface(3)

SDL::Surface - a SDL perl extension SYNOPSIS
use SDL::Surface; $image = new SDL::Surface(-name=>"yomama.jpg"); DESCRIPTION
The "SDL::Surface" module encapsulates the SDL_Surface* structure, and many of its ancillatory functions. Not only is it a workhorse of the OO Layer, it is the base class for the "SDL::App" class. EXPORTS
new (-name => 'foo.png') The "SDL::Surface" class can be instantiated in a number of different ways. If support for the SDL_image library was included when SDL_perl was compiled, the easiest way to create a new surface is to use the "SDL::Surface::new" method with the "-name" option. This will load the image from the file and return an object encapsulating the SDL_Surface*. new (-from => $buffer, ... ) If the contents of the new Surface is already in memory, "SDL::Surface::new" may be called with the "-from" option to create an image from that section of memory. This method takes the following additional parameters: o -width the width of the image in pixels o -height the height of the image in pixels o -depth the number of bits per pixel o -pitch the number of bytes per line o -Rmask an optional bitmask for red o -Gmask an optional bitmask for green o -Bmask an optional bitmask for green o -Amask an optional bitmask for alpha new ( -flags => SDL_SWSURFACE, ... ) Finally, "SDL::Suface::new" may be invoked with the "-flags" option, in a similar fashion to the "-from" directive. This invocation takes the same additional options as "-from" with the exception of "-pitch" which is ignored. This method returns a new, blank, SDL::Surface option with any of the following flags turned on: o SWSURFACE() a non-accelerated surface o HWSURFACE() a hardware accelerated surface o SRCCOLORKEY() a surface with a transperant color o SRCALPHA() an alpha blended, translucent surface flags () "SDL::Surface::flags" returns the flags with which the surface was initialized. palette () "SDL::Surface::palette" currently returns a SDL_Palette*, this may change in future revisions. bpp () "SDL::Surface::bpp" returns the bits per pixel of the surface bytes_per_pixel () "SDL::Surface::bytes_per_pixel" returns the bytes per pixel of the surface Rshift () "SDL::Surface::Rshift" returns the bit index of the red field for the surface's pixel format Gshift () "SDL::Surface::Gshift" returns the bit index of the green field for the surface's pixel format Bshift () "SDL::Surface::Bshift" returns the bit index of the blue field for the surface's pixel format Ashift () "SDL::Surface::Ashift" returns the bit index of the alpha field for the surface's pixel format Rmask () "SDL::Surface::Rmask" returns the bit mask for the red field for teh surface's pixel format Gmask () "SDL::Surface::Gmask" returns the bit mask for the green field for teh surface's pixel format Bmask () "SDL::Surface::Bmask" returns the bit mask for the blue field for teh surface's pixel format Amask () "SDL::Surface::Amask" returns the bit mask for the alpha field for teh surface's pixel format color_key () "SDL::Surface::color_key" returns the current color key for the image, which can be set with the "SDL::Surface::set_color_key" method. Before calling "SDL::Surface::color_key" on a image, you should fist call "SDL::Surface::display_format" to convert it to the same format as the display. Failure to do so will result in failure to apply the correct color_key. alpha () "SDL::Surface::alpha" returns the current alpha value for the image, which can be set with the "SDL::Surface::set_alpha" method. width () "SDL::Surface::width" returns the width in pixels of the surface height () "SDL::Surface::height" returns the height in pixels of the surface pitch () "SDL::Surface::pitch" returns the width of a surface's scanline in bytes pixels () "SDL::Surface::pixels" returns a Uint8* to the image's pixel data. This is not inherently useful within perl, though may be used to pass image data to user provided C functions. pixel (x,y,[color]) "SDL::Surface::pixel" will set the color value of the pixel at (x,y) to the given color if provided. "SDL::Surface::pixel" returns a SDL::Color object for the color value of the pixel at (x,y) after any possible modifications. fill (rect,color) "SDL::Surface::fill" will fill the given SDL::Rect rectangle with the specified SDL::Color This function optionally takes a SDL_Rect* and a SDL_Color* lockp () "SDL::Surface::lockp" returns true if the surface must be locked lock () "SDL::Surface::lock" places a hardware lock if necessary, preventing access to the surface's memory unlock () "SDL::Surface::unlock" removes any hardware locks, enabling blits update ( rects...) "SDL::Surface::update" takes one or more SDL::Rect's which determine which sections of the image are to be updated. This option is only useful on the appliaction surface. flip () "SDL::Surface::flip" updates the full surface, using a double buffer if available blit (srect,dest,drect) "SDL::Surface::blit" blits the current surface onto the destination surface, according to the provided rectangles. If a rectangle is 0, then the full surface is used. set_colors (start,colors...) "SDL::Surface::set_colors" updates the palette starting at index "start" with the supplied colors. The colors may either be SDL::Color objects or SDL_Color* from the low level C-style API. set_color_key (flag,pixel) or (flag,x,y) "SDL::Surface::set_color_key" sets the blit flag, usually SDL_SRCCOLORKEY, to the specified SDL::Color object. Optional a SDL_Color* may be passed. set_alpha (flag,alpha) "SDL::Surface::set_alpha" sets the opacity of the image for alpha blits. "alpha" takes a value from 0x00 to 0xff. display_format () "SDL::Surface::display_format" converts the surface to the same format as the current screen. rgb () "SDL::Surface::rgb" converts the surface to a 24 bit rgb format regardless of the initial format. rgba () "SDL::Surface::rgba" converts the surface to a 32 bit rgba format regarless of the initial format. print (x,y,text...) "SDL::Surface::print" renders the text using the current font onto the image. This option is only supported for with SDL_image and SFont. save_bmp (filename) "SDL::Surface::save_bmp" saves the surface to filename in Windows BMP format. video_info () "SDL::Surface::video_info" returns a hash describing the current state of the video hardware. AUTHOR
David J. Goehrig SEE ALSO
perl SDL::App SDL::Color SDL::Palette SDL::Rect perl v5.12.1 2010-07-05 SDL::Surface(3)
Man Page