ScummVM API documentation
OSystem_IPHONE Class Reference
Inheritance diagram for OSystem_IPHONE:
EventsBaseBackend PaletteManager BaseBackend Common::EventSource Common::NonCopyable OSystem Common::NonCopyable

Public Member Functions

virtual void initBackend ()
 
virtual void engineInit ()
 
virtual void engineDone ()
 
virtual bool hasFeature (Feature f)
 
virtual void setFeatureState (Feature f, bool enable)
 
virtual bool getFeatureState (Feature f)
 
virtual void initSize (uint width, uint height, const Graphics::PixelFormat *format)
 
virtual void beginGFXTransaction ()
 
virtual TransactionError endGFXTransaction ()
 
virtual int16 getHeight ()
 
virtual int16 getWidth ()
 
virtual PaletteManagergetPaletteManager ()
 
virtual void copyRectToScreen (const void *buf, int pitch, int x, int y, int w, int h)
 
virtual void updateScreen ()
 
virtual Graphics::SurfacelockScreen ()
 
virtual void unlockScreen ()
 
virtual void setShakePos (int shakeXOffset, int shakeYOffset)
 
virtual void showOverlay ()
 
virtual void hideOverlay ()
 
virtual bool isOverlayVisible () const
 
virtual void clearOverlay ()
 
virtual void grabOverlay (Graphics::Surface &surface)
 
virtual void copyRectToOverlay (const void *buf, int pitch, int x, int y, int w, int h)
 
virtual int16 getOverlayHeight ()
 
virtual int16 getOverlayWidth ()
 
virtual Graphics::PixelFormat getOverlayFormat () const
 
virtual bool showMouse (bool visible)
 
virtual void warpMouse (int x, int y)
 
virtual void setMouseCursor (const void *buf, uint w, uint h, int hotspotX, int hotspotY, uint32 keycolor=255, bool dontScale=false, const Graphics::PixelFormat *format=NULL)
 
virtual void setCursorPalette (const byte *colors, uint start, uint num)
 
virtual bool pollEvent (Common::Event &event)
 
virtual uint32 getMillis (bool skipRecord=false)
 
virtual void delayMillis (uint msecs)
 
virtual Common::MutexInternalcreateMutex ()
 
virtual void setupMixer (void)
 
virtual void setTimerCallback (TimerProc callback, int interval)
 
virtual int getScreenChangeID () const
 
virtual void quit ()
 
virtual void addSysArchivesToSearchSet (Common::SearchSet &s, int priority=0)
 
virtual void getTimeAndDate (TimeDate &td, bool skipRecord=false) const
 
virtual Audio::MixergetMixer ()
 
void startSoundsystem ()
 
void stopSoundsystem ()
 
virtual Common::String getDefaultConfigFileName ()
 
virtual void logMessage (LogMessageType::Type type, const char *message)
 
- Public Member Functions inherited from BaseBackend
bool setScaler (const char *name, int factor) override final
 
void displayMessageOnOSD (const Common::U32String &msg) override
 
void displayActivityIconOnOSD (const Graphics::Surface *icon) override
 
void fillScreen (uint32 col) override
 
- Public Member Functions inherited from OSystem
void destroy ()
 
virtual void init ()
 
bool backendInitialized () const
 
virtual const GraphicsModegetSupportedGraphicsModes () const
 
virtual int getDefaultGraphicsMode () const
 
virtual bool setGraphicsMode (int mode, uint flags=kGfxModeNoFlags)
 
bool setGraphicsMode (const char *name)
 
virtual int getGraphicsMode () const
 
Graphics::PixelFormat getScreenFormat () const
 
Common::List< Graphics::PixelFormatgetSupportedFormats () const
 
virtual Common::Array< uint > getSupportedAntiAliasingLevels () const
 
virtual OpenGL::ContextType getOpenGLType () const
 
virtual const GraphicsModegetSupportedShaders () const
 
virtual int getDefaultShader () const
 
virtual bool setShader (int id)
 
bool setShader (const char *name)
 
virtual int getShader () const
 
virtual const GraphicsModegetSupportedStretchModes () const
 
virtual int getDefaultStretchMode () const
 
