You are here: Reference Guide > 3D Nodes > ApplyMaterial

ApplyMaterial

Apply a material from the mat input to your 3D object(s). For example, you can use this node to apply a global material to several merged objects (note that this overrides any individual materials applied to the geometry before it was merged).

Inputs and Controls

Connection Type	Connection Name	Function
Input	unnamed	The 3D geometry object to which you want to apply a material. If you want to apply the same material to several objects, you can also connect a MergeGeo node here.
Input	mat	The material you want to apply to your 3D object, for example, a BasicMaterial node.

Control (UI)	Knob (Scripting)	Default Value	Function
ApplyMaterial Tab
display	display	unchanged	Adjust the display characteristics of the 3D object. These settings don’t affect the render output of the scene; these are for display purposes only in the 3D Viewer. • off - hides the 3D object. • wireframe - displays only the outlines of the object’s geometry. • solid - displays all geometry with a solid color. • solid+wireframe - displays the geometry as solid color with the object’s geometry outlines. • textured - displays only the surface texture. • textured+wireframe - displays the wireframe plus the surface texture. • unchanged - doesn't change the object's display mode. The Viewer can override this setting.
selectable	selectable	enabled	When enabled, you can make selections as normal in the Viewer. When disabled, points cannot be selected or changed.
render	render_mode	unchanged	Sets how the object will render. This control is independent from the display selection, but has the same settings.
filter	filter_type	all	Select the geometry objects to which the material is applied: • all - apply the material to all incoming geometry objects. • name - only apply the material to incoming geometry objects that match the filter name settings. NOTE: For name to work, the geometry has to have a name attribute. The only nodes that add this attribute are ModelBuilder and ReadGeo (when reading in an Alembic file), but third-party plug-ins can add it too.
	filter_name_match	contains	Sets how to filter the incoming geometry objects to determine which objects the material is applied to: • equals - set the material on any objects whose name matches the string in the filter name field exactly. • doesn't equal - set the material on any objects whose name does not match the string in the filter name field exactly. • contains - set the material for any objects whose name contains the string in the filter name field. This can be useful when you have some structure to your object names. For example, if you have objects like /Root/Chair/Seat, /Root/Chair/Back, and /Root/Table, you can select contains and set the filter name field to chair to apply the material to all parts of the chair while leaving the table alone. • doesn't contain - set the material for any objects whose name does not contain the string in the filter name field. This control is only available when filter is set to name.
	filter_name	N/A	The filter name to use to determine which objects the material is applied to. You can type the filter name directly into this field or use the choose button to select a filter name from a list of incoming geometry objects. This control is only available when filter is set to name.
choose	filter_refresh	N/A	Open the Object Name Chooser dialog. This allows you to select a filter name from a list of incoming geometry objects. This control is only available when filter is set to name.