Working with Scene Variants

The Variant Manager can help you switch between different representations of your scene.

Windows
MacOS
Linux

When you create realtime 3D experiences around design data, you often need to switch the objects in your scene from one state to another. This many mean swapping objects' positions and rotations in 3D space from one place to another, showing and hiding specific objects, changing Materials, turning lights on and off, and so on.

This is a particularly common need in mechanical and industrial design applications, where some industry-standard modeling and scene design tools allow you to set up multiple variants to represent different versions of your scene. This is sometimes referred to as 150% BOM, meaning that the scene contains more than 100% of the visible options.

The classic example is a configurator that lets clients choose in advance between different possible options for an expensive vehicle such as a car, motorcycle, or aircraft, before the vehicle is actually assembled or manufactured. The simple example in the video below shows a car configurator that offers multiple options for items such as wheel trims, brake calipers, and body paint colors.

To help you handle these kinds of scenarios in your own visualization projects, Unreal Studio offers a helper called the Variant Manager. The Variant Manager makes it easier to set up multiple variants of your scene and to switch between these variants—both in the Editor and at runtime. For example, in the sample application shown above, the Variant Manager is set up with each available option. A simple on-screen UMG UI calls Blueprint functions exposed by the Variant Manager to activate those options on demand.

The topics in this section describe what the Variant Manager is and how you can use it to produce similar effects.

Getting Started

How-To

Credits

The car model used on this page is courtesy of Allegorithmic.

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback