Merge branch 'ticket/13'

closes #13

Sources/Plasma/Apps/plClient/plClient.cpp

@@ -777,6 +777,12 @@ hsBool plClient::MsgReceive(plMessage* msg)
 			}
 			break;
 
+		case plClientMsg::kFlashWindow:
+			{
+				FlashWindow();
+			}
+			break;
+
 		}
 		return true;
 	}
@@ -2458,6 +2464,17 @@ void plClient::WindowActivate(bool active)
 	fWindowActive = active;
 }
 
+void plClient::FlashWindow()
+{
+#ifdef HS_BUILD_FOR_WIN32
+	FLASHWINFO info;
+	info.cbSize = sizeof(info);
+	info.dwFlags = FLASHW_TIMERNOFG | FLASHW_ALL;
+	info.hwnd = fWindowHndl;
+	info.uCount = -1;
+	FlashWindowEx(&info);
+#endif
+}
 
 //============================================================================
 void plClient::IOnAsyncInitComplete () {

Sources/Plasma/Apps/plClient/plClient.h

@@ -292,6 +292,7 @@ public:
 	virtual void WindowActivate(bool active);
 	virtual hsBool WindowActive() const { return fWindowActive; }
 
+	void FlashWindow();
 	void	SetMessagePumpProc( plMessagePumpProc proc ) { fMessagePumpProc = proc; }
 	void ResetDisplayDevice(int Width, int Height, int ColorDepth, hsBool Windowed, int NumAASamples, int MaxAnisotropicSamples, hsBool VSync = false);
 	void ResizeDisplayDevice(int Width, int Height, hsBool Windowed);

Sources/Plasma/FeatureLib/pfPython/cyMisc.cpp

@@ -722,6 +722,13 @@ void cyMisc::ExcludeRegionSetNow(pyKey& sender, pyKey& exKey, UInt16 state)
 	plgDispatch::MsgSend( msg );	// whoosh... off it goes
 }
 
+void cyMisc::FlashWindow()
+{
+	plKey clientKey   = hsgResMgr::ResMgr()->FindKey(kClient_KEY);
+	plClientMsg* pMsg = new plClientMsg(plClientMsg::kFlashWindow);
+	pMsg->Send(clientKey);          // whoosh... off it goes
+}
+
 #include "hsTimer.h"
 /////////////////////////////////////////////////////////////////////////////
 //

Sources/Plasma/FeatureLib/pfPython/cyMisc.h

@@ -244,6 +244,15 @@ public:
 	//
 	static hsBool WasLocallyNotified(pyKey &selfkey);
 
+	/////////////////////////////////////////////////////////////////////////////
+	//
+	//  Function   : FlashWindow
+	//  PARAMETERS : 
+	//
+	//  PURPOSE    : Flashes the client window if it is not focused
+	//
+	static void FlashWindow();
+
 	/////////////////////////////////////////////////////////////////////////////
 	//
 	//  Function   : GetClientName

Sources/Plasma/FeatureLib/pfPython/cyMiscGlue.cpp

@@ -48,6 +48,8 @@ You can contact Cyan Worlds, Inc. by email legal@cyan.com
 
 #include <python.h>
 
+PYTHON_BASIC_GLOBAL_METHOD_DEFINITION(PtFlashWindow, cyMisc::FlashWindow, "Flashes the client window if it is not focused");
+
 PYTHON_GLOBAL_METHOD_DEFINITION_NOARGS(PtGetAgeName, "DEPRECIATED - use ptDniInfoSource instead")
 {
 	return PyString_FromString(cyMisc::GetAgeName());
@@ -496,6 +498,8 @@ PYTHON_GLOBAL_METHOD_DEFINITION(PtDumpLogs, args, "Params: folder\nDumps all cur
 
 void cyMisc::AddPlasmaMethods(std::vector<PyMethodDef> &methods)
 {
+	PYTHON_GLOBAL_METHOD_NOARGS(methods, PtFlashWindow);
+
 	PYTHON_GLOBAL_METHOD_NOARGS(methods, PtGetAgeName);
 	PYTHON_GLOBAL_METHOD_NOARGS(methods, PtGetAgeInfo);
 	PYTHON_GLOBAL_METHOD_NOARGS(methods, PtGetAgeTime);

Sources/Plasma/NucleusLib/pnMessage/plClientMsg.h

@@ -94,6 +94,8 @@ public:
 		kEnableRenderScene,
 		kResetGraphicsDevice,
 		kSetGraphicsDefaults,
+
+		kFlashWindow,
 	};
 
 	// graphics settings fields