Material surface node

Assigns one or more materials to geometry.

See also: Material shader, Materials, Material palette

Overview

The Material node assigns a material to a list or group of primitives (faces) or points.

This node lets you override individual parameters on the material, allowing you to apply per-primitive customizations of a base material (see the help for the Local parameters option below).

Under the hood, the node creates an attribute named shop_material and sets it to the pathname of the material. The scene viewer and mantra use the attribute

Parameters

Attributes

The level at which to assign the materials. You should usually leave this set to Primitive attributes.

Point attributes

Assign the material at the point level instead of the primitive (face) level. This is only useful for point instancing. The objects instanced to the points will pick up the material assigned to the point.

Primitive attributes

Assign the material at the primitive (face) level. This is the default and the normal setting.

Detail attribute

Assign the material at the detail (entire geometry) level. This is not normally useful and you should not use this setting unless you're doing something custom and weird.

Use full paths to materials

This stores the full path to the material. Normally you should leave this on.

Number of materials

The number of materials to assign. This is useful for assigning materials to various groups of primitives. You cannot layer materials – if you assign multiple materials to the same primitive, the last material will override the previous ones.

Tabs

The node creates tabs for the Number of materials you set. To insert an additional material, click the Add button. To remove a material, click its tab, then click the Delete button.

Group

A list of primitives (or points, if Attributes is set to Point attributes), or the name of a group, to assign the material to.

Material

The path of the material to assign. Click the chooser icon to choose the material from a list.

Overrides use local variables

Turn this on if:

  • You are using local parameters (such as $PR and $PT) to override parameters on the material (see below).

  • You need to use local variables in the values of the local parameter overrides.

Local parameters

Controls the number of local overrides of parameters on the material. This lets you make local changes to the parameters of the material that only apply to the selected primitives.

To set up an override:

  1. Click the Add button next to the Local parameters number to add overrides.

    If you already have an override, you can also click the Add button next to it.

  2. Use the Choose parameter menu to choose which parameter on the material you want to override.

  3. Use the Integer, Float, String, Color, or Vector fields (depending on the type of parameter you're overriding) to set the value of the overridden parameter.

To remove an override, click the Delete button next to it.