db&w documentation wiki

finest software | finest docs

Site Tools


tools:random_image_mapper

This is an old revision of the document!


Random Image Mapper (preliminary)

This node is based on the 3DS Max Random Bitmap OSL shader.
Developed by Zap Andersson, Copyright 2018 Autodesk Inc, All rights reserved. Licensed under Apache 2.0 license.

The node places one image within a 0..1 range of UV values, similar to UDIM tiles.

This node require a projection node to be connected to the projection input.

Controls

Background Colour / Blend Mode / Opacity

The three controls define how the texture is composited. They are identical to the controls found in the native texturing nodes.

Image List

This control displays a list of all images used by the node. The top most images has the lowest index (0).

Selecting an image will display it in the preview control.

All other interactions are via two pop-up menus. One is launched by double clicking on an image entry, the other by right clicking anywhere on the control:

LMB double-click menu

This allows you to change the select image to another loaded image, load a new image and select it or change it to (none) - which will treat the list entry as being black with no alpha when rendering.

RMB Menu

This menu can be launch by right clicking anywhere on the list control. Some of the options will only be available if an image is selected in the list.

Move Up

If an image is selected - and isn't the first image in the list already - it will move up by one entry in the list.

Move Down

If an image is selected - and isn't the last image in the list already - it will move down by one entry in the list.

Add Image...

This will add a new image to the list. If an image is selected, the new image will be added below the selected image, otherwise at the end of the list.

Load Image(s)...

This allows the user to load multiple images from disk. These will be added below the currently selected image or at the end of the list.

Images that are loaded into LightWave 3D already will not be loaded again.

Remove Image

This removes the currently selected image from the list.

Clear all Images

This clears the list of images.

Images (tab)

Overlap

The node places one image within a 0..1 range of UV values, similar to UDIM tiles. Normally, it also only checks for images within the current tile to see if it has to be placed and rendered or not. Overlap extends the “search” area. If you notice images being cut off, increase this value.

Higher values will lead to much longer rendering times. Anything above a value of 5 or so will be extremely slow.

Reference Width (Pixels)

This defines which image width in Pixels should be considered as being the width of a UV tile at a scale of 100%. If this values is not 0, the the images will also be mapped in a proportional size to each other. If this settings is 0, every image will be as large as the corresponding UV tile at a scale of 100%.

Pixel Blending / Use MipMaps / MipMap Strength

These controls correspond to the identical controls in the native image sampler or image texturing nodes.

Bump Strength

The strength of the bump mapping.

Placement (tab)

Random Seed

Create New Seed

This doesn't do anything at the moment. Eventually it will replace the *Random Seed* with a new random number.

Probability

Variation

Scale

Position (tab)

X
Y

Rotation (tab)

Base
Randomize
Max
Steps

Scale (tab)

Base
Randomize
Max

HSV (tab)

Base
Randomize
Max

Alpha (tab)

Base
Randomize
Max

This is the plugin of the month for February 2019, made possible by the finest patrons on Patreon.

tools/random_image_mapper.1551188728.txt.gz · Last modified: 2019/02/26 14:45 by lightwolf