BlendedBoxMap: TextureMap
BlendedBoxMap – superclass: textureMap; super-superclass:material – classID: #(334310678, 1815100752)
| Value > MAXWrapper > Material > TextureMap > BlendedBoxMap |
The BlendedBoxMap texture map allows you to project maps onto one or more objects. It projects images from three 90 degree directions. You can project 1, 3, or 6 different maps for each side of the projection box. You can also customize the way the images are blended. Available in 3ds Max 2017.1 Update and higher
| Example |
|---|
-- Example creation: s = Sphere() mat = StandardMaterial() mat.name = "MyStandard" s.material=mat bbm = BlendedBoxMap() mat.diffuseMap = bbm |
The number of projections used by the BlendedBoxMap, where:
- 0 = 1 projection
- 1 = 3 projections
- 2 = 6 projections
This property corresponds to the Number of Projections radio button.
<BlendedBoxMap>.colors : RGB color array default: #((color 0 0 255), (color 255 0 0), (color 0 255 0), (color 255 255 0), (color 255 0 255), (color 0 255 255))
An array of colors for the BlendedBoxMap projections. Note that while the mode property or UI may be set to 1 or 3 projections, this array always contains 6 members.
This array corresponds to the color selectors under the Maps section of the UI.
<BlendedBoxMap>.tex (SubMat0) : texturemap array default: #(undefined…)
An array of texturemaps for the projections. This array contains seven items. The first six are the individual projection maps, and the seventh is the blend map.
This array corresponds to the map selectors under the Maps section of the UI.
<BlendedBoxMap>.MapEnable : Boolean array default: #(true, true, true, true, true, true, false)
An array of Boolean values indicating whether the associated map is enabled. The first six are the individual projection maps, and the seventh is the blend map.
This array corresponds to the checkboxes next to the color and map selectors under the Maps section of the UI.
<BlendedBoxMap>.mapscale : float default: 100.0
The percentage scaling value, applied to all maps.
This property corresponds to the Map Scale spinbox in the UI.
<BlendedBoxMap>.blend : float default: 25.0
The percentage amount of blend between each projection.
This corresponds to the Blend Amount spinbox in the UI.
<BlendedBoxMap>.blendMapStrength : float default: 25.0
The percentage amount of blend with the BlendMap, which is the tex[7] map.
<BlendedBoxMap>.texturespace : integer
The projection method that will be used, where:
- 0 = Individual Objects
- 1 = Multiple Objects at Once
- 2 = Auto
This corresponds to the Project Onto combobox in the UI.
<BlendedBoxMap>.node (Object) : node
The node used to control projection when in Multiple Objects at Once texture space. If this node is not set to a valid scene node, a default projection and bounding box is used.
Randomize Projection Properties
<BlendedBoxMap>.FORSeed : integer
The seed used to initialize the pseudo-random number generator for the Randomize Projection settings. This property corresponds to the Seed setting in the UI.
<BlendedBoxMap>.randx : Boolean <BlendedBoxMap>.randy : Boolean <BlendedBoxMap>.randz : Boolean
Indicates whether to randomize the projection on the X, Y, and Z axes.
These properties correspond to the Randomize Axis checkboxes in the UI.
Map Transform Properties
<BlendedBoxMap>.useRandom : Boolean default: False
Indicates whether the map transform parameters are generated randomly, between the minimum and maximum specified values, or are specified as static values.
This property corresponds to the Use Random Values checkbox in the UI.
<BlendedBoxMap>.seed : integer default: 12345
The seed value used to initialize the pseudo-random number generator when useRandom is True.
<BlendedBoxMap>.posu : float default: 0.0 <BlendedBoxMap>.posu2 : float default: 0.0
The Position U and V values, or if useRandom is True, the minimum random value.
<BlendedBoxMap>.posv : float <BlendedBoxMap>.posv2 : float default: 0.0
The Position U and V values, or if useRandom is True, the maximum random value.
<BlendedBoxMap>.posLock : Boolean default: False
Indicates whether the Position V is locked to match the Position U. When True, the values for posu and posu2 are used, and posv and posv2 are ignored.
<BlendedBoxMap>.rota : float default: 0.0 <BlendedBoxMap>.rotb : float default: 0.0 <BlendedBoxMap>.rotc : float default: 0.0
The Rotation T/B, L/R and F/B values, or if useRandom is True, the minimum random values.
<BlendedBoxMap>.rota2 : float default: 0.0 <BlendedBoxMap>.rotb2 : float default: 0.0 <BlendedBoxMap>.rotc2 : float default: 0.0
The Rotation T/B, L/R, and F/B maximum random values.
<BlendedBoxMap>.rotLock : Boolean default: False
Indicates whether all offsets are locked to the Rotation T/B values. When True, only the values from rota and rota2 are used.
<BlendedBoxMap>.scaleu : float default: 100.0 <BlendedBoxMap>.scalev : float default: 100.0
The Scale U and V values, or if useRandom is True, the minimum random value.
<BlendedBoxMap>.scaleu2 : float default: 100.0 <BlendedBoxMap>.scalev2 : float default: 100.0
The Scale U and V maximum random values.
<BlendedBoxMap>.scaleLock : Boolean default: False
Indicates whether the Scale V values are locked to the Scale U values. When true, both values are taken from scaleu and scaleu2.
Render Projection Templates
<BlendedBoxMap>.renderResolution : Integer default:1024
The Resolution Maximum Value.
Projection Properties
<BlendedBoxMap>.cube : Boolean default: False
Indicates whether the projection is projected as a cube.
<BlendedBoxMap>.cubeMode : Integer default: 0
The cube projection mode where:
- 0 = Non-Uniform
- 1 = Uniform - Picked
- 2 = Uniform - Size
- 3 = Uniform - Largest
This property corresponds to the Cube dropdown in the UI.
<BlendedBoxMap>.cubeSize : Integer default: 100
The cube projection size, when the cubeMode=2 (Uniform - Size).
This property corresponds to the Cube size spinbox in the UI.
<BlendedBoxMap>.cubeNode : node default: Undefined
The cube projection node, when the cubeMode = 1 (Picked).
<BlendedBoxMap>.lockToFrame : Boolean default: False
Indicates whether the projection is locked to a frame, indicated by lockFrame.
This property corresponds to the Lock to Frame checkbox in the UI.
<BlendedBoxMap>.lockFrame : Integer default: 0
The frame the projection is locked to, if lockToFrame is True.
This property corresponds to the Lock to Frame spinbox in the UI.
<BlendedBoxMap>.coords (Coordinates) : StandardXYZGen
An object that represents the Coordinate settings for the Blended Box Map. See StandardXYZGen for the exposed properties.
BlendedBoxMap Interfaces
Interface: BlendedBoxMap
This interface provides access to the Render Projection Templates for the Blended Box Map feature. This feature creates images that can be used to paint.
Properties:
None
Methods:
<boolean>Render()
Triggers a template render for the BlendedBoxMap. Returns False if the render cannot be performed (for example, if no render output path is specified), otherwise True.
<void>GetBaseFileName <&TSTR>fname Fname is out parameter
Gets the Render Projection Templates output path and base filename for the specified BlendedBoxMap.
For example:
str = "" diffuseMap.GetBaseFilename &str
<boolean>SetBaseFilename <TSTR>fname
Sets the Render Projection Templates output directory and base filename for the BlendedBoxMap.
-- create blended boxmap teapot and render t = teapot() mat = StandardMaterial() t.material = mat bbm = BlendedBoxMap() mat.diffuseMap = bbm bbm.SetBaseFilename "C:\\maps\\teapot.jpg" bbm.Render()
Setting this base filename with a six-projection Blended Box Map will result in the following files when the Render() method is used:
- C:\maps\teapot_Top.jpg
- C:\maps\teapot_Bottom.jpg
- C:\maps\teapot_Left.jpg
- C:\maps\teapot_Right.jpg
- C:\maps\teapot_Front.jpg
- C:\maps\teapot_Back.jpg
Actions:
None
Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.