Mapping operator

The Mapping operator can be used to assign UVW values to particles.


Mapping From Objects Rollout

By querying closest points on object surfaces, you can assign corresponding mapping values to particles.

  • Input object list: the list of scene objects from which UVW values will be taken.

  • Sample type: controls which sampler will be used to determine closest-object proximities for particles.

UV Source

  • All available channels: when enabled, UVW values from all available surface channels will be applied to corresponding particle UVW channels.

  • Map Channel: the individual map channel to extract UVW values from.

UV Target

  • Same as source: when enabled, the UVW data will be assigned to the same particle UVW channel it was taken from on the source object.

  • Map Channel: the particle UVW channel to assign the UVW data to.


Mapping From Custom Data Rollout

Assigns mapping values from particle custom data channels.

  • Disabled: mapping from custom data is disabled.

  • Mapping from float: mapping values will be taken from a particle’s custom float data channel.

  • Mapping from vector: mapping values will be taken from a particle’s custom vector data channel.

  • Mapping from target: mapping values will be taken from the target particle.

  • Mapping from target shape mesh: mapping values will be taken from the closest point on the target particle’s shape mesh.

  • Distance/Falloff: the range to the target particle’s shape mesh surface from the particle’s location within which UVW values will be retrieved.

  • Channel: the channel to take the custom data value from.

Normalize Values

  • Enable: controls whether mapping values will be converted into a value between 0 and 1, based on a target value range.

  • Min: the minimum value of the range.

  • Max: the maximum value of the range.

  • Invert: inverts the resulting ratio.

  • UVW Axis X/Y/Z: controls which axis of the particle’s UVW value to assign custom float data values to.

  • Map Channel: controls which particle mapping channel to assign the UVW value to.


Clamp/Shift Values Rollout

Clamp Mapping Values

Allows you to clamp mapping values to specific min/max values.

  • Enable clamping: controls whether clamping will be enabled.

  • X/Y/Z: the min/max x/y/z values to clamp each particle’s UVW values between.

  • All channels: clamping will be applied to all mapping channels.

  • Map channel: the specific mapping channel to apply clamping to.

Shift Mapping Values

Allows you to shift particle mapping values between channels.

  • Disabled: no shift operation will be performed.

  • Copy: particle mapping values will be copied from a source map channel to a target map channel. The source channel value will be retained.

  • Move: particle mapping values will be moved from a source map channel to a target map channel. The source channel value will be removed.

  • Swap: particle mapping values will be swapped between a source map channel and a target map channel.

  • Source channel: the source map channel.

  • Target channel: the target map channel.