Implementation of IPlatformScreen for OS X. More...

#include <COSXScreen.h>

Classes
struct	CHotKeyItem
class	CMouseButtonState
Public Member Functions
	COSXScreen (bool isPrimary, bool autoShowHideCursor=true)
virtual void *	getEventTarget () const
virtual bool	getClipboard (ClipboardID id, IClipboard *) const
virtual void	getShape (SInt32 &x, SInt32 &y, SInt32 &width, SInt32 &height) const
virtual void	getCursorPos (SInt32 &x, SInt32 &y) const
virtual void	reconfigure (UInt32 activeSides)
virtual void	warpCursor (SInt32 x, SInt32 y)
virtual UInt32	registerHotKey (KeyID key, KeyModifierMask mask)
virtual void	unregisterHotKey (UInt32 id)
virtual void	fakeInputBegin ()
virtual void	fakeInputEnd ()
virtual SInt32	getJumpZoneSize () const
virtual bool	isAnyMouseButtonDown () const
virtual void	getCursorCenter (SInt32 &x, SInt32 &y) const
virtual void	gameDeviceTimingResp (UInt16 freq)
virtual void	fakeMouseButton (ButtonID id, bool press)
virtual void	fakeMouseMove (SInt32 x, SInt32 y) const
virtual void	fakeMouseRelativeMove (SInt32 dx, SInt32 dy) const
virtual void	fakeMouseWheel (SInt32 xDelta, SInt32 yDelta) const
virtual void	fakeGameDeviceButtons (GameDeviceID id, GameDeviceButton buttons) const
virtual void	fakeGameDeviceSticks (GameDeviceID id, SInt16 x1, SInt16 y1, SInt16 x2, SInt16 y2) const
virtual void	fakeGameDeviceTriggers (GameDeviceID id, UInt8 t1, UInt8 t2) const
virtual void	queueGameDeviceTimingReq () const
virtual void	enable ()
	Enable screen.
virtual void	disable ()
	Disable screen.
virtual void	enter ()
	Enter screen.
virtual bool	leave ()
	Leave screen.
virtual bool	setClipboard (ClipboardID, const IClipboard *)
	Set clipboard.
virtual void	checkClipboards ()
	Check clipboard owner.
virtual void	openScreensaver (bool notify)
	Open screen saver.
virtual void	closeScreensaver ()
	Close screen saver.
virtual void	screensaver (bool activate)
	Activate/deactivate screen saver.
virtual void	resetOptions ()
	Notify of options changes.
virtual void	setOptions (const COptionsList &options)
	Notify of options changes.
virtual void	setSequenceNumber (UInt32)
	Set clipboard sequence number.
virtual bool	isPrimary () const
	Test if is primary screen.
virtual void	gameDeviceFeedback (GameDeviceID id, UInt16 m1, UInt16 m2)
Protected Member Functions
virtual void	handleSystemEvent (const CEvent &, void *)
	Handle system event.
virtual void	updateButtons ()
	Update mouse buttons.
virtual IKeyState *	getKeyState () const
	Get the key state.

Detailed Description

Implementation of IPlatformScreen for OS X.

Definition at line 53 of file COSXScreen.h.

Member Function Documentation

void COSXScreen::checkClipboards ( ) [virtual]

Check clipboard owner.

Check ownership of all clipboards and post grab events for any that have changed. This is used as a backup in case the system doesn't reliably report clipboard ownership changes.

Implements CPlatformScreen.

Definition at line 863 of file COSXScreen.cpp.

References IScreen::getClipboardGrabbedEvent().

void COSXScreen::closeScreensaver ( ) [virtual]

Close screen saver.

Close the screen saver. Stop reporting screen saver activation and deactivation and, if the screen saver was disabled by openScreensaver(), enable the screen saver.

Implements CPlatformScreen.

Definition at line 883 of file COSXScreen.cpp.

References COSXScreenSaver::enable().

void COSXScreen::disable ( ) [virtual]

Disable screen.

Undoes the operations in enable() and events should no longer be reported.

Implements CPlatformScreen.

Definition at line 756 of file COSXScreen.cpp.

References CEvent::kTimer.

void COSXScreen::enable ( ) [virtual]

Enable screen.

Enable the screen, preparing it to report system and user events. For a secondary screen it also means preparing to synthesize events and hiding the cursor.

Implements CPlatformScreen.

Definition at line 707 of file COSXScreen.cpp.

References CEvent::kTimer.

void COSXScreen::enter ( ) [virtual]

Enter screen.

Called when the user navigates to this screen.

Implements CPlatformScreen.

Definition at line 790 of file COSXScreen.cpp.

IKeyState * COSXScreen::getKeyState ( ) const [protected, virtual]

Get the key state.

Subclasses must implement this method to return the platform specific key state object that each subclass must have.

Implements CPlatformScreen.

Definition at line 1443 of file COSXScreen.cpp.

void COSXScreen::handleSystemEvent	(	const CEvent &	event,
		void *
	)			`[protected, virtual]`

Handle system event.

A platform screen is expected to install a handler for system events in its c'tor like so:

    EVENTQUEUE->adoptHandler(CEvent::kSystem,
                         IEventQueue::getSystemTarget(),
                         new TMethodEventJob<CXXXPlatformScreen>(this,
                             &CXXXPlatformScreen::handleSystemEvent));

It should remove the handler in its d'tor. Override the handleSystemEvent() method to process system events. It should post the events IScreen as appropriate.

A primary screen has further responsibilities. It should post the events in IPrimaryScreen as appropriate. It should also call onKey() on its CKeyState whenever a key is pressed or released (but not for key repeats). And it should call updateKeyMap() on its CKeyState if necessary when the keyboard mapping changes.

The target of all events should be the value returned by getEventTarget().

Implements CPlatformScreen.

Definition at line 941 of file COSXScreen.cpp.

bool COSXScreen::isPrimary ( ) const [virtual]

Test if is primary screen.

Return true iff this screen is a primary screen.

Implements CPlatformScreen.

Definition at line 920 of file COSXScreen.cpp.

bool COSXScreen::leave ( ) [virtual]

Leave screen.

Called when the user navigates off the screen. Returns true on success, false on failure. A typical reason for failure is being unable to install the keyboard and mouse snoopers on a primary screen. Secondary screens should not fail.

Implements CPlatformScreen.

Definition at line 820 of file COSXScreen.cpp.

void COSXScreen::openScreensaver ( bool notify ) [virtual]

Open screen saver.

Open the screen saver. If notify is true then this object must send events when the screen saver activates or deactivates until closeScreensaver() is called. If notify is false then the screen saver is disabled and restored on closeScreensaver().

Implements CPlatformScreen.

Definition at line 874 of file COSXScreen.cpp.

References COSXScreenSaver::disable().

void COSXScreen::resetOptions ( ) [virtual]

Notify of options changes.

Reset all options to their default values.

Implements CPlatformScreen.

Definition at line 902 of file COSXScreen.cpp.

void COSXScreen::screensaver ( bool activate ) [virtual]

Activate/deactivate screen saver.

Forcibly activate the screen saver if activate is true otherwise forcibly deactivate it.

Implements CPlatformScreen.