AdvancedWood - superclass: textureMap; super-superclass:material - 47:0 - classID: #(2290417414L, 2683680373L)

The AdvancedWood texturemap is a procedural texture map that creates highly realistic wood textures, with pre-sets for several common wood types. Available in 3ds Max 2019 and higher.

Connecting an AdvancedWood map to a Material will automatically create Map Output Selector nodes to connect both Diffuse Color and Bump ports on the Material, which are hidden by default in the Slate Material Editor. You can get the AdvancedWood object by looking at the sourceMap property. For example:

tpot = teapot()
mat = StandardMaterial()
advWood = AdvancedWood()

-- doing this creates Map Output Selectors
-- that connect the AdvancedWood Diffuse to Material Diffuse
-- and AdvancedWood Roughness to Material Bump

mat.diffuseMap = advWood
tpot.material = mat

-- but to get the wood we need to look at the sourceMap of the 
-- Output Selector:
myAdvWood = mat.diffuseMap.sourceMap

Constructor

AdvancedWood...       

Properties

The properties are listed here organized in the order they appear on the AdvancedWood UI, with the exception of the Perlin Noise profile parameters, which are not viisble on the UI.

Presets

<AdvancedWood>.preset     Integer    default: 0   --  integer

Gets or sets the preset profile, from 0 = "3D Ash Glossy" to 39 = "3D Walnut - Unfinished".

General Properties

These are parameters that appear in the General area of the AdvancedWood UI.

<AdvancedWood>.scale     Float    default: 1.0   --  animatable; float

Scales the texture map.

<AdvancedWood>.axis     Integer    default: 2   --  animatable; integer

The axis of the wood grain where 0=X, 1=Y, and 2=Z.

<AdvancedWood>.unit_dependent     BooleanClass    default: true   --  animatable; boolean

Specifies whether to use scene units for scaling.

<AdvancedWood>.roughness     Float    default: 0.16   --  animatable; float

Specifies the amount of roughness, on a scale of 0.0 = 1.0.

<AdvancedWood>.early_wood_color     Color    default: (color 182.444 131.937 75.9015)   --  animatable; RGB color; Controller Scaling: ([1,1,1] : (color 255 255 255)); WeirdScaled ([1,1,1])

The "early" (light) wood color in the grain.

<AdvancedWood>.early_wood_color_map     UndefinedClass    default: undefined   --  texturemap

The map applied to early wood color.

<AdvancedWood>.use_early_wood_color_perlin     BooleanClass    default: true   --  animatable; boolean

Specifies whether to apply perlin noise to the early wood color.

<AdvancedWood>.use_groove_roughness     BooleanClass    default: true   --  animatable; boolean

Specifies whether to create groove roughness.

<AdvancedWood>.groove_roughness     Float    default: 0.22   --  animatable; float

The groove roughness amount, when .use_groove_roughness is true.

<AdvancedWood>.late_wood_color_power     Float    default: 1.0   --  animatable; float; Late_Color_Power

The amount to "darken" (if > 1.0) or "lighten" (<1.0) the early wood color to create the late wood color, if a late wood color or map is not specified.

<AdvancedWood>.use_manual_late_wood_color     BooleanClass    default: true   --  animatable; boolean

Specifies whether to calculate late wood color based on the early wood color (false), or use a the specified manual_late_wood_color (true).

<AdvancedWood>.manual_late_wood_color     Color    default: (color 147.784 105.863 55.0198)   --  animatable; RGB color; Controller Scaling: ([1,1,1] : (color 255 255 255)); WeirdScaled ([1,1,1])

The color to use for late wood, if use_manual_late_wood_color is true.

<AdvancedWood>.manual_late_wood_color_map     UndefinedClass    default: undefined   --  texturemap

A map to use for late wood color, if defined and use_manual_late_wood_color is true.

<AdvancedWood>.use_late_wood_color_perlin     BooleanClass    default: true   --  animatable; boolean

Specifies whether to apply Perlin noise to the late wood color.

<AdvancedWood>.use_late_wood_bump     BooleanClass    default: true   --  animatable; boolean

Specifies whether to apply bump map to the late wood color.

<AdvancedWood>.late_wood_bump_depth     Float    default: 0.1   --  animatable; float

The bump depth, if use_late_wood_bump is true.

<AdvancedWood>.use_diffuse_perlin     BooleanClass    default: true   --  animatable; boolean

Specifies whether to apply Perlin noise to the fiber.

<AdvancedWood>.diffuse_perlin_scale_z     Float    default: 0.05   --  animatable; float

Sets the scale of the Perlin noise applied to the diffuse color, if use_diffuse_perlin is true.

<AdvancedWood>.diffuse_lobe_weight     Float    default: 0.8   --  animatable; float

