Skip to content
Mustard edited this page Sep 25, 2023 · 17 revisions

Mustard Simplify

drawing

A scene simplifier for Blender to increase viewport performance.

Installation

Requirement: Blender 3.6 or above

Download the latest version .py file from the Release page.

The install the .py file (not any .zip package) as a standard Blender add-on.

Activate the Mustard Simplify tab pressing N in viewport and selecting the Simplify tab on the right.

Simplify

Click on Simplify Scene to disable features of the scene and the objects that are usually not needed when just animating.

In the Options, the features to be simplified can be specified. For instance, if drivers are needed in the scene, uncheck Drivers.

Additional options are available for Modifiers and Shape Keys.

Modifiers

In the options, the type of Modifiers to simplify can be selected. For instance, if Subdivision Surface modifiers are needed in the scene, de-select its voice;

Shape Keys

drawing

Several options are available for Shape Keys.

Firstly, there is a distinction between Driven Shape Keys (i.e., the value is driven by a Driver or an Animation Keyframe) and Not-Driven Shape Keys. Their options are completely independent.

  • Global Settings: these are available only for non-driven Shape Keys.
    • Disable only when Null: if active, only non-driven shape keys with value = 0 are muted; if disabled, all non-driven shape keys are muted.
  • Driven Shape Keys: these are available for driven Shape Keys, and they are independent of Global Settings.
    • Disable if with Animation Key-Frames: animation driven shape keys are muted when this option is active; otherwise they are left un-muted regardless of their value and Global Settings.
    • Disable if with Drivers: drivers driven shape keys are muted when this option is active; otherwise they are left un-muted regardless of their value and Global Settings.
      • Disable only when Null: if active, driver driven shape keys are muted only of their current value is null; otherwise all drivers driven shape keys are muted.

Exceptions

drawing

In some cases, we do not want to simplify every Object in the scene. With exceptions we can remove some Objects from the simplification process.

There are two kind of Exceptions, Objects and Collection. We can set both of them, and the resulting exceptions will be the combined effect of those two, i.e., using Objects does not prevent the addition of the exception collection.

Objects

Objects can be added to the list, and we can modify their individual exceptions. For instance, I can add a Camera object and decide to disable only its drivers; and a mesh object and decide to skip simplify on all features.

Collection

In case we need to exclude an entire collection to the simplification process, add a collection in the field.

Note that all Object features in the collection will not be simplified.

Note: The Collection exception has precedence on single Object exceptions. This means that Objects in the collection are not simplified in any of its features, regardless of the settings in the Objects exception tab. In fact, if an object contained in the exception collection is added to the object exceptions, its settings will be disabled and a red icon will appear in the Object list. This should help debug any issue that might appear if we add Objects and a collection at the same time.

Advanced

In this section some additional settings can be found:

  • Textures Size Limit: set a limit to the texture size that Blender can render. This is exactly the same setting that can be found in Blender settings. Note that this is activated as soon as a value is chosen, and not when Simplify Scene is activated.

Tools

Some additional tools to clean the scene are available. Note that most of them act destructely on the Objects, i.e., removing data that can not be retrieved (although Undo is available). Thus make a backup before using these tools!

Data Removal

This tool removes Objects data blocks that are used mainly to produce mesh/models (e.g., Diffeomorphic data), and might affect viewport performance. Depending on the scene, the tool can boost performance sensibly (up to 2x in some cases).

Settings

Additional add-on settings can be changed in this tab.

  • Debug: this option adds several debug messages in the console. Enable this only in case of issues, or if requested by the maintainer of the add-on when reporting a bug.
Clone this wiki locally