Skip to content

DMZScripts/MaterialTextureLoader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 

Repository files navigation

Material Texture Loader

Advanced material creation plugin for 3ds max

Description

The Material Texure Loader can select texture files, automatic assigns them to material channels and create fully customizable materials setups. It supports various mapping configurations, gamma adjusment, adds color correction maps, generates names for all materials and maps and links relevant mapping parameters. Quickly apply materials to objects or material editor. All settings can be saved as presets to support any type of workflow.

Main Features

  • Customizable setups
  • Auto texture recognition
  • Per-channel color/gamma
  • 5 mapping types
  • MaxScript commands
  • Presets
  • 2-sided materials
  • Drag-and-drop
  • Apply to objects or editor

Support

  • 3ds max 2016 - 2025.
  • VRay (3-6)
  • Corona (5-11)
  • Redshift
  • Arnold
  • FStorm
  • Octane
  • Physical, PBR and Standard materials

Table of contents


Setup

Installation

There are two ways you can intall .mzp file in 3ds Max
  • Drag and Drop the latest version of "MTL_v1.x install.mzp" from windows explorer into the 3ds max viewport
  • Run "MTL_v1.x install.mzp" with 3ds max top menu. Go to Scripting > Run Script > select "MTL_v1.x install.mzp" > Open On succesfull install, press Open MTL to start using the script.

Create button

  1. Restart 3ds Max.
  2. In 3ds Max go to Customize > Customize User Interface > Toolbars > Category > DMZ.
  3. Drag "Material Texture Loader" into a toolbar.

Custom Naming Filters

  1. Go to your 3ds max userscripts folder, DMZ folder (C\Users[Username]\AppData\Local\Autodesk\3dsMax\2018 - 64bit\ENU\userscripts\DMZ\MTL\namingFilters),
  2. Any .ini file (eg. 'nameFilter_01 Default.ini') needs to be placed in that folder and must start with 'nameFilter_'.
  3. Do not change the naming of the channels inside the file (eg. 'diffuse=', 'ambient=').
  4. Add any word after the equal ('=') character, separated by a comma (','). These words are used to select textures for the right channel.
  5. You can have up to 12 different .ini naming filter files, which all can be separately activated and combined in the MTL.


User Interface

Top Menu

Load New Textures: Open texture file browser to select new files

You can multi-select any 3ds max supported image files.
Selected files will be place in the Texture Channels dropdown list.
Previously loaded files will be removed.
Active Naming Filters will be used to automatically assign textures to Channels.

Add Extra Textrues: Open texture file browser, to select additional files

You can multi-select any 3ds max supported image files.
Selected files will be added to the Texture Channels dropdown list.
Active Naming Filters will be used to automatically re-assign textures to Channels.
Load New Textures: Open texture file browser to select new files.

Use All Channels: Activate all texture Channels

When materials don't use every texture channel, this will make all Texture Channel available.
Maps that are created in this way are accessable after pressing Add Material to Compact / Add Material to Slate.
Maps will be placed adjacent to the material that is created.

Reset: Reset entire UI back to Deafult

Selects Default as Preset
Clears all image files from Texture Channels
Clears Material Slot

Naming Filters: Select active Naming Filters

Naming FIlters are used for automatic Texture Channel selection.
You can activate any combination of listed Naming Filters.
Up to 10 nameFilter files in nameFilters directory will be listed.

MTL Installer: Opens Installer menu

Contains Uninstall option and a list of all plugin installation directories.

Preset: Dropdown list of all saved settings

Switching Presets will change all settings directy.
When Update is active, you can still switch Presets. Material type will be locked to current Material.

Save Preset: Save current settings

Opens a Preset Name menu, where you can save the Current Settings under the given name.
If Preset name already exists, menu will ask if you want to overwrite existing Preset.

Dockable:Switch between dockable and window dialog mode

Channels

Enable/Disable Channel: Disable or enabled a channel from creating maps

Disabeling channels will disable all other Channel controls.
When disabled no maps are created, even when a texture file is selected in the dropdown list.
Channel will be disabled automatically when a material type does not support the channel.
You can force every channel to be active by checking Use All Channels (see: Top Menu - Files).

Channel Texture: Select a texture file for the channel from the dropdownlist

For selected tecxture files a texture map will be created and connected to the material.
Texture files will be available when loaded in with Load New Textures or Add Extra Textrues.
Select empty item to deselect any texture file. No map will be created for this channel.

Channel Strength: Set the strength or influence of the texture image

Control will be disabled when material type does not have support for Texture Strength.

Channel Settings: Button that displays channel name and opens channel specific settings

(see: Channels - Settings.)

Show Channel: Show channels texture map in viewport

Only 1 channel can be displayed in viewport.
Only works when a material is created.

