AppCocoaTouch /

Returns the signal emitted when an orientation change may occur, allowing the user to specify which orientations are permitted (any connection can forbid a given orientation). The connected std::function must return an InterfaceOrientation bitmask.

Emits a signal to ask the user what orientations are supported.

Returns the signal emitted when the interface is about to rotate to a new orientation. At this time, the Window 's bounds and orientation have already been updated.

Emits the signal to notify the user that the orientation will change.

Returns the signal emitted when the interface is finished rotating to a new orientation.

Emits the signal to notify the user that the orientation did change.

Returns the signal emitted when the virtual keyboard is about to animate on screen.

Emits the signal used to notify when the virtual keyboard is about to animate on screen.

Returns the signal emitted when the virtual keyboard is about to animate off screen.

Emits the signal used to notify when the virtual keyboard is about to animate off screen.

Creates and returns a reference to a new Window , adhering to format .

Returns the the currently active Window . Throws ExcInvalidWindow if called with no active window.

Gets the foreground Window , which has keyboard and mouse focus.

Returns the number of Windows the app has open.

Gets a Window by index, in the range [0, getNumWindows() ). Throw ExcInvalidWindow if index is out of bounds.

Returns the InterfaceOrientation for the device Window .

Returns the current InterfaceOrientation for the active Window .

no-op, no cursor on this platform

no-op, no cursor on this platform

no-op, cannot disable framerate on this platform

always false, cannot disable framerate on this platform

Enables the device's proximity sensor, which can return whether the device is close to the user or not. Use in conjunction with proximityIsClose() or getSignalProximitySensor()

Disables the device's proximity sensor.

Returns whether the device is close to the user or not. Must call enableProximitySensor() before using.

Signal emitted when the device becomes close ( true ) or far ( false ). Must call enableProximitySensor() before using.

Enables the device's battery monitor. Use in conjunction with getBatteryLevel() , isUnplugged() and getSignalBatteryState()

Disables the device's battery monitor.

Returns the device's battery level, in the range of [0,1];.

Returns true when the device is not plugged into power.

Signal emitted when the device is unplugged ( true ) or plugged in ( false ). Use in place of polling isUnplugged() .

When disabled, the device will not sleep even after the idling threshold.

Shows the iOS virtual keyboard with KeyboardOptions options . This method can be called with new options while the keyboard is visible.

Returns whether the iOS keyboard is visible.

Hides the default iOS keyboard.

Returns the current text recorded since the most recent call to showKeyboard() .

Sets the current text string that the keyboard is manipulating, overwriting any previous content.

Retuens a pointer to the native UITextView, which can be used to customize the virtual keyboard.

Shows the system status bar.

Returns whether the system status bar is visible.

Hides the system status bar.

Returns the maximum frame-rate the App will attempt to maintain.

Sets the maximum frame-rate the App will attempt to maintain.

Overidden to always return true on mobile.

Overidden to disable, mobile is always full screen.

Returns an invalid position since the device doesn't have a mouse.

No-op on iOS.

Override to perform any application setup after the Renderer has been initialized.

Override to perform any once-per-loop computation.

Override to perform any rendering once-per-loop or in response to OS-prompted requests for refreshes.

Override to receive mouse-down events.

Override to receive mouse-up events.

Override to receive mouse-wheel events.

Override to receive mouse-move events.

Override to receive mouse-drag events.

Override to respond to the beginning of a multitouch sequence.

Override to respond to movement (drags) during a multitouch sequence.

Override to respond to the end of a multitouch sequence.

Override to receive key-down events.

Override to receive key-up events.

Override to receive window resize events.

Override to receive file-drop events.

Override to cleanup any resources before app destruction.

Emitted at the start of each application update cycle.

Signal that emits before the app quit process begins. If any slots return false then the app quitting is canceled.

Emitted prior to the application shutting down.

Emitted when a new display is connected to the system.

Emits a signal indicating a new display has connected to the system.

Emitted when a display is removed from the system.

Emits a signal indicating a display has disconnected from the system.

Emitted when the resolution or some other property of a Display is changed.

Emits a signal when the resolution or some other property of a Display has changed.

Returns the Renderer of the active Window .

Returns the Display of the active Window .

is power management enabled, allowing screensavers and the system's power management to hide the application

Returns the width of the App's current window measured in points.

Returns the height of the App's current window measured in points.

Sets the size of the App's current window measured in points. Ignored in full-screen mode.

Sets the size of the App's window measured in points. Ignored in full-screen mode.

Returns the center of the App's window measured in points.

Equivalent to vec2( getWindowWidth() * 0.5, getWindowHeight() * 0.5 )

Returns the size of the App's current window measured in points.

Returns the aspect ratio of the App's current window.

Returns the bounding area of the App's current window measured in points.

Equivalent to Area ( 0, 0, getWindowWidth() , getWindowHeight() );


Returns the contentScale of the App's window, which is the multiplier that maps points to pixels.

Returns tcoordinates of the top-left corner of the current window measured in points.

Returns the X coordinate of the top-left corner of the current window measured in points.

Returns the Y coordinate of the top-left corner of the current window contents measured in points.

Sets the coordinates of the top-left corner of the current window measured in points.

Sets the coordinates of the top-left corner of the current window measured points.

Returns the average frame-rate attained by the App as measured in frames-per-second.

Returns the sampling rate in seconds for measuring the average frame-per-second as returned by getAverageFps()

Sets the sampling rate in seconds for measuring the average frame-per-second as returned by getAverageFps()

Returns the number of seconds which have elapsed since application launch.

Returns the number of animation frames which have elapsed since application launch.

Returns whether the app is registered to receive multiTouch events from the operating system, configurable via Settings at startup. Disabled by default on desktop platforms, enabled on mobile.

Returns whether Windows created on a high-density (Retina) display will have their resolution doubled, configurable via Settings at startup. Default is true on iOS and false on other platforms.

Returns a DataSourceRef to an application asset. Throws a AssetLoadExc on failure.

Returns a fs::path to an application asset. Returns an empty path on failure.

Adds an absolute path 'dirPath' to the list of directories which are searched for assets.

Returns the path to the application on disk.

Presents the user with an open-file dialog and returns the selected file path.

The dialog optionally begins at the path initialPath and can be limited to allow selection of files ending in the extensions enumerated in extensions .

the selected file path, or an empty fs::path if the user cancelled or this operation isn't supported on the current platform.

Presents the user with an open-folder dialog.

the selected file path, or an empty fs::path if the user cancelled or this operation isn't supported on the current platform.

Presents the user with a save-file dialog and returns the selected file path.

The dialog optionally begins at the path initialPath and can be limited to allow selection of files ending in the extensions enumerated in extensions .

the selected file path, or an empty fs::path if the user cancelled or this operation isn't supported on the current platform.

Returns a reference to an output console, which is by default an alias to std::cout. Other platforms may override to use other necessary console mechanisms.

Returns a vector of the command line arguments passed to the app when intantiated.

Returns a reference to the App's Timeline .

Returns a reference to the App's boost::asio::io_service()

Executes a std::function on the App's primary thread ahead of the next update()

Returns the default Renderer which will be used when creating a new Window . Set by the app instantiation macro automatically.

a copy of the current window's contents as a Surface8u

a copy of the Area area (measured in pixels) from the current window's contents as a Surface8u

Restores the current rendering context to be the App's window or the screen in full-screen mode. Generally this is only necessary if the app has displayed a dialog box or some other external window.

Returns a pointer to the current global AppCocoaTouch .

Returns true if the calling thread is the Application's main thread (the thread running the main function), false otherwise.