GWinApplet.java

/*
  Part of the G4P library for Processing 
  	http://www.lagers.org.uk/g4p/index.html
	http://sourceforge.net/projects/g4p/files/?source=navbar

  Copyright (c) 2012 Peter Lager

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General
  Public License along with this library; if not, write to the
  Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  Boston, MA  02111-1307  USA
 */

package automenta.vivisect.gui;

import processing.core.PApplet;
import processing.core.PImage;
import processing.event.KeyEvent;
import processing.event.MouseEvent;

/**
 * CLASS FOR INTERNAL USE ONLY <br>
 * 
 * This class extends PApplet and provides a drawing surface for
 * the GWindow class. Do not instantiate objects of this class, create
 * GWindow objects instead.
 * 
 * The event handling methods here are NOT called by Processing directly. Instead events are caught by the
 * GWindowInfo class which then call the appropriate method this class. <br>
 * These methods use reflection to execute methods registered by the GWindo object that owns this class.
 * 
 * @author Peter Lager
 */
@SuppressWarnings("serial")
@Deprecated public class GWinApplet extends PApplet implements GConstants, GConstantsInternal {

	// Must be set by GWindow 'owning' this PApplet
	public GWindow owner;
	// The applet width and height
	public int appWidth, appHeight;
	// applet graphics mode e.g. JAVA2D, P3D etc.
	public String mode;

	// background colour
	public int bkColor;

	// background image if any
	public PImage bkImage = null;

	public boolean autoClear = false;

	public GWinApplet(String mode){
		super();
		this.mode = mode;
	}

	/**
	 * INTERNAL USE ONLY <br>
	 * The PApplet setup method to intialise the drawing surface
	 */
	public void setup() {
		size(appWidth, appHeight, mode);
	}

	/**
	 * INTERNAL USE ONLY <br>
	 * Use the equivalent method in GWindow
	 * @param col
	 */
	public void setBackground(int col){
		bkColor = col;
		background(col);
	}

	/**
	 * INTERNAL USE ONLY <br>
	 * This will always be active because this class extends PApplet
	 */
	public void draw() {
		if(autoClear){
			if(bkImage != null)
				background(bkImage);
			else
				background(bkColor);
		}
		if(owner.drawHandlerObject != null){
			try {
				owner.drawHandlerMethod.invoke(owner.drawHandlerObject, new Object[] { this, owner.data });
			} catch (Exception e) {
				GMessenger.message(EXCP_IN_HANDLER,  
						new Object[] {owner.drawHandlerObject, owner.drawHandlerMethodName, e} );
			}
		}
	}

	/**
	 * INTERNAL USE ONLY <br>
	 * Use addDMouseHandler in GWindow to activate this method
	 */
	public void mouseEvent(MouseEvent event){
		if(owner.mouseHandlerObject != null){
			try {
				owner.mouseHandlerMethod.invoke(owner.mouseHandlerObject, new Object[] { this, owner.data, event });
			} catch (Exception e) {
				GMessenger.message(EXCP_IN_HANDLER,
						new Object[] {owner.mouseHandlerObject, owner.mouseHandlerMethodName, e} );
			}
		}
	}
	
	/**
	 * INTERNAL USE ONLY <br>
	 * Use addDKeyHandler in GWindow to activate this method
	 */
	public void keyEvent(KeyEvent event){
		if(owner.keyHandlerObject != null){
			try {
				owner.keyHandlerMethod.invoke(owner.keyHandlerObject, new Object[] { this, owner.data, event });
			} catch (Exception e) {
				GMessenger.message(EXCP_IN_HANDLER,
						new Object[] {owner.keyHandlerObject, owner.keyHandlerMethodName, e} );
			}
		}
	}
	
	/**
	 * INTERNAL USE ONLY <br>
	 * Use addPreHandler in GWindow to activate this method
	 */
	public void pre(){
		if(owner.preHandlerObject != null){
			try {
				owner.preHandlerMethod.invoke(owner.preHandlerObject, 
						new Object[] { owner.papplet, owner.data });
			} catch (Exception e) {
				GMessenger.message(EXCP_IN_HANDLER, 
						new Object[] {owner.preHandlerObject, owner.preHandlerMethodName, e} );
			}
		}
	}

	/**
	 * INTERNAL USE ONLY <br>
	 * Use addPostHandler in GWindow to activate this method
	 */
	public void post(){
		if(owner.postHandlerObject != null){
			try {
				owner.postHandlerMethod.invoke(owner.postHandlerObject, 
						new Object[] { owner.papplet, owner.data });
			} catch (Exception e) {
				GMessenger.message(EXCP_IN_HANDLER, 
						new Object[] {owner.postHandlerObject, owner.postHandlerMethodName, e} );
			}
		}
	}

	
}