[Scummvm-cvs-logs] SF.net SVN: scummvm: [23987] scummvm/branches/branch-0-9-0/common/system.h

[agent-q at users.sourceforge.net]

Revision: 23987
          http://svn.sourceforge.net/scummvm/?rev=23987&view=rev
Author:   agent-q
Date:     2006-09-25 14:03:24 -0700 (Mon, 25 Sep 2006)

Log Message:
-----------


Modified Paths:
--------------
    scummvm/branches/branch-0-9-0/common/system.h

Modified: scummvm/branches/branch-0-9-0/common/system.h
===================================================================
--- scummvm/branches/branch-0-9-0/common/system.h	2006-09-25 21:02:55 UTC (rev 23986)
+++ scummvm/branches/branch-0-9-0/common/system.h	2006-09-25 21:03:24 UTC (rev 23987)
@@ -440,6 +440,29 @@
 	 */
 	virtual void setShakePos(int shakeOffset) = 0;
 
+	/**
+	 * Sets the area of the screen that has the focus.  For example, when a character
+	 * is speaking, they will have the focus.  Allows for pan-and-scan style views
+	 * where the backend could follow the speaking character or area of interest on 
+	 * the screen.
+	 *
+	 * The backend is responsible for clipping the rectangle and deciding how best to
+	 * zoom the screen to show any shape and size rectangle the engine provides.
+	 *
+	 * @param rect A rectangle on the screen to be focused on
+	 * @see clearFocusRectangle
+	 */	
+	virtual void setFocusRectangle(const Common::Rect& rect) {}
+	
+	/**
+	 * Clears the focus set by a call to setFocusRectangle().  This allows the engine
+	 * to clear the focus during times when no particular area of the screen has the
+	 * focus.
+	 * @see setFocusRectangle
+	 */
+	virtual void clearFocusRectangle() {}
+
+
 	//@}
 
 


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.