[Scummvm-cvs-logs] CVS: scummvm/common system.h,1.96,1.97

[Max Horn]

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

Modified Files:
	system.h 
Log Message:
Fix doxygen warning

Index: system.h
===================================================================
RCS file: /cvsroot/scummvm/scummvm/common/system.h,v
retrieving revision 1.96
retrieving revision 1.97
diff -u -d -r1.96 -r1.97
--- system.h	19 Apr 2005 20:35:47 -0000	1.96
+++ system.h	8 May 2005 17:13:08 -0000	1.97
@@ -28,6 +28,10 @@
 #include "common/rect.h"
 #include "common/singleton.h"
 
+namespace Graphics {
+class Surface;
+} // end of namespace Graphics
+
 class SaveFileManager;
 
 /**
@@ -293,6 +297,9 @@
 	 *
 	 * @param width		the new virtual screen width
 	 * @param height	the new virtual screen height
+	 * @param overlayScale	optional: the scale to be used for the overlay, if different
+	 *						from the default scale (default is -1, which means the
+	 *						overlay uses the same scale)
 	 */
 	virtual void initSize(uint width, uint height, int overlayScale = -1) = 0;
 
@@ -358,6 +365,16 @@
 	 *       API are probably going to remove it.
 	 */
 	virtual void setPalette(const byte *colors, uint start, uint num) = 0;
+	
+	/**
+	 * Grabs a specified part of the palette
+	 * format is like it is described in setPalette
+	 *
+	 * @param buf	the buffer
+	 * @param start	the first platte entry
+	 * @param num	nummber of the entries
+	 */
+	virtual void grabPalette(byte *colors, uint start, uint num) = 0;
 
 	/**
 	 * Blit a bitmap to the virtual screen.
@@ -368,6 +385,28 @@
 	 * @see updateScreen
 	 */
 	virtual void copyRectToScreen(const byte *buf, int pitch, int x, int y, int w, int h) = 0;
+
+	/**
+	 * Copies the screen to a surface
+	 * if bitsPerPixel = 15 a RGB555 format is used
+	 * if bitsPerPixel = 16 a RGB565 format is used
+	 * WARNING: surf->free() musst be called by the user
+	 * 
+	 * @param surf		the surfce to store the data in it
+	 * @param bitsPerPixel	must be higher than 15 and lower than 16
+	 */
+	virtual void grabScreen(Graphics::Surface *surf, int bitsPerPixel);
+	
+	/**
+	 * Copies the screen to a surface (with original bit depth)
+	 * It should return a 1 byte per pixel surface in all cases
+	 * because currently all games supported by ScummVM are
+	 * using 1 byte per pixel.
+	 * WARNING: surf->free() musst be called by the user
+	 *
+	 * @param surf	the surfce to store the data in it
+	 */
+	virtual void grabRawScreen(Graphics::Surface *surf) = 0;
 	
 	/**
 	 * Clear the screen to black.