Tile Sampler


Tile Sampler (Color)

In: Generators/Patterns

Complex

Description

Tile Sampler is the ultimate tile-pattern generating node. It's an evolved, more complex version of Tile Generator. As of 2017 2.1, the differences are much smaller between Tile Sampler and Generator. The main differences are now only in the seven different map slots which are available for driving Scale, Position, Rotation, Size, Color and Masking. Their effect can be blended in separately.

Tile Sampler is useful for creating man-made procedural patterns, with additional control over certain parameters driven by external input maps.

Make sure you are familiar with Tile Generator before moving on to Tile Sampler. In most cases, you'll find Tile Generator suffices and you won't need the added complexity of Tile Sampler.

Parameters

 Click here to expand parameters...

Inputs

  • Pattern Input 1-6Grayscale Input / Color Input
    Custom pattern image, used when the "Pattern" parameter is set to "Image Input".
    The amount of available inputs is determined by the Pattern Input Number parameter.
  • Scale Map InputGrayscale Input
    Grayscale map to drive tile scaling.
  • Displacement Map InputGrayscale Input
    Grayscale map to drive tile displacement.
  • Rotation Map InputGrayscale Input 
    Grayscale map to drive tile rotation.
  • Vector Map InputColor Input 
    Color vector map to drive non-uniform scaling.
  • Color Map InputGrayscale Input / Color Input
    Map to drive per-tile tinting.
  • Mask Map InputGrayscale Input 
    Mask slot used for hiding certain tiles.
  • Pattern Distribution Map Input: Grayscale Input
    Mask slot used to drive multiple custom pattern inputs.
  • Background InputGrayscale Input / Color Input
    Optional background image.

Parameters

  • X Amount0 - 64
    Amount of X-repetitions of the pattern.
  • Y Amount0 - 64
    Amount of Y-repetitions of the pattern.
  • Non Square Expansion: False/True
    Enables compensation of squash and stretch with non-square ratios.
  • Pattern 
    • PatternPattern Input, Square, Disc, Paraboloid, Bell, Gaussian, Thorn, Pyramid, Brick, Gradation, Waves, Half bell, Ridged Bell, Crescent, Capsule, Cone
      Selects what pattern shape to use.
    • Pattern Input Number1 - 6
      Amount of custom patterns to randomly choose from.
    • Pattern Input Distribution: Random, Pattern Number, Distribution Map
      Sets how multiple Pattern Inputs are chosen. Random means a random one is chosen, Pattern Number means they are just placed in a looping sequence. Distribution map uses a grayscale map input to drive placement.
    • Pattern Input Filtering (Engine > v4)Bilinear + Mipmaps, Bilinear, Nearest
    • Pattern Specific0.0 - 1.0
      Lets you change the selected pattern's shape. The effect is dependent on the selected pattern.
    • Pattern Specific Random0.0 - 1.0
      The randomisation effect is dependent on the selected pattern.
    • Rotation0, 90, 180, 270
      Stepped rotation (90 degree).
    • Rotation Random0.0 - 1.0
      Random free-rotation on a per-tile basis.
    • Symmetry Random0.0 - 1.0
      Sets the number of tiles that should be randomly flipped/mirrored according to below behaviour.
    • Symmetry Random Mode: Horizontal + Vertical, Horizontal, Vertical
      Determines symmetry mirroring behaviour.
  • Size 
    • Size0.0 - 1.0
      Changes non-uniform proportions for tiles.
    • Size Random0.0 - 1.0
      Randomises proportions per-tile.
    • Scale0.0 - 10.0
      Sets global tile scale.
    • Scale Random0.0 - 1.0
      Randomises scale per-tile
    • Scale Map Multiplier0.0 - 1.0
      Blends in the effect of the Scale map.
    • Scale Vector Map Multiplier0.0 - 1.0
      Blends in the effect of the scale vector map to drive non-uniform scaling.
    • Scale Parametrization AffectX and Y, X, Y
      Sets how the scale parametrization is driven.
  • Position 
    • Position Random0.0 - 10.0
      Randomises tile position over both axes.
    • Offset0.0 - 1.0
      Shifts tiles depending on Offset Type.
    • Offset Typehorizontal quincux, vertical quincux, horizontal global, vertical global
      Changes which direction the Offset operates in.
    • Global Offset0.0 - 1.0
      Globally offsets all tiles on X- or Y-axis.
    • Displacement Map Intensity0.0 - 1.0
      Blends in the strength of the Displacement map on the Offset.
    • Displacement Angle0.0 - 1.0
      Sets the angle at which to displace.
    • Vector Map Displacement0.0 - 1.0
      Uses Vector map to drive displacement and Angle.
  • Rotation 
    • Rotation0.0 - 1.0
      Globally rotates all tiles.
    • Rotation Random0.0 - 1.0
      Rotates randomly per-tile.
    • Rotation Map Multiplier0.0 - 1.0
      Blends in the effect of Rotation map on per-Tile rotation.
    • Vector Map Multiplier0.0 - 1.0
      Uses Vector Map to drive per-tile rotation.
  • Color 
    • Mask Map Threshold0.0 - 1.0
      Treshold for mask map when to start hiding tiles.
    • Mask Map InvertFalse/True
      Inverts Mask map effect.
    • Mask Map Sampling TechniquePattern Center, Pattern Bounding Box (slower)
      Whether hiding should be determined by a single point or by a bounding box. Avoids stray pixels causing strange effects.
    • Mask Random0.0 - 1.0
      Random masking, works parallel to mask map.
    • Invert MaskFalse/True
      Inverts random masking.
    • Blending ModeAdd/Sub, Max (Tile Sampler) / Add/Sub, Alpha Blend (Tile Sampler Color)
      Blend mode for tiles onto background and each other.
    • Color(Grayscale value) / (Color value)
      Solid, global tile color.
    • Color/Luminance Random0.0 - 1.0
      Randomisation of color, per-tile.
    • Color Parametrization ModeColor Input, Scale, Line Index, Row Index, Pattern Index (Tile Sampler)
      / Color Map, Scale, Line Index, Row Index, Pattern Index, Pattern Center Position, Pattern Center Position (RG) Bsphere Size (B) (Tile Sampler Color)
      Sets how exactly color randomisation is parametrised.
    • Color Parametrization Multiplier0.0 - 1.0
      Blends in the above Parametrization effect.
    • Color Parametrization Affect (Color only): RGB+Alpha, RGB only, Alpha only
      Sets how the Parametrization affects color.
    • Global Opacity (Grayscale only)0.0 - 1.0
      Sets global tile opacity.
    • Background Color(Grayscale value) / (Color value)
      Sets solid background color.
    • Reverse Rendering OrderFalse/True
      Reverses rendering order to go from back to front.

Example Images

Example shows how parameters are driven by input maps (Pattern Distribution, Scale, Rotation).