Materials
All material tools are in the Shader Editor: open the sidebar with N and choose the colormass tab. The Material panel works on the active material of the selected object.
Download a material
Every material on the platform has a number, its Material ID. You find it in the material's dialog on the platform:
Blender shows the download's progress in the status bar: how many textures are done, and the current file. The ✕ button cancels it.
Once everything has arrived, the material replaces the object's active material. If the object has no material yet, the addon creates one. From then on it works like any other Blender material. The textures are stored in your cache folder and reused, so a material you download again is ready at once.
A downloaded material remembers where it came from: the panel shows its Material Revision ID.
Create and upload a material
A few things to know first
Your material is rendered on the platform, not on your computer, so the platform needs its own copy of everything the material uses. Anything that only exists on your computer, such as an image on your drive, has to be uploaded along with the material. The colormass nodes take care of that. Add them from the Add Colormass node menu:
Colormass BSDF Principled: the shader the platform renders. Use it in place of Blender's Principled BSDF.
Colormass Scanned Transmission: for scanned materials that let light through.
Colormass Texture Set and Colormass Texture Set From Images: a full set of maps in one node.
Colormass Texture From Set: a single map in one node.
Images go into Texture Set or Texture From Set nodes
Blender's Image Texture node only points at a file on your drive, so the platform can't use it. Every image goes into one of the two colormass texture nodes instead.
In this fabric material, one Texture Set holds the complete set of scanned maps: colour, metalness, specular, roughness, anisotropy and normal. Each output feeds the matching input of the Colormass BSDF Principled. A separate Texture From Set holds a dirt mask. It isn't part of the fabric's set, and it only decides where a darker colour is mixed over the fabric's colour:
Texture Set
A Texture Set is one node holding a full set of PBR maps, such as color, normal and roughness.
Colormass Texture Set adds a set that is already on the platform. Leave Texture set ID empty to choose from the sets of this material, or enter another texture set's ID to use its maps.
Adding a texture set from the platform Colormass Texture Set From Images makes a new set from your own files. Choose the maps in the file browser. The addon guesses from each file name which map it is, and how its colours are to be read. Check the guesses, then enter how large the texture is in the real world.
Adding a texture set from your own images
Texture From Set
A Texture From Set is one node holding a single map. Colormass Texture From Set takes either one map out of a texture set on the platform (Texture set) or one image from your drive (Image file). For an image, say which map it is, how its colours are read, and its real-world size.
When to pick which?
If the maps belong together and describe the same surface, like a stack of PBR maps, use a Texture Set. Use a Texture From Set when you need one map on its own, for example as a mask or for bump.
Either way:
All maps of a set need to have the same resolution. The dialog tells you if they don't.
Every texture needs its real-world size in centimetres. This is the size it gets on the platform. Enter the width, and the height follows from the image's proportions.
You can build first and upload later. The nodes don't need the material to exist on the platform yet. Your images are uploaded with the material's next revision.
Convert a material you built with Blender's nodes
You don't have to rebuild an ordinary Blender material. If it uses Blender's Principled BSDF or image textures, the panel offers Prepare material for the platform:
Before it changes anything, the addon lists what it will do, including settings the colormass BSDF handles differently:
Blender's Principled BSDF becomes the Colormass BSDF Principled, and your settings come across with it.
Every Image Texture becomes a Texture From Set node. The rest of the node tree stays as it is.
Every image texture needs a Mapping node in front of it. The addon reads the texture's real-world size from that node's Scale. Mapping nodes of type Point become type Texture, so the texture stays where it was. If an image texture has no Mapping node, the addon tells you which node to fix, and changes nothing until every node can be converted.
To prepare all materials of an object at once, use the same button in Properties ▸ Object ▸ colormass.
Upload
To update a material that is already on the platform, download it, change it, and click Upload new material revision again.
When you upload meshes to the template editor, the addon can upload their changed and new materials along with them. See Scenes.
Last updated