Channel Settings

Color Space: Choose between different type of color space input for texture file.
Auto linear-sRGB: when sRGB Color Space is selected and 32bit images are loaded, load files as linear-sRGB.
Gamma: Gamma input value for texture file.
Color Correction: Inlcude a color correction map for the texture channel.
Inver Color: Invert the colors of the texture channel.

Will add an extra map to invert colors, or use existing map settings if possible.

Set: Accepts the current settings for the texture channel.

Click the 'X' icon if you wish to cancel setting changes.

Maps

Map Type: Choose between standard and render specific texture map

Render specific texture maps will be selected based of the material type selected.
Not all renderers support standard Bitmaps.

Blur: Blur value applied to each texture map

Blur is applied to all channels equally. There is no option for channel specifc blur values.

Mapping Channel Set mapping channel for all texture maps
Mapping Type: Set the mapping type for each texture map
Size: set U and V mapping size
Non-Uniform Size: Enable

Material

Active Render Material: Set Material Type to active renderer.

When active automatically switches Material Type when renderer is changed.
Will de-activate when activating Update and existing material is not compatible will active Renderer.

Material Type: Select from dropdown list with any supported materials.

De-activates Active Render Material when you select other material type that is compatible with the active renderer.

Diffuse: Set the materials base diffuse color
Reflection: Set the materials base reflection color
Glossiness: Set the materials base glossiness value
Refl. IOR: Set the Materials base IOR value

Uncheck checkbox will set IOR value to the materials max IOR value.

2-Sided: Makes the material 2-sided

Depending on the Material Type an extra 2-sided material is created.
With Update active you can switch between 2-sided and not 2-sided. Materials in material editors will be correctly updated.
When Updating a material to being not 2-sided. The old 2-sided material is still applied to existing objects.

ID: Set the materials ID Channel
Create Material: Create a material with selected textures and settings.

If Auto-accept Name (A) is un-checked, a Material Name window will open.

Auto-accept Name(A): Create material name derived from selected textures.

If Auto-accept Name is un-checked, a Material Name window will open when creating a material.
Derived name is the common part of all selected texture files.

Update: Lock and adjust created material with any changes to textures and settings

With Update active you cannot change Material Type.
Loading New or Adding Extra Textures automatically re-assigns textures. With Update active, a message box will pop-up to confirm.

Clear: Clears only the current created material.

Unlike Reset, textures and settings are kept as is.

Slot

Material Button: Created material can be dragged into objects, editors or material slots.

Shows a renderer preview of the material if Render Material Preview is on.

Show Material in Viewport: Shows created material in viewport

When active no texture channel can be displayed in viewport.
Only works when a material is created.

Render Material Preview: Renders a small preview thumbnail

Preview image is taken from the Material Editor.

Render Preview Background: Renders a checkpattern in the preview background.

Not all renderers support this feature.

Save Render Preview: Opens a save file dialog, to save current render preview.
Add Material to Selection: Applies to current material to selected objects.

If Modifiers are checked, these will also be added to the selecte objects.

Add Material to Material Library: Opens a file loading dialog, to select a material library in whhich to save current material.
Add Material to Compact Editor: Adds current material to Indicated Sample Slot of the Compact Material Editor
Add Material to Slate Material Editor: Adds current material to Indicated View of the Slate Material Editor

Modifiers

uvMap: If checked and when using Add Material to Selection, add uv_map modifer to selected objects.

uv_map will be using real-world tiling, if this option is selected in Maps settings.

Displace: If checked and when using Add Material to Selection, add render specific displacement modifer to selected objects.
Height Value: Height value of the displacement modifier.
Center Point: Sets the center point of the displacments height value.


Features list

Instant material creation

  • Automatic texture recognition and parameter linking for all channels
  • Real-world, tri-planar, random and spherical mapping
  • Specular and Metallic workflow support
  • Settings for color, reflection, glossiness, IOR, ID and 2-Sided materials

Advanced maps setups

  • Per channel color space and gamma input values and adjustments (including ACEScg, sRGB, linear-sRGB, Raw)
  • Color/ao, normal/bump and specular/metallic compositing maps
  • Extensive MaxScript commands to automate the creation process
  • UDIM map loading
  • Settings for blur, map channel, mapping size, rotation and random rotation

Live updatable settings

  • Instant rebuilding of textures, maps and parameters
  • Quick texture selection per channel
  • Per channel strength adjustment
  • Switch between presets
  • Show material preview and texture channels in viewport

Apply and save materials

  • Include uvw and displacement modifiers on material assignment
  • Add materials and maps to Slate or Compact material editors
  • Save to material library
  • Save material thumbnail

About

Documentation for Material Texture Loader for 3ds Max

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published