mandelbrot3D node

Go to: Attributes.

The Mandelbrot3D texture is a 3 dimensional function that has infinite detail and structure which was first discovered by the mathematician Benoit Mandelbrot. This texture supplies many variants to the original set including the closely related julia set. In the 3d form higher values for the exponent (lobes attribute) provide for better detail> This has become known as Mandelbulb. As well the mandelbox function provides complex geometric structure.

This node is MP safe

Node name	Parents	Classification	MFn type	Compatible function sets
mandelbrot3D	texture3d	texture/3d:drawdb/shader/texture/3d/mandelbrot3D	kMandelbrot3D	kBase kNamedObject kDependencyNode kTexture3d kMandelbrot3D

Attributes (57)

The following quick index only shows top-level attributes (too many attributes to show them all): amplitude, boxMinRadius, boxRadius, boxRatio, centerX, centerY, centerZ, checker, circleRadius, circleSizeRatio, circles, color (6), depth, escapeRadius, focus, implode, implodeCenter (3), juliaU, juliaV, leafEffect, lineBlending, lineFocus, lineOffsetRatio, lineOffsetU, lineOffsetV, lobes, mandelbrotInsideMethod, mandelbrotShadeMethod, mandelbrotType, points, refPointCamera (3), refPointObj (3), shift, stalksU, stalksV, value (3), wrapAmplitude, xPixelAngle, zoomFactor

Long name (short name) Type Default Flags

amplitude (a) float 1.0

Amplitude multiplies the value of mandelbrot function before looking up in the value and color ramps. This thus affects the range of the function that looks up the ramp. If amplitude is large then some values may be beyond the range of the ramp. These values will either clamp or wrap based on the wrapAmplitude attribute. This wrapping can be useful in creating many bands with only a few ramp indices.

boxMinRadius (bxm) float 0.5

Box Min Radius controls the minimum radius within each iteration for the mandebox and hybrid methods.

boxRadius (bxr) float 1.0

Box Radius controls the primary radius within each iteration for the mandebox and hybrid methods.

boxRatio (brt) float -3.0

Box Ratio controls the amount the radius is scaled each iteration, which determines the ratio of sizes between iterations.

centerX (cnx) float 0.0

CenterX,Y and Z is the point on the 3D mandelbrot function that is positioned at the center of the texture. The range 0 to 1 is redefined as 0 to 100, which provides finer control in the UI.

centerY (cny) float 0.0

CenterX,Y and Z is the point on the 3D mandelbrot function that is positioned at the center of the texture. The range 0 to 1 is redefined as 0 to 100, which provides finer control in the UI.

centerZ (cnz) float 0.0

CenterX,Y and Z is the point on the 3D mandelbrot function that is positioned at the center of the texture. The range 0 to 1 is redefined as 0 to 100, which provides finer control in the UI.

checker (chk) float 0.0

Checker creates alternating regions. The tightness of the checker pattern is affected by the escapeRadius.

circleRadius (ccr) float 0.5

Circle Radius controls the size of the circles.

circleSizeRatio (csr) float 1.0

Circle Size Ratio controls the rate at which the circle radius changes each iteration.

circles (cir) float 0.0

Circles creates a circle within each iteration in a manner similar to pickover stalks.

color (cl) compound n/a

Color defines a range of color values used to remap the input value to the outColor. The Input Value parameter, along with the min and max attributes determine where to index into this ramp.

color_Position (clp) float 0.0

Position of ramp value on normalized 0-1 scale

color_Color (clc) float3

Ramp color at the sibling position

color_ColorR (clcr) float 0.0

Ramp red channel value at the sibling position

color_ColorG (clcg) float 0.0

Ramp green channel value at the sibling position

color_ColorB (clcb) float 0.0

Ramp blue channel value at the sibling position

color_Interp (cli) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

depth (dm) integer 20

Depth controls how much calculation is done by the Mandelbrot texture. Fractal textures are created by an iterative mathematical process; as the process goes over more levels, it produces a more detailed fractal, but takes longer to do so. As one zooms in on the fractal higher depthMax values are required. The higher the depth the closer one can resolve the border region of the mandelbrot set.

escapeRadius (esr) float 2.0

When the excapeRadius is exceeded the iteration on the mandelbrot function stops. For the classic set a value greater than two will guarantee the set is accurate as when that value is exceeded it is in the set and further iterations will tend to infinity. However for some variations on the set, higher iterations can be useful. With the checker effect higher values will result in closer together bands. As well values lower than 2 can also be used to create interesting effects.

focus (foc) float 1.0

Focus determines how tightly the colors map to the set. For close up zooms a higher focus can help push the colors closer to the boundary of the set.

implode (imp) float 0.0

Implode warps the mandelbrot function in a concentric fashion about a point defined by the Implode Center. At a value of zero there is no effect, while at a value of 1.0 it is a spherical projection of the noise function, creating a starburst effect. Negative values can be used to skew the noise outward instead of inward.

implodeCenter (imc) float3 0.0, 0.0, 0.0

Implode Center defines the center point about which the implode effect is defined.

implodeCenterX (imx) float 0.0

Implode Center X x position for implode effect

implodeCenterY (imy) float 0.0

Implode Center Y y position for implode effect

implodeCenterZ (imz) float 0.0

Implode Center Z z position for implode effect

juliaU (jlu) float 0.0

JuliaU is the first component of the of the complex number used to define the Julia set. This may be thought of as a coordinate in the complex plane. The full mandelbrot set automatically sets this coordinate to the uv coordinate and it thus contains all possible Julia sets. For a Julia set, however, one must specify this coordinate manually.