virtual bool setStretchMode (int mode)
 
bool setStretchMode (const char *name)
 
virtual int getStretchMode () const
 
virtual uint getDefaultScaler () const
 
virtual uint getDefaultScaleFactor () const
 
virtual bool setScaler (uint mode, int factor)
 
virtual uint getScaler () const
 
virtual uint getScaleFactor () const
 
virtual void initSizeHint (const Graphics::ModeList &modes)
 
virtual float getHiDPIScreenFactor () const
 
virtual void setFocusRectangle (const Common::Rect &rect)
 
virtual void clearFocusRectangle ()
 
virtual void saveScreenshot ()
 
virtual bool lockMouse (bool lock)
 
virtual Common::TimerManagergetTimerManager ()
 
Common::EventManagergetEventManager ()
 
virtual Common::HardwareInputSetgetHardwareInputSet ()
 
virtual Common::KeymapArray getGlobalKeymaps ()
 
virtual Common::KeymapperDefaultBindingsgetKeymapperDefaultBindings ()
 
AudioCDManagergetAudioCDManager ()
 
virtual void fatalError ()
 
virtual void setWindowCaption (const Common::U32String &caption)
 
virtual Common::SaveFileManagergetSavefileManager ()
 
virtual Common::TextToSpeechManagergetTextToSpeechManager ()
 
virtual Common::DialogManagergetDialogManager ()
 
virtual FilesystemFactorygetFilesystemFactory ()
 
virtual Common::SeekableReadStreamcreateConfigReadStream ()
 
virtual Common::WriteStreamcreateConfigWriteStream ()
 
virtual void registerDefaultSettings (const Common::String &target) const
 
virtual GUI::OptionsContainerWidgetbuildBackendOptionsWidget (GUI::GuiObject *boss, const Common::String &name, const Common::String &target) const
 
virtual void applyBackendSettings ()
 
virtual void messageBox (LogMessageType::Type type, const char *message)
 
virtual bool displayLogFile ()
 
virtual bool hasTextInClipboard ()
 
virtual Common::U32String getTextFromClipboard ()
 
virtual bool setTextInClipboard (const Common::U32String &text)
 
virtual bool openUrl (const Common::String &url)
 
virtual Common::String getSystemLanguage () const
 
virtual bool isConnectionLimited ()
 

Static Public Member Functions

static void mixCallback (void *sys, byte *samples, int len)
 

Protected Member Functions

virtual void setPalette (const byte *colors, uint start, uint num)
 
virtual void grabPalette (byte *colors, uint start, uint num) const
 
void initVideoContext ()
 
void updateOutputSurface ()
 
void internUpdateScreen ()
 
void dirtyFullScreen ()
 
void dirtyFullOverlayScreen ()
 
void suspendLoop ()
 
void drawDirtyRect (const Common::Rect &dirtyRect)
 
void updateMouseTexture ()
 
bool handleEvent_swipe (Common::Event &event, int direction)
 
void handleEvent_keyPressed (Common::Event &event, int keyPressed)
 
void handleEvent_orientationChanged (int orientation)
 
bool handleEvent_mouseDown (Common::Event &event, int x, int y)
 
bool handleEvent_mouseUp (Common::Event &event, int x, int y)
 
bool handleEvent_secondMouseDown (Common::Event &event, int x, int y)
 
bool handleEvent_secondMouseUp (Common::Event &event, int x, int y)
 
bool handleEvent_mouseDragged (Common::Event &event, int x, int y)
 
bool handleEvent_mouseSecondDragged (Common::Event &event, int x, int y)
 

Static Protected Member Functions

static void AQBufferCallback (void *in, AudioQueueRef inQ, AudioQueueBufferRef outQB)
 
static int timerHandler (int t)
 

Protected Attributes

Audio::MixerImpl_mixer
 
VideoContext_videoContext
 
Graphics::Surface _framebuffer
 
TransactionError _gfxTransactionError
 
uint16 _gamePalette [256]
 
uint16 _gamePaletteRGBA5551 [256]
 
struct timeval _startTime
 
uint32 _timeSuspended
 
bool _mouseCursorPaletteEnabled
 
