Command Evaluation

Context Evaluation context.
run Randomly run weighted commands from a set.
class revl.Context(**kwargs)[source]

Evaluation context.

Each command function needs to define this context as first parameter.

dg

maya.OpenMaya.MDGModifier

DG modifier.

dag

maya.OpenMaya.MDagModifier

DAG modifier.

transforms

list of maya.OpenMaya.MObject

Transform nodes. Provides data for the pickTransform() function.

revl.run(commands, count, seed=None, context=None)[source]

Randomly run weighted commands from a set.

Each command comes with a weight which determines the probabilities for that command to be run.

Use validate() to check if the input command set is well-formed.

Parameters:
  • commands (list of revl.Command or compatible tuple) – Set of weighted commands.
  • count (int) – Total number of commands to be run. Setting a count greater than the number of weighted commands doesn’t guarantee that each command will be run once. Some might be run multiple times instead.
  • seed (object) – Hashable object to define the starting seed of the pseudo-random number generations. If None, the current system time is used. Running multiple times a same set of commands with a same fixed seed that is not None produces identitcal results.
  • context (revl.Context) – Context to use. If None, a new one is created.
Returns:

The context after evaluating the commands.
Return type:

revl.Context

Examples

>>> import revl
>>> commands = [
...     (2.0, revl.createTransform,),
...     (1.0, revl.createPrimitive, (), {'parent': True})
... ]
>>> revl.run(commands, 100, seed=1.23)