OSYSTEM: Introduce a method allowing to draw a background activity icon

1 files changed, 19 insertions, 0 deletions

diff --git a/common/system.h b/common/system.h
index eb9a39bbdf..b07a5ffd1e 100644
--- a/common/system.h
+++ b/common/system.h
@@ -1102,6 +1102,25 @@ public:
 	virtual void displayMessageOnOSD(const char *msg) = 0;
 
 	/**
+	 * Display an icon indicating background activity
+	 *
+	 * The icon is displayed in an 'on screen display'. It is visible above
+	 * the regular screen content or near it.
+	 *
+	 * The caller keeps ownership of the icon. It is acceptable to free
+	 * the surface just after the call.
+	 *
+	 * There is no preferred pixel format for the icon. The backend should
+	 * convert its copy of the icon to an appropriate format.
+	 *
+	 * The caller must call this method again with a null pointer
+	 * as a parameter to indicate the icon should no longer be displayed.
+	 *
+	 * @param icon the icon to display on screen
+	 */
+	virtual void displayActivityIconOnOSD(const Graphics::Surface *icon) = 0;
+
+	/**
 	* Blit a bitmap to the 'on screen display'.
 	*
 	* If the current pixel format has one byte per pixel, the graphics data