Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> libsdl >> [ video overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.libsdl.video
Class SDLScreen  

java.lang.Object
  org.libsdl.SDLStruct
      org.libsdl.video.SDLSurface
          org.libsdl.video.SDLScreen

---

public class SDLScreen

extends SDLSurface

The SDLScreen class extends SDLSurface which extends SDLStruct and thus it represents a native C structure. In particular, the SDLScreen class represents the visible SDL surface.

A SDLScreen cannot be instantiated directly. It is created and returned by the SDLVideo object.

------ EXAMPLE ------

     SDL sdl = SDL.getInstance();
     SDLVideo video = sdl.getVideo();
     // Create a screen that is 640x480 at 32 bpp fullscreen
     SDLScreen screen = video.setVideoMode(640, 480, 32, SDLVideo.SDL_FULLSCREEN);
     ...  // do some drawing and stuff
     screen.flip();  // would probably be in a loop normally
 

Version:

$revision$

---

Field Summary

 

Fields inherited from class org.libsdl.video.SDLSurface

SDL_HWSURFACE, SDL_PREALLOC, SDL_RLEACCEL, SDL_RLEACCELOK, SDL_SRCALPHA, SDL_SRCCOLORKEY, SDL_SWSURFACE

 

Fields inherited from class org.libsdl.SDLStruct

pointer

 

Constructor Summary

SDLScreen(int l)

 

Method Summary
void	finalize()           Called on an object by the Virtual Machine at most once, at some point after the Object is determined unreachable but before it is destroyed.
boolean	flip()           If this SDLScreen object was created as a double-buffered surface, this method will flip the surface.
void	updateRect(int x, int y, int w, int h)           Update a portion of the screen.

 

Methods inherited from class org.libsdl.video.SDLSurface

blitSurface, convertSurface, displayFormat, displayFormatAlpha, fillRect, getClipRect, getFlags, getHeight, getPitch, getPixelFormat, getWidth, lock, saveAsBmp, setAlpha, setClipRect, setColorKey, setColors, setPalette, unlock

 

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Constructor Detail

SDLScreen

public SDLScreen(int l)

Method Detail

flip

public boolean flip()

If this SDLScreen object was created as a double-buffered surface, this method will flip the surface. Note that if the screen is not double-buffered, this does the same thing as updateRect with the entire surface as the rect.

Corresponds:

SDL_Flip()

---

updateRect

public void updateRect(int x,
                       int y,
                       int w,
                       int h)

Update a portion of the screen.

Corresponds:

SDL_UpdateRect()

---

finalize

public void finalize()

Description copied from class: java.lang.Object

Called on an object by the Virtual Machine at most once, at some point after the Object is determined unreachable but before it is destroyed. You would think that this means it eventually is called on every Object, but this is not necessarily the case. If execution terminates abnormally, garbage collection does not always happen. Thus you cannot rely on this method to always work. For finer control over garbage collection, use references from the java.lang.ref package.

Virtual Machines are free to not call this method if they can determine that it does nothing important; for example, if your class extends Object and overrides finalize to do simply super.finalize().

finalize() will be called by a java.lang.Thread that has no locks on any Objects, and may be called concurrently. There are no guarantees on the order in which multiple objects are finalized. This means that finalize() is usually unsuited for performing actions that must be thread-safe, and that your implementation must be use defensive programming if it is to always work.

If an Exception is thrown from finalize() during garbage collection, it will be patently ignored and the Object will still be destroyed.

It is allowed, although not typical, for user code to call finalize() directly. User invocation does not affect whether automatic invocation will occur. It is also permitted, although not recommended, for a finalize() method to "revive" an object by making it reachable from normal code again.

Unlike constructors, finalize() does not get called for an object's superclass unless the implementation specifically calls super.finalize().

The default implementation does nothing.

Overrides:

finalize in class SDLSurface

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> libsdl >> [ video overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---