User Guide (Version 1.18)

Updating Graphics Settings for Android and iOS

Lumberyard supports low, medium, high, and very high graphics performance for mobile devices. You can change the graphics settings in Lumberyard Editor to simulate the graphics on Android and iOS devices. This feature helps you visually check your mobile games in Lumberyard Editor during the development process.

Updating Graphics Performance in Lumberyard Editor

Use the Graphics Performance menu in Lumberyard Editor to choose a graphics setting for Android or iOS.

To update graphic settings in Lumberyard Editor

  1. In Lumberyard Editor, choose Edit, Editor Settings, Graphics Performance.

  2. Choose Android or iOS and then choose a setting. For more information, see Editor Settings.

                Lumberyard Editor Graphics Performance menu for Android

When you choose a graphics performance setting, the r_GraphicsQuality console variable automatically updates with a corresponding value:

  • Very High: 4

  • High: 3

  • Medium: 2

  • Low: 1

You can change the default value for the r_GraphicsQuality console variable in each OS configuration file. You can find the files in the lumberyard_version\dev\Cache\game_project\pc directory.

Example iOS Configuration File

The following is an example of the system_ios_ios.cfg file.

                    Example of the system_ios_ios.cfg configuration

If you set r_GraphicsQuality to 0, the graphics performance setting is automatically detected based on the mobile device model or total RAM. You can review the mapping for mobile device models and graphics performance settings in the android_models.xml and ios_models.xml files, located in the lumberyard_version\dev\Cache\game_project\pc\game_project\config directory.


The following is an example of the ios_models.xml file.

                    Example of the ios_models.xml file

Modifying Graphics Configuration Files

Use the Graphics Settings window in Lumberyard Editor to modify the graphics settings for each OS configuration file. You can also modify the configuration files for the following graphics settings: low, medium, high, and very high.

To modify a graphics configuration file

  1. In Lumberyard Editor, choose Edit, Editor Settings, Graphics Settings.

  2. In the Graphics Settings window, for Platform, choose Android or iOS for the configuration file that you want to modify.

                        Platform drop-down list in the Graphics
                                Settings window.
  3. Modify the graphics settings for each parameter as needed.

                        Parameters for the iOS configuration file in the Graphics
                                Settings window
  4. Click Save.


    The configuration file saves to the lumberyard_version\dev\game_project\Config directory. Asset Processor prioritizes the settings in this configuration file above the engine's default configuration file, located in the lumberyard_version\dev\Engine\Config directory.