juliaV (jlv) float 0.0

JuliaV is the second or imaginary component of the complex number used to define the Julia set. This may be thought of as a coordinate in the complex plane. The full mandelbrot set automatically sets this coordinate to the uv coordinate and it thus contains all possible Julia sets. For a Julia set, however, one must specify this coordinate manually.

leafEffect (lef) float 0.0

Leaf Effect thresholds the mandelbrot function in a way that creates the look of leaves.

lineBlending (lbl) bool false

Line Blending creates smooth junctions between circles and stalks. It multiplies the values within iterations instead of taking the closest distance.

lineFocus (lfc) float 0.5

Line Focus controls the sharpness of the circle and stalk lines. They become thinner as this value increases.

lineOffsetRatio (lor) float 1.0

Line Offset Ratio controls the rate at which the line offset changes each iteration. The line offset u or v should be non-zero for this to have an effect, as it multiplies those values within each iteration.

lineOffsetU (lou) float 0.0

LineOffsetU shifts the location of points, circles and stalks.

lineOffsetV (lov) float 0.0

LineOffsetU shifts the location of points, circles and stalks.

lobes (lbs) float 1.0

Lobes controls the exponent used by the mandelbrot set. Higher powers create more lobes. The standard mandelbrot set is power 2 and results in 1 lobe. Increasing the lobe value will create more lobes and compute a set using a higher exponent.

mandelbrotInsideMethod (mim) enum 2

Determines how to shade the base mandelbrot set for regions that fall inside the set. Zero sets regions inside the set to a fixed zero value. Max Iteration shades inside areas with the max iteration. This matches the inside edge when used as a displacement map. Shaded Inside does a smooth shading of internal values based on the radius. Shaded WithoutLines does a smooth shading of internal values based on the radius but the effect of points, circles and stalks are only on the outside. Lines applies lines on the inside but no other shading. Inner Lines Only applies lines on the inside but not to regions outside the set.

mandelbrotShadeMethod (msm) enum 1

Determines how to shade the mandelbrot structure. Classic shades based on the total number of iterations before the escape radius is exceeded. Smooth is like the classic set but creates a continuous range of values with no banding. Minimum Radius shades based on the smallest radius within all iterations Escape Radius shades based on the radius in the final iteration Lines Only Only draws the points stalks and circles with no background set.

mandelbrotType (nty) enum 1

Determines the overall type of fractal simulation to use. Julia Set can be used to create swirling self similar patterns. It has two input variables JuliaU and JuliaV that control its shape. Mandebrot Set is the standard mandelbrot set. It contains all possible Julia sets, mapping the two variables of the Julia set to the input UV positions. The 3D form is referred to as the Mandelbulb, and this will tend to look better when using a higher values for the lobes setting. Mandelbox is a recursive folding operation that creates interesting geometric patterns. It can create shapes that look less organic and more man made than the mandelbrot function. There are 3 parameters that control the function: boxRadius, boxMinRadius, and boxRatio. Some values for these attributes may be very chaotic while others can create regular patterns. Box with Julia Set is a combination of both the julia set function and the mandelbox. It may be thought of as a mirroring or folding of the set as it iterates. A wide variety of patterns are possible by varying the mandelbox parameters along with the julia uv attributes. Box with Mandelbrot Set combines the mandelbox and mandelbrot functions.

points (pts) float 0.0

Points controls the intensity of shading based on distance to points each iteration. The offset UV value controls the position of the points. to create a stem-like structure.

refPointCamera (rpc) float3 0.0, 0.0, 0.0

The current reference sample point that has to be shaded

refPointCameraX (rcx) float 0.0

The x component of the current sample position

refPointCameraY (rcy) float 0.0

The y component of the current sample position

refPointCameraZ (rcz) float 0.0

The z component of the current sample position

refPointObj (rpo) float3 0.0, 0.0, 0.0

The current reference sample point that has to be shaded

refPointObjX (rox) float 0.0

The x component of the current reference sample position

refPointObjY (roy) float 0.0

The y component of the current reference sample position

refPointObjZ (roz) float 0.0

The z component of the current reference sample position

shift (shi) float 0.0

Shift offsets the output value of the mandelbrot function before indexing the color map. Animating the shift can animate the flow of colors.

stalksU (stku) float 0.0

StalksU controls the effect known as Pickover stalks where the distance to the axis is used to create a stem-like structure. The offset uv shifts the axis position used.

stalksV (stkv) float 0.0

StalksV controls the effect known as Pickover stalks where the distance to the axis is used to create a stem-like structure. The offset uv shifts the axis position used.

value (vl) compound n/a

Value defines a range of values used to remap the texture value to the outAlpha. The Input Value parameter, along with the min and max attributes determine where to index into this gradient.

value_Position (vlp) float 0.0

Position of ramp value on normalized 0-1 scale

value_FloatValue (vlfv) float 0.0

Ramp value at the sibling position

value_Interp (vli) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

wrapAmplitude (wra) bool true

Wrap Amplitude enables wrapping of mandebrot values greater than 1.0. When the amplitude is high this allows the ramp to repeat, causing many bands with only a few ramp indices.

xPixelAngle (xpa) float 0.002053

The pixel angle

zoomFactor (zfc) float 1.0

Zoom Factor is the level of magnification. The actual zoom is 2 raised to the power of the zoom factor. Thus a zoomFactor of 2 creates a zoom of 4 (2*2), while a zoomFactor of 3 would create a zoom of 8 (2*2*2). This results in a unform rate of zoom.