The global diffuse lobe weight, which is a multiplier to the diffuse color output.

Weights and Ratios

These parameters affect relationships between other parameters, as well as sharpness and noise settings.

<AdvancedWood>.use_fiber_cosine     BooleanClass    default: true   --  animatable; boolean

Specifies whether to use the fiber cosline.

<AdvancedWood>.use_fiber_perlin     BooleanClass    default: true   --  animatable; boolean

Specifies whether to apply Perlin noise to the wood fiber.

<AdvancedWood>.fiber_perlin_scale_z     Float    default: 0.1   --  animatable; float

Specifies the amount of Perlin noise to apply to the wood fiber.

<AdvancedWood>.use_growth_perlin     BooleanClass    default: true   --  animatable; boolean

Specifies whether to apply Perlin noise to the wood growth rings.

<AdvancedWood>.late_wood_ratio     Float    default: 0.098   --  animatable; float

Specifies the ratio of early wood to late wood, where 1.0 is all early wood, 0.0 is all late wood, and 0.5 is half of each.

<AdvancedWood>.early_wood_sharpness     Float    default: 0.395   --  animatable; float

Defines the sharpness or amount of transition between the early wood and late wood rings.

<AdvancedWood>.late_wood_sharpness     Float    default: 0.668   --  animatable; float

Specifies the sharpness of the transition between the late wood and the next growth ring.

<AdvancedWood>.ring_thickness     Float    default: 1.0   --  animatable; float

Specifies the width or thickness of the wood growth rings, with 1.0 being the maximum ring size.

Pores

These settings affect the apperance of "pores" in the wood, which are veins that appear as holes in the wood end grain, and stripes or streaks in the side grain.

<AdvancedWood>.use_pores     BooleanClass    default: true   --  animatable; boolean

Specifies whether to generate pores.

<AdvancedWood>.pore_type     Integer    default: 0   --  integer

Specifies where to generate pores, where 0 = Both, 1 = Early Only, and 2 = Late Only.

<AdvancedWood>.pore_radius     Float    default: 0.04   --  animatable; float

The radius of the pores.

<AdvancedWood>.pore_cell_dim     Float    default: 0.15   --  animatable; float

The dimension of the cell noise that makes pores. A smaller number increases the density of pores.

<AdvancedWood>.pore_color_power     Float    default: 1.4   --  animatable; float

The amount of darkening to apply to the early wood color to produce the pore color.

<AdvancedWood>.pore_depth     Float    default: 0.025   --  animatable; float

The depth amount of the pores.

Rays

<AdvancedWood>.use_rays     BooleanClass    default: true   --  animatable; boolean

Specifies whether to use rays.

<AdvancedWood>.ray_color_power     Float    default: 1.25   --  animatable; float

A color multiplier to apply to the early wood color to generate the ray color. Higher numbers produce darker rays.

<AdvancedWood>.ray_seg_length_z     Float    default: 5.0   --  animatable; float

Ray segment length, higher numbers produce fewer rays.

<AdvancedWood>.ray_num_slices     Integer    default: 30   --  integer

The number of ray slices. Higher numbers increase the ray density.

<AdvancedWood>.ray_ellipse_z2x     Float    default: 10.0   --  animatable; float

The ray ellipse shape ratio.

<AdvancedWood>.ray_ellipse_scale_x     Float    default: 0.5   --  animatable; float

The ray radius.

Coordinates

<AdvancedWood>.coords     StandardXYZGen    default: MtlBase:Placement   --  alias: Coordinates; SubAnim

See StandardXYZGen for the coordinates properties.

Profile Parameters

These parameters are exposed to MAXScript but do not appear in the Advanced Wood texture map UI. These are strings that set the profile used to generate Perlin noise for those parameters to which Perlin noise can be applied. Generally the default is sufficient to produce good results.

<AdvancedWood>.diffuse_perlin_prof     String    default: "0.1 0.1 0.4 0.15 5 0.2 0.01 0.4"   --  string; Diffuse_Perlin_Profile

<AdvancedWood>.early_wood_color_perlin_prof     String    default: "8 0.2 3 0.3 0.35 0.15"   --  string; Early_Wood_Color_Perlin_Profile

<AdvancedWood>.fiber_cosine_prof     String    default: "15 0.2 2 0.5"   --  string; Fiber_Cosine_Profile

<AdvancedWood>.fiber_perlin_prof     String    default: "23.5 1.25 8 0.75 2 0.15"   --  string; Fiber_Perlin_Profile

<AdvancedWood>.growth_perlin_prof     String    default: "0.5 0.5"   --  string; Growth_Perlin_Profile

<AdvancedWood>.late_wood_color_perlin_prof     String    default: "4 0.25 1.5 0.15"   --  string; Late_Wood_Color_Perlin_Profile