ImGui applications usually store settings such as window positions, opened windows (etc.), in a file “imgui.ini”. HelloImGui and ImmApp extend this functionality by storing additional settings such as application layouts, status bar settings, and user-defined custom settings.
Settings location¶
By default, the settings are stored in a ini file whose named is derived from the window title (i.e. runnerParams.appWindowParams.windowTitle).
This is convenient when developing, but not so much when deploying the app.
You can finely define where they are stored by filling runnerParams.iniFolderType and runnerParams.iniFilename.
runnerParams.iniFolderType
Choose between: CurrentFolder, AppUserConfigFolder, AppExecutableFolder, HomeFolder, TempFolder and DocumentsFolder.
runnerParams.iniFilename
This will be the name of the ini file in which the settings will be stored. It can include a subfolder, in which case it will be created under the folder defined by runnerParams.iniFolderType.
Settings content¶
The settings file contains, standard ImGui settings (window position, size, etc.), as well as additional settings defined by HelloImGui:
Application status: app window location, opened windows, status bar settings, etc. See members named remember_xxx in the parameters doc for a complete list.
Settings for each application layout (see video for an example)
Store custom settings¶
You may store additional user settings in the application settings. This is provided as a convenience only, and it is not intended to store large quantities of text data. See related doc for more details.