Class | Rubygame::Screen |
In: |
ext/rubygame/rubygame_mixer.c
|
Parent: | Rubygame::Surface |
Screen represents the display window for the game. The Screen is a special Surface that is displayed to the user. By changing and then updating the Screen many times per second, we can create the illusion of continous motion.
Screen inherits most of the Surface methods, and can be passed to methods which expect a Surface, including Surface#blit and the Draw functions. However, the Screen cannot have a colorkey or an alpha channel, so Surface#set_colorkey and Surface#set_alpha are not inherited.
Please note that only one Screen can exist, per application, at a time; this is a limitation of SDL. You must use Screen.set_mode to create the Screen or modify its properties.
Also note that no changes to the Screen will be seen until it is refreshed. See update, update_rects, and flip for ways to refresh all or part of the Screen.
Returns the current display window, or raises SDLError if it fails to get it (for example, if it doesn‘t exist yet).
Create a new Rubygame window if there is none, or modify the existing one. You cannot create more than one Screen; the existing one will be replaced. (This is a limitation of SDL.) Returns the resulting Screen.
This method takes these arguments:
size: | requested window size (in pixels), in the form [width,height] | ||||||||||||||||||
depth: | requested color depth (in bits per pixel). If 0 (default), the current system color depth. | ||||||||||||||||||
flags: | an Array of zero or more of the following flags (located under the Rubygame module).
|
If the Rubygame display is double-buffered (see set_mode), flips the buffers and updates the whole screen. Otherwise, just updates the whole screen.
Set whether the mouse cursor is displayed or not. If value is true, the cursor will be shown; if false, it will be hidden. See also show_cursor?
Updates (refreshes) all or part of the Rubygame window, revealing to the user any changes that have been made since the last update. If you‘re using a double-buffered display (see Display.set_mode), you should use Screen#flip instead.
This method takes these arguments:
rect: | a Rubygame::Rect representing the area of the screen to update. Can also be an length-4 Array, or given as 4 separate arguments. If omitted or nil, the entire screen is updated. |
Updates (as Screen#update does) several areas of the screen.
This method takes these arguments:
rects: | an Array containing any number of Rect objects, each rect representing a portion of the screen to update. |