Materials
Paint (B) applies a material. Choosing it opens the Materials panel.
- Select a material in the Materials panel.
- Click a face to paint the side you’re looking at, or click a group or component to paint the whole object.
A material painted directly on a face wins over the material of the group or component it’s in. To paint individual faces inside a group or component, open it first.
The In model tab lists the materials the model already uses. The Library tab offers ready-made materials with images, such as brick, concrete, wood, roof tiles and grass; see Library materials.
Choose Default material and click to remove a material, so the default or inherited color shows again.
Each click is one undo step.
To move, turn or stretch a material’s image on a face, see Texture positioning.
Library materials
Section titled “Library materials”The Library tab of the Materials panel holds ready-made materials, grouped into masonry, stone and tile, wood, roofing, landscape, metal and fabric. Hover a swatch to see its name and who made it, and click it to paint with it.
The library is online: its swatches appear once Modlumi reaches it, and the first click on one downloads the material, which takes a moment. The desktop app keeps what it downloads, so those materials also work offline.
The first click adds the material to the model, so it shows up in the In model tab and saves with the model. Each image repeats at its real-world size, so bricks, tiles and planks come out at a realistic scale. Clicking the same swatch again reuses that material instead of adding another copy, unless you’ve renamed it or changed its image.
A library material is an ordinary material once it’s in the model: you can rename it, change its tint or swap its image without affecting the library.
Credits
Section titled “Credits”The library’s images come from ambientCG, which shares them under the CC0 public domain dedication. Each material keeps its credit: the swatch’s tooltip names its source and license, and when you select the material, the Materials panel shows the credit with links to the source and the license. The credit saves with the model and goes along when you export the material.
Share materials
Section titled “Share materials”To use a material someone shared, click Import material… in the
Materials panel and choose a Modlumi .mlmat file or a SketchUp .skm
file. The material is added to the model and selected for painting.
To share a material, right-click it in the In model tab and choose
Export material…. Modlumi writes a .mlmat file with its name, color,
image, real-world image size, surface, maps and credit. In the browser, the file
downloads.
The .mlmat format is open; see Material files.
Pick a material
Section titled “Pick a material”To reuse a material that’s already in the model, choose Pick Material, the eyedropper next to Paint, and click a surface. Modlumi selects that material and switches back to Paint. While painting, you can also Alt-click a surface to pick its material.
Picking a surface with no material selects Default material.
Create a material
Section titled “Create a material”Click New material in the Materials panel. Modlumi adds a plain gray material named Material and selects it for painting. Its properties show in the editor below the list, where you give it a color, images and a finish.
Edit a material
Section titled “Edit a material”The Materials panel lists materials at the top and edits the selected one below. Drag the divider between them to give either more room; double-click it to share the height evenly again. Whenever you pick a material, in the In model or Library tab, with New material, or with the eyedropper, the panel comes to the front with that material in the editor, and the In model list scrolls to it.
Every property is a value with an optional image next to it:
| Property | Value | Image |
|---|---|---|
| Color | Click the swatch to show a color picker below it; click it again, or press Escape, to hide it. | A photo or pattern that repeats across the surface. The color row then reads Tint and tints it. |
| Opacity | 100% is solid; lower lets light through, as for glass and water. | Black cuts the surface away, as for leaves, fences and perforated panels. |
| Roughness | 0 is a mirror polish; 1 is fully matte. | Varies the roughness over the surface. |
| Metallic | 0 for paint, wood, stone and plastic; 1 for bare metal. | Makes parts of one surface metal. |
| Normal | Flat. | Adds small bumps and grooves, such as tile joints, without extra geometry. |
Click the square in the Image column next to a property to choose an image file, or click it again to replace the image. Click × to remove the image, so the value applies again. Roughness and metallic images replace their value, which then reads From image; an opacity image multiplies the opacity.
Once a material has a color image, Width and Height set the size of one repeat in your model’s units. With Keep proportions checked, changing one changes the other, so the image isn’t stretched. A first image shows untinted; Reset tint under the tint’s color picker makes it white again.
The Matte, Satin, Glossy, Metal and Mirror presets under the properties set roughness and metallic in one click. They’re hidden while an image sets either value.
Edits apply at once to every face and object painted with the material. Each change, and each drag of a slider or the color picker, is one undo step.
When you paint with a custom color that isn’t a material yet, the editor shows a color picker for it instead.
Surfaces and PBR shading
Section titled “Surfaces and PBR shading”Besides its color and image, a material has a physically based surface: how metallic and how rough it is, and optional image maps that vary those over the surface, add bumps or cut it out. They show in PBR shading.
Switch to PBR shading
Section titled “Switch to PBR shading”The Standard | PBR switch at the top right of the viewport, also under View → Shading, chooses how the model is shaded:
- Standard shows material colors and images under an even modeling light. Surfaces and maps don’t change how it looks.
- PBR renders physically based materials: metals reflect the sky and ground around the model, rough surfaces spread their highlights, normal maps add relief and opacity maps cut out shapes. Colors go through filmic tone mapping, and sunlight casts its shadows as usual.
Modlumi remembers your choice for the next time you start it.
Edit a surface
Section titled “Edit a surface”Roughness, metallic and normal images only show in PBR shading. While the view uses Standard shading, the material editor offers Show PBR to switch, so you can watch the surface change as you edit it.
Roughness, metallic, normal and opacity images are also called maps. Each follows the material’s color image, repeating and moving with it; without a color image, maps repeat every meter. Metallic, roughness and opacity maps are read from their red channel. Modlumi reads normal maps in the OpenGL convention, with green toward the top of the image.
Texture sets
Section titled “Texture sets”Downloaded materials, such as those from ambientCG
and Poly Haven, come as a set of images named alike
but for one word: Tiles01_Color.png, Tiles01_Roughness.png,
Tiles01_NormalGL.png and so on. When you choose the color image in the
material editor, Modlumi finds the other maps in the same folder and adds
them, in the same undo step, to the properties that have no image yet. Modlumi skips
normal maps in the DirectX convention, marked NormalDX or nor_dx, since
their bumps would point the wrong way.
Surfaces and maps save with the model, go along when you export the material and carry over to glTF exports.
Rename a material
Section titled “Rename a material”Type a new name in the Name field of the material editor, then press Enter or click elsewhere. Escape keeps the old name. Renaming is one undo step.
Delete a material
Section titled “Delete a material”Right-click a material in the In model tab of the Materials panel and choose Delete. Faces painted with it show the default material again, and objects painted with it show their own colors. Deleting is one undo step.
To clean up materials you no longer use, right-click any material in the In model tab and choose Remove Unused. It deletes every material nothing in the model is painted with, including materials of components you haven’t placed, in one undo step.