Adverti horiz upsell

ks_mapSpreadInstances 0.1.0 for Maya (maya script)

hair based map spreader for poly surfaces

Button download


  • 2010, 9.x, 2009, 2008, 8.x, 7.x

Operating Systems

  • Linux
  • Windows


Last Modified:04/16/2009
File Size: 22.6 KB

 A basic (rivet inspired) map spreader for arbitrary poly surfaces.

Places maya hair follicles (Maya Unlimed only) where ground objects texture is white or grey (treshold) and none where it is   black. Constraints an instace of teh poly objects to each follicle.

 Ground surface can still be changed (i.e. smoothed) after spreading.

  •  Put ks_mapSpreadInstances.mel in you script directory.
  •  Start the GUI by typing "ks_mapSpreadInstances" in the script editor.


  •  Spreads und constrains instances of a poly objects on a poly ground object.
  •  Ground object UVs must be non-overlapping and in 0-1 range.


 1) Place hair follicles:

 Select ground object. Assign a texture to the color channel of a maya shader (no mentalray shaders supported yet). The black and white values of your texture determinated object density. Choose UV-range and grid density and hit "Place follicles on selected". Repeat until you like the density.

  •  "Treshold" and "Falloff" control the placement of objects in grey areas.
     If "Randomize Placement" is off follicles are set in a regular grid.

 The best way to get random placement is to add several different grid densities   with high random values.


2) Place spread poly objects:

 Select object to spread. Make sure pivot is set correctly.
 Choose to use all follicles (pick object to spread only) or selected only (pick object to spread last). Hit "place geometry".
This will place an instance of the object at follicles in the scene.
  Set the up-axis and random scale and rotation for the spread objects.


To do: still a lot (check if objects intersect, better random placement, handle UVs outside 0 to 1, make Nurbs ground planes work etc)


If you use this for a project please drop me a line.

-home page
-developer blog
-bitbucket repository



Please use the Bug System to report any bugs.
Please use the Feature Requests to give me ideas.
Please use the Support Forum if you have any questions or problems.
Please rate and review in the Review section.

People who favorited this item:

  • toc.toc
  • biggaman
  • rushcg
  • zacharyl