uint16 _mouseCursorPalette [256]
 
Graphics::Surface _mouseBuffer
 
uint16 _mouseKeyColor
 
bool _mouseDirty
 
bool _mouseNeedTextureUpdate
 
long _lastMouseDown
 
long _lastMouseTap
 
long _queuedEventTime
 
Common::Event _queuedInputEvent
 
bool _secondaryTapped
 
long _lastSecondaryDown
 
long _lastSecondaryTap
 
int _gestureStartX
 
int _gestureStartY
 
bool _mouseClickAndDragEnabled
 
bool _touchpadModeEnabled
 
int _lastPadX
 
int _lastPadY
 
int _lastDragPosX
 
int _lastDragPosY
 
int _timerCallbackNext
 
int _timerCallbackTimer
 
TimerProc _timerCallback
 
Common::Array< Common::Rect_dirtyRects
 
Common::Array< Common::Rect_dirtyOverlayRects
 
ScreenOrientation _screenOrientation
 
bool _fullScreenIsDirty
 
bool _fullScreenOverlayIsDirty
 
int _screenChangeCount
 
- Protected Attributes inherited from OSystem
AudioCDManager_audiocdManager
 
Common::EventManager_eventManager
 
Common::TimerManager_timerManager
 
Common::SaveFileManager_savefileManager
 
Common::TextToSpeechManager_textToSpeechManager
 
Common::DialogManager_dialogManager
 
FilesystemFactory_fsFactory
 
Common::U32String _clipboard
 
bool _dummyUnused
 

Static Protected Attributes

static AQCallbackStruct s_AudioQueue
 
static SoundProc s_soundCallback
 
static void * s_soundParam
 

Additional Inherited Members

- Public Types inherited from OSystem
enum  Feature {
  kFeatureFullscreenMode, kFeatureAspectRatioCorrection, kFeatureFilteringMode, kFeatureStretchMode,
  kFeatureVirtualKeyboard, kFeatureCursorPalette, kFeatureOverlaySupportsAlpha, kFeatureIconifyWindow,
  kFeatureOpenGLForGame, kFeatureShadersForGame, kFeatureVSync, kFeatureFullscreenToggleKeepsContext,
  kFeatureDisplayLogFile, kFeatureClipboardSupport, kFeatureOpenUrl, kFeatureTouchpadMode,
  kFeatureKbdMouseSpeed, kFeatureJoystickDeadzone, kFeatureScalers, kFeatureShader,
  kFeatureSystemBrowserDialog, kFeatureNoQuit
}
 
enum  GfxModeFlags { kGfxModeNoFlags = 0, kGfxModeRender3d = (1 << 0) }
 
enum  TransactionError {
  kTransactionSuccess = 0, kTransactionAspectRatioFailed = (1 << 0), kTransactionFullscreenFailed = (1 << 1), kTransactionModeSwitchFailed = (1 << 2),
  kTransactionSizeChangeFailed = (1 << 3), kTransactionFormatNotSupported = (1 << 4), kTransactionFilteringFailed = (1 << 5), kTransactionStretchModeSwitchFailed = (1 << 6)
}
 

Member Function Documentation

◆ initBackend()

virtual void OSystem_IPHONE::initBackend ( )
virtual

The following method is called once, from main.cpp, after all config data (including command line params etc.) is fully loaded.

Note
Subclasses should always invoke the implementation of their parent class. They should do so near the end of their own implementation.

Reimplemented from EventsBaseBackend.

◆ engineInit()

virtual void OSystem_IPHONE::engineInit ( )
virtual

Allow the backend to perform engine-specific initialization.

Called just before the engine is run.

Reimplemented from OSystem.

◆ engineDone()

virtual void OSystem_IPHONE::engineDone ( )
virtual

Allow the backend to perform engine-specific deinitialization.

Called after the engine finishes.

Reimplemented from OSystem.

◆ hasFeature()

virtual bool OSystem_IPHONE::hasFeature ( Feature  f)
virtual

Determine whether the backend supports the specified feature.

Reimplemented from OSystem.

◆ setFeatureState()

virtual void OSystem_IPHONE::setFeatureState ( Feature  f,
bool  enable 
)
virtual

