Mushroomer - Revision history

Josh: /* Known Issues */ bugfix by campbell in trunk means material animation works again!

2010-09-10T15:47:24Z

Known Issues: bugfix by campbell in trunk means material animation works again!

Josh: New public release of the mushroomer

2010-09-10T15:41:02Z

New public release of the mushroomer

Josh: /* Status & Version History */

2010-09-10T13:45:05Z

Status & Version History

Josh: /* Status & Version History */

2010-09-10T13:43:43Z

Status & Version History

Josh: /* Parameters */

2010-09-03T20:14:32Z

Parameters

Josh: /* Original Mushroom Prerequisites */

2010-09-03T19:49:45Z

Original Mushroom Prerequisites

Josh: /* Original Mushroom Prerequisites */

2010-09-03T19:48:23Z

Original Mushroom Prerequisites

Josh: /* Parameters */

2010-09-03T19:44:58Z

Parameters

Josh: /* Demonstrations */

2010-09-03T19:08:52Z

Demonstrations

Josh: /* Status & Version History */

2010-09-03T19:08:05Z

Status & Version History

← Older revision		Revision as of 15:47, 10 September 2010
Line 160:		Line 160:
	* Blender Limitation: It is currently not possible to merge two actions into one. This is necessary if you are moving mesh level and material level animation data back to object level.		* Blender Limitation: It is currently not possible to merge two actions into one. This is necessary if you are moving mesh level and material level animation data back to object level.
	* Blender Limitation: It is not possible to copy an fcurve in its entirity, but rather python has to iterate through very slowly copying every handle one by one, and even this is susceptible to some bugs (not yet reported). This is because the collection of fcurves is read only even though each fcurve itself if read/write.		* Blender Limitation: It is not possible to copy an fcurve in its entirity, but rather python has to iterate through very slowly copying every handle one by one, and even this is susceptible to some bugs (not yet reported). This is because the collection of fcurves is read only even though each fcurve itself if read/write.
−	* Blender Bug #23593 and #23594: The script has the ability to handle material animation as well as shape key animation. This functionality is currently disabled (by commenting lines) due to blender's instability.

