Pages in Documentation
1 Spline BP
2 UI Features
6 Manage Clients
3 Get Started
4 Info Map
5 BP Actors
UI 1 - Part 1
ArchVizUI User Guide Pt.2
Part 2 of the user guide explains how to use the supporting actors for the ArchViz User Interface.
Setting up Object Colors and Color Schemes
The blueprint actor BP_SDotAssetGroup is used to set up Colour Schemes and additional Material Swaps in the project.
The first 2 or more materials are used for both swaps and schemes. Any additional materials will only be used for swaps.
Currently there is a maximum of 12 different materials that can be used in the list. Any more materials added will be ignored.
You do not have to add preview thumbs. These will be auto-created by the render stage. See further down for details.
Colour Scheme Materials
TIP: If you want to use other material choices then the first in the list for the colour schemes then untick this box. Set up another actor with the box ticked, put your choices for the colour scheme in there and move it out of the level. It will never be visible and will not show up in the list.
> Asset Material Group - Add asset groups here.
An 'Asset group' can be a single mesh or a group of meshes that will swap materials together. Let's say a couch set out of 3 elements. Now if you want the cushions on the couch swap their materials at the same time then just add another array element for them.
Another case would be that your assets have more than one material that need to be swapped. For example the fabric and the frame of a couch set. (Remember you can copy/paste array's members)
> Asset - Add an array element for each asset
eg. 3 array elements if you have 3 couch elements. Then click on the eye-dropper and "pick" the asset with the mouse from your levels.
> Material - the list of materials the user can swap to.
If "Colour Schemes" are enabled the first entries will be used for them. material  will be used for colour scheme  and so on. Any additional materials will only show up in the "Individual Material Swap" feature.
Is lit for scenario: Click the box here if a lighting scenario requires the materials to turn on the emissive for a certain scenario. In the example level the lighting scenario  is the night lighting.
Use this only for materials like the shade of a lamp. I'll explain further down how to set up the material for this feature to work.
Colour Scheme Preview
Switch Light On or Off in Materials
With the materials changing on an actor the material used for lights needs to be able to have an 'ON' and 'OFF' state of the material. Unreal doesn't support static switches in run time but you can use this little node setup as a work around.
This uses an 'IF' node and a scalar parameter. If the parameter named LightIsOn is set to zero the emissive will be zero. Any positive value will enable the emissive and the light appears to be on.
The UI actor (light switcher or asset group) will set the parameter named 'LightIsOn' to '1' or '0' depending on the 'scenario tick box' being ticked or not.
Use EXACTLY the name 'LightIsOn' as shown in the image here. There are a few materials set up this way in the example project.
NOTE: the example shows the setup for a material function. Standard materials won't need the 2 red input nodes.
This actor is a simplified version of the BP_SDotAssetGroup. You can use it if all color schemes have the same material but the lighting screnario requires the light to have an on and off state.
It works the same way as the SDotAssetGroup without the material array.
This actor allows the user to swap static meshes in the scene. In the example project the stove can be replaced with either a induction or a gas version.
This actor doesn't point to an existing static mesh in the scene. Instead it needs to be placed where the first static mesh choice is supposed to be. After adding the choice to the blueprint from the content browser you can align the blueprint with the mesh in the scene. All other mesh choices can be moved or rotated relative to the first one.
You can add multiple instances of the choice, for example a set of 4 chairs. The user will then swap all the instances at once.
The assets placed with this actor will be "dynamic". They are not part of the static lighting. They can be moved without having to re-bake the scene. This comes with a slight lack of visual quality.
>Static Mesh Choices - Add mesh choices as an array element here.
> Material' - Array of materials for the mesh. Array ID = Material ID of the mesh
NOTE: To have different material versions for the same mesh you will need to create a mesh choice for each material. You can't swap meshes and then swap materials for those meshes)
> Additional Copies - each array element you enter here will create an instance of the same mesh. They will start at the same spot as the original mesh. Use location and rotation to move them to their desired position (see example video)
NOTE: Large collision or trigger boxes can block the rays sent to check if the target is visible. Check for collision and triggers if your swap actor doesn't show up in the list.
This actor marks teleport positions the player can jump to. Place one for each jump destination.
TIP: The list will be sorted by alphabet. You can use numbers in front of the name: 01 Living, 02 Kitchen, 03 ...
The render stage will auto-create preview thumbs for the Swap Materials feature. Place the actor into your level if you are using this feature.
The render stage has no settings. it will render up to 12 preview images using the render to texture feature. It will do so every time the user switches to another asset group. It will take the preview mesh and materials from the active asset group and render the previews. The UI will then display the preview thumbs.
Place the render stage somewhere far enough away from the playable area. It contains dynamic lights that would otherwise interfere with your level lighting.
NOTE: if the previews have strange artifacts while playing the project check your fog or LUT settings or any related post process settings.
You may need to extend or place a post process volume around the render stage if the thumbs look a lot different then the scene.