Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.libsdl.event
Class SDLCursor  view SDLCursor download SDLCursor.java

java.lang.Object
  extended byorg.libsdl.SDLStruct
      extended byorg.libsdl.event.SDLCursor

public class SDLCursor
extends org.libsdl.SDLStruct

The SDLCursor represents an SDL cursor. This class is then passed to SDLEventManager.setCursor() method to set the current cursor for the screen. Note that this class supplies a standard error cursor.

Version:
$revision$

Field Summary
static java.lang.String[] STANDARD_ARROW_CURSOR
          The standard arrow.
 
Fields inherited from class org.libsdl.SDLStruct
pointer
 
Constructor Summary
  SDLCursor(byte[] data, byte[] mask, int width, int height, int hot_x, int hot_y)
          Constructs a new SDLCursor with the given data, mask, width, height, hot_x, and hot_y parameters.
protected SDLCursor(int l)
           
  SDLCursor(java.lang.String[] xpm)
          Constructs a new SDLCursor with the given 'xpm' structure.
 
Method Summary
private static int createCursor(byte[] data, byte[] mask, int width, int height, int hot_x, int hot_y)
           
private static int createCursor(java.lang.String[] xpm)
           
 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.
private  void freeMemory()
           
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

STANDARD_ARROW_CURSOR

public static java.lang.String[] STANDARD_ARROW_CURSOR
The standard arrow.

Constructor Detail

SDLCursor

public SDLCursor(byte[] data,
                 byte[] mask,
                 int width,
                 int height,
                 int hot_x,
                 int hot_y)
          throws java.lang.Exception
Constructs a new SDLCursor with the given data, mask, width, height, hot_x, and hot_y parameters.


SDLCursor

public SDLCursor(java.lang.String[] xpm)
          throws java.lang.Exception
Constructs a new SDLCursor with the given 'xpm' structure. See the standard arrow 'xpm' for formatting of this single data array.


SDLCursor

protected SDLCursor(int l)
Method Detail

createCursor

private static int createCursor(byte[] data,
                                byte[] mask,
                                int width,
                                int height,
                                int hot_x,
                                int hot_y)
                         throws java.lang.Exception

createCursor

private static int createCursor(java.lang.String[] xpm)
                         throws java.lang.Exception

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.


freeMemory

private void freeMemory()