X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pages%2FSDL-Video.html-inc;fp=pages%2FSDL-Video.html-inc;h=1fba8b2c8ca9bbd4a39edb257d11d39aecff6b57;hb=3540cbee4b5e6b4394f3e77a96f5475c0bc89565;hp=56f99005029794338118097b587e797aa47af80d;hpb=835086e01fe6c9658b6993817c1e65f7e712a99e;p=sdlgit%2FSDL-Site.git diff --git a/pages/SDL-Video.html-inc b/pages/SDL-Video.html-inc index 56f9900..1fba8b2 100644 --- a/pages/SDL-Video.html-inc +++ b/pages/SDL-Video.html-inc @@ -5,7 +5,7 @@
If the surface has no alpha component, the alpha will be returned as 0xff (100% opaque).
Creates an empty SDL::Surface from pixel data -Allocate an empty surface (must be called after SDL::set_video_mode) -If bitsPerPixel is 8 an empty palette is allocated for the surface, otherwise a 'packed-pixel' SDL::pixel_format is created using the -[RGBA]mask's provided (see SDL::pixel_format). The flags specifies the type of surface that should be created, it is an OR'd combination -of the following possible values.
-SDL will create the surface in system memory. -This improves the performance of pixel level access, however you may not be able to take advantage of some types of hardware blitting.
-SDL will attempt to create the surface in video memory. -This will allow SDL to take advantage of Video->Video blits (which are often accelerated).
-This flag turns on color keying for blits from this surface. -If SDL_HWSURFACE is also specified and color keyed blits are hardware-accelerated, then SDL will attempt to place the surface in video memory. -If the screen is a hardware surface and color keyed blits are hardware-accelerated then the SDL_HWSURFACE flag will be set. -Use SDL_SetColorKey to set or clear this flag after surface creation.
-This flag turns on alpha-blending for blits from this surface. -If SDL_HWSURFACE is also specified and alpha-blending blits are hardware-accelerated, -then the surface will be placed in video memory if possible. -If the screen is a hardware surface and alpha-blending blits are hardware-accelerated then the SDL_HWSURFACE flag will be set. -Use SDL_SetAlpha to set or clear this flag after surface creation.
-[RGBA]mask are the bitmasks used to extract that colour from a pixel. -For instance, Rmask being FF000000 means the red data is stored in the most significant byte. -Using zeros for the RGB masks sets a default value, based on the depth. (e.g. SDL::create_RGB_surface(flags,w,h,32,0,0,0,0);). -However, using zero for the Amask results in an Amask of 0. -It returns a SDL::Surface on success or undef on error. -Notes: If an alpha-channel is specified (that is, if Amask is nonzero), then the SDL_SRCALPHA flag is automatically set. -You may remove this flag by calling SDL::set_alpha after surface creation. -Also, if the SDL_HWSURFACE flag is set on the returned surface, its format might not match the requested format.
-Notes: Sometimes specifying an Alpha mask value could cause strange results. -This can be worked around by setting the Amask parameter to 0, but still including the SDL_SRCALPHA flag, and then using SDL::set_alpha, -also with the SDL_SRCALPHA flag.
- -SDL::lock_surface sets up the given SDL::surface for directly accessing the pixels. @@ -773,9 +727,6 @@ SDL::load_BMP returns a SDL::surface on success or undef on error.
- - -SDL::fill_rect returns 0 on success or -1 on error.
If you wish, you may load the OpenGL library from the given path at runtime, this must be done before SDL::set_video_mode is called. @@ -962,6 +917,14 @@ SDL::GL_swap_buffers doesn't returns any value.
Much the same as SDL::lock_surface
, SDL::lock_YUV_overlay locks the overlay for direct access to pixel data.