EditorSettings

Inherits: Resource < Reference < Object

Category: Core

Brief Description

Object that holds the project-independent editor settings.

Member Functions

void add_property_info ( Dictionary info )
void erase ( String property )
StringArray get_favorite_dirs ( ) const
String get_project_settings_path ( ) const
StringArray get_recent_dirs ( ) const
String get_settings_path ( ) const
void set_favorite_dirs ( StringArray dirs )
void set_recent_dirs ( StringArray dirs )

Signals

  • settings_changed ( )

Description

Object that holds the project-independent editor settings. These settings are generally visible in the Editor Settings menu.

Accessing the settings is done by using the regular Object API, such as:

settings.set(prop,value)
settings.get(prop)
list_of_settings = settings.get_property_list()

Member Function Description

void add_property_info ( Dictionary info )

Add a custom property info to a property. The dictionary must contain: name:String), and optionally hint:int), hint_string:String.

Example:

editor_settings.set("category/property_name", 0)

var property_info = {
    "name": "category/property_name",
    "type": TYPE_INT,
    "hint": PROPERTY_HINT_ENUM,
    "hint_string": "one,two,three"
}

editor_settings.add_property_info(property_info)

void erase ( String property )

Erase a given setting (pass full property path).

StringArray get_favorite_dirs ( ) const

Get the list of favorite directories for this project.

String get_project_settings_path ( ) const

Get the specific project settings path. Projects all have an unique sub-directory inside the settings path where project specific settings are saved.

StringArray get_recent_dirs ( ) const

Get the list of recently visited folders in the file dialog for this project.

String get_settings_path ( ) const

Get the global settings path for the engine. Inside this path you can find some standard paths such as:

settings/tmp - used for temporary storage of files

settings/templates - where export templates are located

void set_favorite_dirs ( StringArray dirs )

Set the list of favorite directories for this project.

void set_recent_dirs ( StringArray dirs )

Set the list of recently visited folders in the file dialog for this project.

© 2014–2020 Juan Linietsky, Ariel Manzur, Godot Engine contributors
Licensed under the MIT License.
https://docs.godotengine.org/en/2.1/classes/class_editorsettings.html