Enable or disable the specified feature.

For example, this may be used to enable fullscreen mode or to deactivate aspect correction, etc.

Reimplemented from OSystem.

◆ getFeatureState()

virtual bool OSystem_IPHONE::getFeatureState ( Feature  f)
virtual

Query the state of the specified feature.

For example, test whether fullscreen mode is active or not.

Reimplemented from OSystem.

◆ initSize()

virtual void OSystem_IPHONE::initSize ( uint  width,
uint  height,
const Graphics::PixelFormat format 
)
virtual

Set the size and color format of the virtual screen.

Typical sizes include:

  • 320x200 (e.g. for most SCUMM games, and Simon)
  • 320x240 (e.g. for FM-TOWN SCUMM games)
  • 640x480 (e.g. for Curse of Monkey Island)

This is the resolution for which the client code generates data. This is not necessarily equal to the actual display size. For example, a backend may magnify the graphics to fit on the screen (see also the GraphicsMode), stretch the data to perform aspect ratio correction, or shrink it to fit on small screens (in cell phones).

Typical formats include:

  • CLUT8 (e.g. 256 color, for most games)
  • RGB555 (e.g. 16-bit color, for later SCUMM HE games)
  • RGB565 (e.g. 16-bit color, for Urban Runner)

This is the pixel format for which the client code generates data. It is not necessarily equal to the hardware pixel format. For example, a backend may perform color lookup of 8-bit graphics before pushing a screen to hardware, or correct the ARGB color order.

Parameters
widthNew virtual screen width.
heightNew virtual screen height.
formatNew virtual screen pixel format.

Implements OSystem.

◆ beginGFXTransaction()

virtual void OSystem_IPHONE::beginGFXTransaction ( )
virtual

Begin a new GFX transaction, which is a sequence of GFX mode changes.

The idea behind GFX transactions is to make it possible to activate several different GFX changes at once as a "batch" operation. For example, assume we are running in 320x200 with a 2x scaler (thus using 640x400 pixels in total). Now, we want to switch to 640x400 with the 1x scaler. Without transactions, we have to choose whether we want to first switch the scaler mode, or first to 640x400 mode. In either case, depending on the backend implementation, problems may occur. For example, the window might briefly switch to 320x200 or 1280x800. Using transactions, this can be avoided.

Note
Transaction support is optional, and the default implementations of the relevant methods simply do nothing.
See also
endGFXTransaction

Reimplemented from OSystem.

◆ endGFXTransaction()

virtual TransactionError OSystem_IPHONE::endGFXTransaction ( )
virtual

End (and thereby commit) the current GFX transaction.

See also
beginGFXTransaction
kTransactionError
Returns
ORed combination of TransactionError values or 0 on success.

Reimplemented from OSystem.

◆ getHeight()

virtual int16 OSystem_IPHONE::getHeight ( )
virtual

Return the currently set virtual screen height.

See also
initSize
Returns
Currently set virtual screen height.

Implements OSystem.

◆ getWidth()

virtual int16 OSystem_IPHONE::getWidth ( )
virtual

Return the currently set virtual screen width.

See also
initSize
Returns
Currently set virtual screen width.

Implements OSystem.

◆ getPaletteManager()

virtual PaletteManager* OSystem_IPHONE::getPaletteManager ( )
inlinevirtual

Return the palette manager singleton.

For more information, see PaletteManager.

Implements OSystem.

◆ setPalette()

virtual void OSystem_IPHONE::setPalette ( const byte *  colors,
uint  start,
uint  num 
)
protectedvirtual

Replace the specified range of the palette with new colors. The palette entries from 'start' till (start+num-1) will be replaced - so a full palette update is accomplished via start=0, num=256.

The palette data is specified in interleaved RGB format. That is, the first byte of the memory block 'colors' points at is the red component of the first new color; the second byte the green component of the first new color; the third byte the blue component, the last byte to the alpha (transparency) value. Then the second color starts, and so on. So memory looks like this: R1-G1-B1-R2-G2-B2-R3-...

