[Scummvm-cvs-logs] CVS: scummvm/common system.h,1.72,1.73

[Max Horn]

Update of /cvsroot/scummvm/scummvm/common
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24444/common

Modified Files:
	system.h 
Log Message:
Added OSystem::beginGFXTransaction / endGFXTransaction (not yet implemented, though :-)

Index: system.h
===================================================================
RCS file: /cvsroot/scummvm/scummvm/common/system.h,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -d -r1.72 -r1.73
--- system.h	13 Nov 2004 04:33:33 -0000	1.72
+++ system.h	22 Nov 2004 23:25:06 -0000	1.73
@@ -219,6 +219,32 @@
 	virtual void initSize(uint width, uint height) = 0;
 
 	/**
+	 * Begin a new GFX transaction, which is a sequence of GFX mode changes.
+	 * The idea behind GFX transactions is to make it possible to activate
+	 * several different GFX changes at once as a "batch" operation. For
+	 * example, assume we are running in 320x200 with a 2x scaler (thus using
+	 * 640x400 pixels in total). Now, we want to switch to 640x400 with the 1x
+	 * scaler. Without transactions, we have to choose whether we want to first
+	 * switch the scaler mode, or first to 640x400 mode. In either case,
+	 * depending on the backend implementation, some ugliness may result.
+	 * E.g. the window might briefly switch to 320x200 or 1280x800.
+	 * Using transactions, this can be avoided.
+	 *
+	 * @note Transaction support is optional, and the default implementations
+	 *       of the relevant methods simply do nothing.
+	 * @see endGFXTransaction
+	 */
+	virtual void beginGFXTransaction() {};
+
+
+	/**
+	 * End (and thereby commit) the current GFX transaction.
+	 * @see beginGFXTransaction
+	 */
+	virtual void endGFXTransaction() {};
+
+
+	/**
 	 * Returns the currently set virtual screen height.
 	 * @see initSize
 	 * @return the currently set virtual screen height
@@ -254,9 +280,6 @@
 	 *       API are probably going to remove it.
 	 */
 	virtual void setPalette(const byte *colors, uint start, uint num) = 0;
-	
-	/** Clear the screen to black */
-	virtual void clearScreen() {;}
 
 	/**
 	 * Blit a bitmap to the virtual screen.
@@ -267,6 +290,11 @@
 	 * @see updateScreen
 	 */
 	virtual void copyRectToScreen(const byte *buf, int pitch, int x, int y, int w, int h) = 0;
+	
+	/**
+	 * Clear the screen to black.
+	 */
+	virtual void clearScreen() {}
 
 	/** Update the dirty areas of the screen. */
 	virtual void updateScreen() = 0;