@@ Line 2: / Line 2: @@
 *[http://vimeo.com/14613119 Demonstration Video] by Josh Wedlake and Henri Hebeisen
-*[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroom_test_release3.blend Demonstration Blend File] updated for release 3
+*[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroom_test_release4.blend Demonstration Blend File] updated for release 4
 == Purpose ==
@@ Line 13: / Line 13: @@
 Development from the wider blender community is welcomed and encouraged.  Please add (do not remove) any GPL licensed branches you create based on the Mushroomer below, and note the blender revision which the script runs on:
 *[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release3.zip Tube Trunk Mushroomer release 3], known to work with Python 3.1.2 on Blender r31744, confirmed broken in r31838
 *[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release2.zip Tube Trunk Mushroomer release 2], known to work with Python 3.1.2 on Blender r31726, confirmed broken in r31742

@@ Line 14: / Line 14: @@
 Development from the wider blender community is welcomed and encouraged.  Please add (do not remove) any GPL licensed branches you create based on the Mushroomer below, and note the blender revision which the script runs on:
 *[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release3.zip Tube Trunk Mushroomer release 3], known to work with Python 3.1.2 on Blender r31744, confirmed broken in r31838
-*[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release2.zip Tube Trunk Mushroomer release 2], known to work with Python 3.1.2 on Blender r31726
+*[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release2.zip Tube Trunk Mushroomer release 2], known to work with Python 3.1.2 on Blender r31726, confirmed broken in r31742
 *[http://www.pasteall.org/15382/python Tube Trunk Mushroomer release 1], known to work with Python 3.1.2 on Blender r31675, confirmed broken in r31726

@@ Line 13: / Line 13: @@
 Development from the wider blender community is welcomed and encouraged.  Please add (do not remove) any GPL licensed branches you create based on the Mushroomer below, and note the blender revision which the script runs on:
-*[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release3.zip Tube Trunk Mushroomer release 3], known to work with Python 3.1.2 on Blender r31744
+*[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release3.zip Tube Trunk Mushroomer release 3], known to work with Python 3.1.2 on Blender r31744, confirmed broken in r31838
 *[http://tube.freefac.org/wp/wp-content/uploads/2010/10/mushroomer_release2.zip Tube Trunk Mushroomer release 2], known to work with Python 3.1.2 on Blender r31726
 *[http://www.pasteall.org/15382/python Tube Trunk Mushroomer release 1], known to work with Python 3.1.2 on Blender r31675, confirmed broken in r31726

@@ Line 146: / Line 146: @@
 **If the prefix of a lifecycle shape set is chosen followed by the text "[NOT ALWAYS AVAILABLE]" this indicates that the prefix has '''not been found''' on all of the original mushrooms and as a result, mushroom instances duplicated from original mushrooms which do not have the selected shape key set '''will not receive animation'''.
-*Random Shape Set:
+*Random Shape Set: This dropdown contains a list of the valid shape key sets (see Original Mushroom Prerequisites) which can be used to add random variation to the mushroom instances.  It also contains the option "Don't Use" which disables this feature.  If a shape key set is selected, the script will pick a random shape key from the set and smoothly animate a random variation shape's value from 0 to 1 to 0 over the course of the lifecycle animation.
-*Bend Upwards Shape Set:
+*Bend Upwards Shape Set: This dropdown contains a list of the valid shape key sets (see Original Mushroom Prerequisites) which can be used to add an upwards bend to the mushroom instances.  It also contains the option "Don't Use" which disables this feature.  If a shape key set is selected, the script will pick a random shape key from the set and add a driver which increases the value of the shape as the mushroom instance is tilted away from the vertical.  The driver includes a gaussian distribution multiplier which approximately adjusts the shape's maximum possible value from 0 to 1 to 0 over the course of the lifecycle animation.
-*Vertex Group for Shrinkwrap:
+*Vertex Group for Shrinkwrap: This vertex group will be passed to the shrinkwrap modifier which is added to each mushroom instance.  If "(Do not use shrinkwrapping)" is selected, shrinkwrap modifiers will not be added to the mushroom instances.
 == Known Issues ==

@@ Line 49: / Line 49: @@
 *OB: 'flower', Shapes: 'life1','life10','life15','random6','random8','bend1'
 *OB: 'robot_arm', Shapes: 'life0','life100','life200','random6754'
-**Note: in this case there is no 'bend...' shape on 'robot_arm'.  The script will warn the user with the text '''"[NOT ALWAYS AVAILABLE]"''' in the UI dropdown.  '''If the user selects 'bend...' there will be no animation on mushroom instances duplicated from original mushrooms which do not have shape keys prefixed by 'bend'.'''
+**Note: in this case there is no 'bend...' shape on 'robot_arm'.  The script will warn the user with the text '''"[NOT ALWAYS AVAILABLE]"''' in the UI dropdown.  '''If the user selects 'bend...' the script will not be able to create animation, drivers or variation on mushroom instances duplicated from original mushrooms which do not have shape keys prefixed by 'bend'.'''
 Optionally the script can add a modifier to each mushroom instance to shrinkwrap the base (or any vertices you wish) to the target object.  To use this feature you need to weight paint a vertex group in each mushroom object.  This vertex group can then be selected in the script's UI.  It can be named whatever you want.

← Older revision		Revision as of 19:44, 3 September 2010
Line 135:		Line 135:

	*Family Wipeout Chance: The chance that any given fork will die out. Evaluated at each generation.		*Family Wipeout Chance: The chance that any given fork will die out. Evaluated at each generation.
		+
		+	'''Shape Key Settings'''
		+
		+	Shape key settings are vital for the script to be able to create meaningful animation. They are the one part of the script's UI which should not be left at their default values unless the user is certain the default is correct. The drop down boxes also display important warnings to the user, such as if a prefix could not be found on all of the original mushrooms. Although the script will run, it is not usually useful to provide it with both ''original mushrooms with pre-animation'' and ''original mushrooms with sequentially named shape keys'', as at least one type of mushroom instance will end up with no animation data.
		+
		+	*Animation: Manual/Lifecycle Shape Set: This dropdown contains a list of the valid shape key sets (see Original Mushroom Prerequisites) which can be used for auto-animation. It also contains the options "Don't Use" and "Duplicate and retime pre-existing animations".
		+	**If "Don't Use" is selected the script will generate neither automated nor retimed manual animation lifecycle animation on the mushroom instances. The mushrooms will only be placed.
		+	**If "Duplicate and retime pre-existing animations" is selected, any animation data on the shape keys from frames 1-100 will be retimed on the mushroom instances (scaled on the time axis and jittered). Choose this option if you have already animated all of your original mushrooms on frames 1-100.
		+	**If the prefix of a lifecycle shape set is chosen followed by the text "[available on all mushrooms]" this indicates that the prefix has been successfully found on all of the original mushrooms and as a result all mushroom instances will receive autogenerated animation using this set of shape keys.
		+	**If the prefix of a lifecycle shape set is chosen followed by the text "[NOT ALWAYS AVAILABLE]" this indicates that the prefix has '''not been found''' on all of the original mushrooms and as a result, mushroom instances duplicated from original mushrooms which do not have the selected shape key set '''will not receive animation'''.
		+
		+	*Random Shape Set:
		+
		+	*Bend Upwards Shape Set:
		+
		+	*Vertex Group for Shrinkwrap:

	== Known Issues ==		== Known Issues ==