zBuilder.builders package

Submodules

zBuilder.builders.attributes module

class zBuilder.builders.attributes.Attributes

Bases: zBuilder.builder.Builder

Storing maya attributes

build(*args, **kwargs)

retrieve_from_scene(*args, **kwargs)

zBuilder.builders.constraints module

class zBuilder.builders.constraints.Constraints

Bases: zBuilder.builder.Builder

To capture Maya constraints. Supports point, orient and parent constraints.

build(*args, **kwargs)

retrieve_from_scene(*args, **kwargs)

zBuilder.builders.deltaMush module

class zBuilder.builders.deltaMush.DeltaMush

Bases: zBuilder.builder.Builder

To capture a deltaMush

build(*args, **kwargs)

retrieve_from_scene(*args, **kwargs)

zBuilder.builders.selection module

class zBuilder.builders.selection.Selection

Bases: zBuilder.builder.Builder

Storing maya selection.

build(*args, **kwargs)

retrieve_from_scene(*args, **kwargs)

zBuilder.builders.skinClusters module

class zBuilder.builders.skinClusters.SkinCluster

Bases: zBuilder.builder.Builder

Capturing Maya skinClusters

build(*args, **kwargs)

retrieve_from_scene(*args, **kwargs)

zBuilder.builders.ziva module

class zBuilder.builders.ziva.Ziva

Bases: zBuilder.builder.Builder

To capture a Ziva rig.

build(*args, **kwargs)

This builds the Ziva rig into the Maya scene. It does not build geometry as the expectation is that the geometry is in the scene.

Parameters:

• solver (bool) – Build the solver.
• bones (bool) – Build the bones.
• tissues (bool) – Build the tissue and tets.
• attachments (bool) – Build the attachments.
• materials (bool) – Build the materials.
• fibers (bool) – Build the fibers.
• embedder (bool) – Build the embedder.
• cloth (bool) – Build the cloth.
• lineOfActions (bool) – Build the line of actions.
• interp_maps (str) – Option to interpolate maps. True: Yes interpolate False: No auto: Interpolate if it needs it (vert check)
• mirror (bool) – This mirrors the geometry in bundle.
• permissive (bool) – False raises errors if something is wrong. Defaults to True
• attr_filter (dict) –

  Attribute filter on what attributes to get. dictionary is key value where key is node type and value is list of attributes to use.

  tmp = {‘zSolver’:[‘substeps’]}

• association_filter (str) – filter by node association. Defaults to list()

get_parent()

reset_solvers()

This resets the solvers stored in the zBuilder. Specifically, it removes any stored MObjects from the solvers.

retrieve_from_scene(*args, **kwargs)

This gets the scene items from the scene for further manipulation or saving. It works on selection or something passed in args. If nothing is selected it looks for a zSolver in the scene. If something is selected or passed it uses that specific solver to retrieve.

Items captured in this case are:

• All the Ziva nodes. (zTissue, zTet, zAttachment, etc..)
• Order of the nodes so we can re-create material layers reliably.
• Attributes and values of the nodes. (Including weight maps)
• Sub-tissue information.
• User defined tet mesh reference. (Not the actual mesh)
• Any embedded mesh reference. (Not the actual mesh)
• Curve reference to drive zLineOfAction. (Not actual curve)
• Relevant zSolver for each node.
• Mesh information used for world space lookup to interpolate maps if needed.

Parameters:get_parameters (bool) – To get parameters or not.

retrieve_from_scene_selection(*args, **kwargs)

Gets scene items based on selection.

Parameters:

• attr_filter (dict) –

  Attribute filter on what attributes to get. dictionary is key value where key is node type and value is list of attributes to use.

  af = {‘zSolver’:[‘substeps’]}

• connections (bool) – Gets the ziva nodes connected to selection as well. Defaults to True
• solver (bool) – Gets solver data. Defaults to True
• bones (bool) – Gets bone data. Defaults to True
• tissue (bool) – Gets tissue data. Defaults to True
• attachments (bool) – Gets attachments data. Defaults to True
• materials (bool) – Gets materials data. Defaults to True
• fibers (bool) – Gets fibers data. Defaults to True
• cloth (bool) – Gets cloth data. Defaults to True
• lineOfAction (bool) – Gets line of action data. Defaults to True
• embedder (bool) – Gets embedder data. Defaults to True
• get_parameters (bool) – get mesh info. Defaults to True

Module contents