aboutsummaryrefslogtreecommitdiff
path: root/graphics
diff options
context:
space:
mode:
authorJohannes Schickel2009-06-29 23:23:29 +0000
committerJohannes Schickel2009-06-29 23:23:29 +0000
commitb37beb4493f69de1e2338fcf10bb1852ba864bc7 (patch)
tree9cebd661ae7442e3e8d6e520abb3dd4175b4b4b0 /graphics
parent267efdc8742fb64e72bc50e78e1d719451f2144e (diff)
downloadscummvm-rg350-b37beb4493f69de1e2338fcf10bb1852ba864bc7.tar.gz
scummvm-rg350-b37beb4493f69de1e2338fcf10bb1852ba864bc7.tar.bz2
scummvm-rg350-b37beb4493f69de1e2338fcf10bb1852ba864bc7.zip
Add some more explanation to Graphics::CursorManager::showMouse and OSystem::showMouse.
svn-id: r41968
Diffstat (limited to 'graphics')
-rw-r--r--graphics/cursorman.h16
1 files changed, 15 insertions, 1 deletions
diff --git a/graphics/cursorman.h b/graphics/cursorman.h
index 4cbd5bea12..f019e37b04 100644
--- a/graphics/cursorman.h
+++ b/graphics/cursorman.h
@@ -36,7 +36,21 @@ public:
/** Query whether the mouse cursor is visible. */
bool isVisible();
- /** Show or hide the mouse cursor. */
+ /**
+ * Show or hide the mouse cursor.
+ *
+ * This function does not call OSystem::updateScreen, when visible is true.
+ * This fact might result in a non visible mouse cursor if the caller does
+ * not call OSystem::updateScreen itself after a showMouse(true) call.
+ *
+ * TODO: We might want to reconsider this behavior, it might be confusing
+ * for the user to call OSystem::updateScreen separately, on the other
+ * hand OSystem::updateScreen might as well display unwanted changes on
+ * the screen. Another alternative would be to let the backend worry
+ * about this on OSystem::showMouse call.
+ *
+ * @see OSystem::showMouse.
+ */
bool showMouse(bool visible);
/**