Parameters
colorsthe new palette data, in interleaved RGB format
startthe first palette entry to be updated
numthe number of palette entries to be updated
Note
It is an error if start+num exceeds 256, behavior is undefined in that case (the backend may ignore it silently or assert).
It is an error if this function gets called when the pixel format in use (the return value of getScreenFormat) has more than one byte per pixel.
See also
getScreenFormat

Implements PaletteManager.

◆ grabPalette()

virtual void OSystem_IPHONE::grabPalette ( byte *  colors,
uint  start,
uint  num 
) const
protectedvirtual

Grabs a specified part of the currently active palette. The format is the same as for setPalette.

This should return exactly the same RGB data as was setup via previous setPalette calls.

For example, for every valid value of start and num of the following code:

byte origPal[num*3]; // Setup origPal's data however you like g_system->setPalette(origPal, start, num); byte obtainedPal[num*3]; g_system->grabPalette(obtainedPal, start, num);

the following should be true:

memcmp(origPal, obtainedPal, num*3) == 0

See also
setPalette
Parameters
colorsthe palette data, in interleaved RGB format
startthe first platte entry to be read
numthe number of palette entries to be read
Note
It is an error if this function gets called when the pixel format in use (the return value of getScreenFormat) has more than one byte per pixel.
See also
getScreenFormat

Implements PaletteManager.

◆ copyRectToScreen()

virtual void OSystem_IPHONE::copyRectToScreen ( const void *  buf,
int  pitch,
int  x,
int  y,
int  w,
int  h 
)
virtual

Blit a bitmap to the virtual screen.

The real screen will not immediately be updated to reflect the changes. Client code must call updateScreen to ensure any changes are visible to the user. This can be used to optimize drawing and reduce flicker.

If the current pixel format has one byte per pixel, the graphics data uses 8 bits per pixel, using the palette specified via setPalette. If more than one byte per pixel is in use, the graphics data uses the pixel format returned by getScreenFormat.

Parameters
bufBuffer containing the graphics data source.
pitchPitch of the buffer (number of bytes in a scanline).
xx coordinate of the destination rectangle.
yy coordinate of the destination rectangle.
wWidth of the destination rectangle.
hHeight of the destination rectangle.
Note
The specified destination rectangle must be completly contained in the visible screen space, and must be non-empty. If not, a backend may or may not perform clipping, trigger an assert, or silently corrupt memory.
See also
updateScreen
getScreenFormat

Implements OSystem.

◆ updateScreen()

virtual void OSystem_IPHONE::updateScreen ( )
virtual

Flush the whole screen, i.e. render the current content of the screen framebuffer to the display.

This method may be called very often by engines. Backends are hence supposed to only perform any redrawing if it is necessary and otherwise return immediately. See https://wiki.scummvm.org/index.php/HOWTO-Backends#updateScreen.28.29_method

Implements OSystem.

◆ lockScreen()

virtual Graphics::Surface* OSystem_IPHONE::lockScreen ( )
virtual

Lock the active screen framebuffer and return a Graphics::Surface representing it.

The caller can then perform arbitrary graphics transformations on the framebuffer (blitting, scrolling, etc.). Must be followed by a matching call to unlockScreen(). Code that is calling this should make sure to only lock the framebuffer for the shortest time possible, as the whole system is potentially stalled while the lock is active.

Returns
0 if an error occurs. Otherwise, a surface with the pixel format described by getScreenFormat is returned.

The returned surface must not be deleted by the client code.

See also
getScreenFormat

Implements OSystem.

◆ unlockScreen()

virtual void OSystem_IPHONE::unlockScreen ( )
virtual

Unlock the screen framebuffer, and mark it as dirty, i.e. during the next updateScreen() call, the whole screen will be updated.

Implements OSystem.

◆ setShakePos()

virtual void OSystem_IPHONE::setShakePos ( int  shakeXOffset,
int  shakeYOffset 
)
virtual

Set current shake position, a feature needed for some SCUMM screen effects.

The effect causes the displayed graphics to be shifted upwards by the specified (always positive) offset. The area at the bottom of the screen which is moved into view by this is filled with black. This does not cause any graphic data to be lost. To restore the original view, the game engine only has to call this method again with offset equal to zero. No calls to copyRectToScreen are necessary.

