Platform /

Called at the beginning of a launch, can be overridden for platform-specifc preparation.

Called at the end of a launch, can be overridden for platform-specifc cleanup.

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 to the list of directories which are searched for assets.

Not thread-safe, e.g. you should not call this when loadAsset() or getAssetPath() can occur from a different thread.

Returns a vector of directories that are searched when looking up an asset path.

Returns a DataSource to an application resource. resourcePath is defined on a per-platform basis.

CinderResources

Returns the absolute file path to the resources folder. Returns an empty fs::path on windows.

CinderResources

Returns the absolute file path to a resource located at rsrcRelativePath inside the bundle's resources folder. Returns an empty fs::path on windows. Throws ResourceLoadExc on failure.

CinderResources

Returns the path to the associated executable.

Sets the path to the associated executable, overriding the default.

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 std::map of the system's environment variables. Empty on WinRT.

Returns a canonical version of path . Collapses '.', ".." and "//". Converts '~' on Cocoa. Expands environment variables on MSW.

Returns the path to the user's home directory.

Returns the path to the user's documents directory.

Returns the path used for the default executable location. Users may override this with setExecutablePath() for application specific purposes.

Suspends the execution of the current thread until milliseconds have passed. Supports sub-millisecond precision only on OS X.

Launches a path in the system's default web browser.

Returns a stack trace (aka backtrace) where stackTrace() [0] == caller, stackTrace() [1] == caller's parent, etc.

Sets the name of the current thread to name .

Returns a std::vector of Displays connected to the system.

Returns the current Platform .

Sets the current Platform .

Called when asset directories are first prepared, subclasses can override to add platform specific directories.

Called to add the default assets folder by walking up the path from the executable until a folder named 'assets' is found. Subclasses can override this method to disable this functionality.