Search Unity

[Free] Editor Formulas Window

Discussion in 'Assets and Asset Store' started by VoxelBoy, Sep 6, 2016.

  1. VoxelBoy

    VoxelBoy

    Joined:
    Nov 7, 2008
    Posts:
    240
    Editor Formulas Window provides a common window for all the single-file Editor tools created by the community.



    Why?
    Some Editor tools are super-complex, with their own windows, editors, custom data files, etc.

    Some are more humble and can be implemented in a single file, a single class, maybe even a single method. Instead of cluttering your Unity menus with MenuItems or disfiguring your Editor layout with small, one-button EditorWindows, you can easily turn your tool into an Editor Formula and have it appear in the Editor Formulas Window.

    Buttons, fields, and other controls for a Formula are drawn automatically by looking at the list of parameters required by the formula's method. You don't have to write a single line of GUI code. Focus on the functionality of your tool and the GUI will be taken care of. Currently supported parameters are Int, Float, String, Bool, Rect, RectOffset, Vector2, Vector3, Vector4, Color, UnityEngine.Object, Enum, LayerMask.

    Features
    • Get free and easy access to a growing list of simple Editor tools built by the community.
    • Download new formulas with the click of a button.
    • Easily hide any formula you're not interested in.
    • Effortlessly search through all local and online formulas.
    • Submit your own formulas to benefit the entire Unity community!

    Download

    You can download the full source-code over at GitHub.

    Usage
    Clone the GitHub repository or Download as a ZIP.
    Extract into your project's Assets folder.
    Bring up the window from the Window menu -> Editor Formulas menu item or using the shortcut (Win: Ctrl+Shift+E Mac: Cmd+Shift+E). In a few seconds, the list of all available online formulas will be downloaded.
    You will see a list of greyed out buttons for each Formula with a download button next to them, like so:



    Click the download button next to a Formula and when Unity is done compiling, it will be ready to use.
    Click on the large button with the Formula name to run the Formula.
    If the Formula has parameters, they will be shown below the button.



    Click on the Options button on the right to access Formula options.



    Window options
    Click on the dropdown at the top-right of the window to bring up the options menu.



    Debug Mode toggle enables the window to push a variety of log messages to the console which can be useful to see what happened if something went wrong (for example, when trying to download a formula).

    Show Hidden Formulas toggle allows you to show or hide the formulas you've chosen to hide.

    Show Online Formulas toggle allows you to show or hide formulas you haven't downloaded yet.

    Submitting Formulas
    If you want to submit a Formula of your own:
    1. Create a copy of the FormulaTemplate.cs file that you can find in the Editor Formulas/Editor/Formulas folder.
    2. Choose a name for your Formula. Rename the file and the class with the CamelCase version of your Formula name.
    3. Modify the FormulaAttribute on the already existing Run method to pass it the formula name, tooltip, and author name.
    4. Fork the Editor Formulas Github repository and submit your Formula as a pull request.
    5. Your Formula will be quickly reviewed. If it's not directly accepted, you will be contacted to correct any issues found.
    For more details on how to write a Formula, visit the GitHub repository for the formulas themselves.
     
    Tiberty, MrCool92 and TeagansDad like this.