Parameters
shakeXOffsetShake x offset.
shakeYOffsetShake y offset.
Note
This is currently used in the SCUMM, QUEEN, KYRA, SCI, DREAMWEB, SUPERNOVA, TEENAGENT, TOLTECS, ULTIMA, and PETKA engines.

Implements OSystem.

◆ showOverlay()

virtual void OSystem_IPHONE::showOverlay ( )
virtual

Activate the overlay mode.

Implements OSystem.

◆ hideOverlay()

virtual void OSystem_IPHONE::hideOverlay ( )
virtual

Deactivate the overlay mode.

Implements OSystem.

◆ isOverlayVisible()

virtual bool OSystem_IPHONE::isOverlayVisible ( ) const
inlinevirtual

Return true if the overlay mode is activated, false otherwise.

Implements OSystem.

◆ clearOverlay()

virtual void OSystem_IPHONE::clearOverlay ( )
virtual

Reset the overlay.

After calling this method while the overlay mode is active, the user should be seeing only the game graphics. How this is achieved depends on how the backend implements the overlay. It either sets all pixels of the overlay to be transparent (when alpha blending is used) or, in case of fake alpha blending, it might just put a copy of the current game graphics screen into the overlay.

Implements OSystem.

◆ grabOverlay()

virtual void OSystem_IPHONE::grabOverlay ( Graphics::Surface surface)
virtual

Copy the content of the overlay into a surface provided by the caller.

This is only used to implement fake alpha blending.

Implements OSystem.

◆ copyRectToOverlay()

virtual void OSystem_IPHONE::copyRectToOverlay ( const void *  buf,
int  pitch,
int  x,
int  y,
int  w,
int  h 
)
virtual

Blit a graphics buffer to the overlay.

In a sense, this is the reverse of grabOverlay.

Parameters
bufBuffer containing the graphics data source.
pitchPitch of the buffer (number of bytes in a scanline).
xx coordinate of the destination rectangle.
yy coordinate of the destination rectangle.
wWidth of the destination rectangle.
hHeight of the destination rectangle.
See also
copyRectToScreen
grabOverlay

Implements OSystem.

◆ getOverlayHeight()

virtual int16 OSystem_IPHONE::getOverlayHeight ( )
virtual

Return the height of the overlay.

See also
getHeight

Implements OSystem.

◆ getOverlayWidth()

virtual int16 OSystem_IPHONE::getOverlayWidth ( )
virtual

Return the width of the overlay.

See also
getWidth

Implements OSystem.

◆ getOverlayFormat()

virtual Graphics::PixelFormat OSystem_IPHONE::getOverlayFormat ( ) const
virtual

Return the pixel format description of the overlay.

See also
Graphics::PixelFormat

Implements OSystem.

◆ showMouse()

virtual bool OSystem_IPHONE::showMouse ( bool  visible)
virtual

Show or hide the mouse cursor.

Currently, the backend is not required to immediately draw the mouse cursor on showMouse(true).

See also
Graphics::CursorManager::showMouse

Implements OSystem.

◆ warpMouse()

virtual void OSystem_IPHONE::warpMouse ( int  x,
int  y 
)
virtual

Move ("warp") the mouse cursor to the specified position in virtual screen coordinates.

Parameters
xNew x position of the mouse.
yNew y position of the mouse.

Implements OSystem.

◆ setMouseCursor()

virtual void OSystem_IPHONE::setMouseCursor ( const void *  buf,
uint  w,
uint  h,
int  hotspotX,
int  hotspotY,
uint32  keycolor = 255,
bool  dontScale = false,
const Graphics::PixelFormat format = NULL 
)
virtual

Set the bitmap used for drawing the cursor.

Parameters
bufPixmap data to be used.
wWidth of the mouse cursor.
hHeight of the mouse cursor.
hotspotXHorizontal offset from the left side to the hotspot.
hotspotYVertical offset from the top side to the hotspot.
keycolorTransparency color value. This should not exceed the maximum color value of the specified format. In case it does, the behavior is undefined. The backend might just error out or simply ignore the value. (The SDL backend will just assert to prevent abuse of this).
dontScaleWhether the cursor should never be scaled. An exception is high ppi displays, where the cursor might be too small to notice otherwise, these are allowed to scale the cursor anyway.
formatPointer to the pixel format that the cursor graphic uses (0 means CLUT8).

