# Description

This module contains a few helpful editor tools, like favorites, history and some handy toolbar tools.


## Favorites

An editor window, where you can pin folders and assets, so you can easily find the most used assets in your project.


## History

An editor window, where the history of all selected assets are shown. An asset in the window can be selected to easy get back to previous selections.


## Toolbar

Toolbars to the left and right of the play-buttons by using the `MainToolbarElement`-attribute.


### Default tools

Several tools are available from start:

* Build: Select build target and build
* Player Prefs: Delete all PlayerPrefs data
* Scene: Load any scene in the project easily by using the dropdown
* Time Scale: Adjust the time scale from [0;1] from a slider
* UI Canvas: Select and center the camera on any Canvases in the scene
* UI Layer: Toggle the UI layer on/off
* Settings: Open project or preferences
* Save: Project save


### Customization

You can create your own toolbar extensions by using the property attribute `MainToolbarElement`.

```
[Preserve]
[MainToolbarElement("Toolbar/Time Scale", ussName = "", defaultDockIndex = 0, defaultDockPosition = MainToolbarDockPosition.Middle, menuPriority = 500)]
public static MainToolbarElement Draw()
{
    var content = new MainToolbarContent("Time:", "Adjust Time.timeScale from [min;max] and snaps when value is approximately 1.0");
    return new MainToolbarSlider(content, Time.timeScale, ToolbarTimeSettings.TimeScaleMinValue, ToolbarTimeSettings.TimeScaleMaxValue, OnTimeScaleValueChanged);
}

private static void OnTimeScaleValueChanged(float value)
{
    value = Mathf.Clamp(value, ToolbarTimeSettings.TimeScaleMinValue, ToolbarTimeSettings.TimeScaleMaxValue);

    if (Mathf.Abs(value - 1.0f) < 0.02f)
        value = 1.0f;

    if (!Mathf.Approximately(Time.timeScale, value))
        Time.timeScale = value;
}
```

A list of multiple controls can be done by changing:

```
public static MainToolbarElement Draw()
```

to

```
public static IEnumerable<MainToolbarElement> Draw()
```


### Customization - Settings

To add enable/disable settings or more to Preferences -> Toolbar, you can implement `IToolbarSettings`.

```
internal sealed class ToolbarFooSettings : IToolbarSettings
{
    public string Title => "Foo";
    
    private const string PREF_MIN_VALUE = "ToolbarSettings_MinValue";
    private const string PREF_MAX_VALUE = "ToolbarSettings_MaxValue";
    
    public static float MinValue
    {
        get => EditorPrefs.GetFloat(PREF_IS_UI_ENABLED, false);
        set => EditorPrefs.SetFloat(PREF_IS_UI_ENABLED, value);
    }

    public static float MaxValue
    {
        get => EditorPrefs.GetFloat(PREF_IS_UI_LAYER_ENABLED, false);
        set => EditorPrefs.SetFloat(PREF_IS_UI_LAYER_ENABLED, value);
    }

    public void Draw()
    {
        MinValue = EditorGUILayout.FloatField("Min Value", TimeScaleMinValue);
        MaxValue = EditorGUILayout.FloatField("Max Value", TimeScaleMaxValue);
    }
}
```

If you need to refresh a control, due to changes in settings. Then invoke:

```
MainToolbar.Refresh("Toolbar/Time Scale");
```