Scene Materials Panel

All the objects in Koru scene share the same list of materials. You can use the same material on several objects and if you change the material, all the objects will be updated. Koru keeps the list of scene materials in the scene materials panel for your convenience.

Koru scene materials list

On the screenshot above Koru displays the list of currently loaded materials. Not all of them are being used, but the scene still keeps them.

There are two special materials in Koru scene: default and floor. Default material is not shown in the list. Koru use that material for the meshes that have no materials assigned. If you create a mesh - it will get the default material. If you delete a material that is being used by a mesh - that mesh will also get the default material. You can’t edit that material, it is used to let Koru keep rendering the meshes that have no materials. Another special material is “Floor” which is assigned to the scene floor. You also can’t delete it, but modifications are allowed, so you can add a texture or reflection to it.

You can reorder materials in the list by dragging them with your mouse.

The bottom menu allows you to alter the list or manipulate materials.

  • PLUS - adds a new material to the scene;
  • MINUS - removes the currently selected materials from the scene. If material is assigned to a mesh, it is replaced with the “default” material;
  • Edit - lets you clone or rename the selected material;
  • Scene - lets you do some manipulations with the selected materials.

The Scene menu lets you do some useful tricks with selected materials:

Koru scene materials list context menu

There are two items there that may ease up your life a bit:

  • Select geometry by selected materials - Koru looks through the scene and selects all the meshes that have materials currently selected in the list. This is useful if you need to find all the meshes of the same material;
  • Apply material to selected geometry - Koru runs through the selected meshes and applies the currently selected material to them.

These actions are good together, say if you need to replace a material with another. You select the material, then select all the meshes with that material, then select another material and finally apply that material to all the selected objects.

How To Assign Materials

Besides the Scene -> Apply material to selected geometry there is an easier way to assign material to a shape. You simply drag and drop the material onto the shape you want in preview or in scene tree and the material is automatically assigned to it.

How To Replace Materials

If you have a scene material and want to replace it with another one, and also update all the meshes to use the new material, there are two options. The first one is obvious yet long:

  • Add the new material to the scene;
  • Click the old material in the list;
  • Click Scene->Select geometry by selected materials to select all the meshes that use the old material;
  • Select the new material in the list;
  • Click Scene->Apply material to selected geometry to apply the new material to all the meshes that have the old one.

The second option is somewhat faster. Simply drag the new material on top of the old one in the scene materials list. Wait a few seconds until the old material gets selected, then drop the new material on it. This will update the old material with the new one, leaving just its name. If you want to keep the old material, as well, you need to duplicate it first, then update the original one.