Implements OSystem.

◆ setCursorPalette()

virtual void OSystem_IPHONE::setCursorPalette ( const byte *  colors,
uint  start,
uint  num 
)
virtual

Replace the specified range of cursor palette with new colors.

The palette entries from 'start' till (start+num-1) will be replaced - so a full palette update is accomplished via start=0, num=256.

Backends which implement this should have the kFeatureCursorPalette flag set.

See also
setPalette
kFeatureCursorPalette

Reimplemented from OSystem.

◆ pollEvent()

virtual bool OSystem_IPHONE::pollEvent ( Common::Event event)
virtual

Query an event from the source.

Parameters
eventReference to the event struct where the event should be stored.
Return values
trueIf an event was polled, false otherwise.

Implements Common::EventSource.

◆ getMillis()

virtual uint32 OSystem_IPHONE::getMillis ( bool  skipRecord = false)
virtual

Get the number of milliseconds since the program was started.

Parameters
skipRecordSkip recording of this value by the event recorder. This might be needed particularly when we are in an on-screen GUI loop where the player can pause the recording.

Implements OSystem.

◆ delayMillis()

virtual void OSystem_IPHONE::delayMillis ( uint  msecs)
virtual

Delay/sleep for the specified amount of milliseconds.

Implements OSystem.

◆ createMutex()

virtual Common::MutexInternal* OSystem_IPHONE::createMutex ( )
virtual

Create a new mutex.

Returns
The newly created mutex, or 0 if an error occurred.

Implements OSystem.

◆ getScreenChangeID()

virtual int OSystem_IPHONE::getScreenChangeID ( ) const
inlinevirtual

Return an int value that is changed whenever any screen parameters (like the resolution) change, i.e. whenever EVENT_SCREEN_CHANGED is sent.

You can track this value in your code to detect screen changes in case you do not have full control over the event loop(s) being used (like the GUI code).

Returns
Integer that can be used to track screen changes.
Note
Backends that generate EVENT_SCREEN_CHANGED events must overload this method appropriately.

Reimplemented from OSystem.

◆ quit()

virtual void OSystem_IPHONE::quit ( )
virtual

Quit (exit) the application.

Implements OSystem.

◆ addSysArchivesToSearchSet()

virtual void OSystem_IPHONE::addSysArchivesToSearchSet ( Common::SearchSet s,
int  priority = 0 
)
virtual

Add system-specific Common::Archive objects to the given SearchSet. For example, on Unix, the directory corresponding to DATA_PATH (if set), or, on macOS, the 'Resource' dir in the app bundle.

Parameters
sSearchSet to which the system-specific dirs, if any, are added.
priorityPriority with which those dirs are added.

Reimplemented from OSystem.

◆ getTimeAndDate()

virtual void OSystem_IPHONE::getTimeAndDate ( TimeDate td,
bool  skipRecord = false 
) const
virtual

Get the current time and date, in the local timezone.

On many systems, this corresponds to the combination of time() and localtime().

Implements OSystem.

◆ getMixer()

virtual Audio::Mixer* OSystem_IPHONE::getMixer ( )
virtual

Return the audio mixer.

For more information, see Audio::Mixer.

Implements OSystem.

◆ getDefaultConfigFileName()

virtual Common::String OSystem_IPHONE::getDefaultConfigFileName ( )
virtual

Get the default file name (or even path) where the user configuration of ScummVM will be saved.

Note that not all ports can use this.

Reimplemented from OSystem.

◆ logMessage()

virtual void OSystem_IPHONE::logMessage ( LogMessageType::Type  type,
const char *  message 
)
virtual

Log the given message.

It is up to the backend where to log the different messages. The backend should aim at using a non-buffered output for it, so that no log data is lost in case of a crash.

The default implementation outputs them on stdout/stderr.

Parameters
typeType of the message.
messageThe message itself.

Implements OSystem.


The documentation for this class was generated from the following file: