mgear.core.icon

Predefined nurbsCurve shapes to be use as a rigging control Icons

mgear.core.icon.arrow(parent=None, name=’arrow’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a ARROW shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.axis(parent=None, name=’axis’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a AXIS shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.circle(parent=None, name=’circle’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None, degree=3)

Create a curve with a CIRCLE shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.compas(parent=None, name=’compas’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None, degree=3)

Create a curve with a COMPAS shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.connection_display_curve(name, centers=[], degree=1)

Visual reference curves connectiong points.

Display curve object is a simple curve to show the connection between different guide element..

Parameters:
  • name (str) – Local name of the element.
  • centers (list of dagNode) – List of object to define the curve.
  • degree (int) – Curve degree. Default 1 = lineal.
Returns:

The newly creted curve.

Return type:

dagNode

mgear.core.icon.create(parent=None, name=’icon’, m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), color=[0, 0, 0], icon=’cube’, **kwargs)

Icon master function

Create icon master function. This function centralize all the icons creation

Parameters:
  • parent (dagNode) – The parent for the new icon
  • name (str) – Name of the Icon.
  • m (matrix) – Transformation matrix of the icon
  • color (int or list of float) – The color in index base or RGB.
  • icon (str) –

    Icon type. Options: “cube”, “pyramid”, “square”, “flower”, “circle”, “cylinder”, “compas”, “diamond”,

    ”cubewithpeak”, “sphere”, “arrow”, “crossarrow”, “cross”, “null”
  • kwargs – The keyword arguments can vary depending of the icon type. Please refear to the specific icon method for more info.
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.cross(parent=None, name=’cross’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a CROSS shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.crossarrow(parent=None, name=’crossArrow’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a CROSS ARROW shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.cube(parent=None, name=’cube’, width=1, height=1, depth=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a CUBE shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • height (float) – Height of the shape.
  • depth (float) – Depth of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.cubewithpeak(parent=None, name=’cubewithpeak’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a CUBE WITH PEAK shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.cylinder(parent=None, name=’cylinder’, width=1, heigth=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None, degree=3)

Create a curve with a CYLINDER shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • height (float) – Height of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.diamond(parent=None, name=’diamond’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a DIAMOND shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • height (float) – Height of the shape.
  • depth (float) – Depth of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.flower(parent=None, name=’flower’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None, degree=3)

Create a curve with a FLOWER shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.getPointArrayWithOffset(point_pos, pos_offset=None, rot_offset=None)

Get Point array with offset

Convert a list of vector to a List of float and add the position and rotation offset.

Parameters:
  • point_pos (list of vector) – Point positions.
  • pos_offset (vector) – The position offset of the curve from its center.
  • rot_offset (vector) – The rotation offset of the curve from its center. In radians.
Returns:

the new point positions

Return type:

list of vector

mgear.core.icon.guideBladeIcon(parent=None, name=’blade’, lenX=1.0, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a BLADE GUIDE shape.

Note

This icon is specially design for Shifter blade guides

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • lenX (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.guideLocatorIcon(parent=None, name=’locator’, width=0.5, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a LOCATOR GUIDE shape.

Note

This icon is specially design for Shifter locator guides

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.guideRootIcon(parent=None, name=’root’, width=0.5, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a ROOT GUIDE shape.

Note

This icon is specially design for Shifter root guides

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.null(parent=None, name=’null’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a NULL shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.pyramid(parent=None, name=’pyramid’, width=1, height=1, depth=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a PYRAMIDE shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • height (float) – Height of the shape.
  • depth (float) – Depth of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.setcolor(node, color)

Set the color in the Icons.

Parameters:
  • node (dagNode) – The object
  • color (int or list of float) – The color in index base or RGB.
mgear.core.icon.sphere(parent=None, name=’sphere’, width=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None, degree=3)

Create a curve with a SPHERE shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode

mgear.core.icon.square(parent=None, name=’square’, width=1, depth=1, color=[0, 0, 0], m=Matrix([[1.0, 0.0, 0.0, 0.0], [0.0, 1.0, 0.0, 0.0], [0.0, 0.0, 1.0, 0.0], [0.0, 0.0, 0.0, 1.0]]), pos_offset=None, rot_offset=None)

Create a curve with a SQUARE shape.

Parameters:
  • parent (dagNode) – The parent object of the newly created curve.
  • name (str) – Name of the curve.
  • width (float) – Width of the shape.
  • depth (float) – Depth of the shape.
  • color (int or list of float) – The color in index base or RGB.
  • m (matrix) – The global transformation of the curve.
  • pos_offset (vector) – The xyz position offset of the curve from its center.
  • rot_offset (vector) – The xyz rotation offset of the curve from its center. xyz in radians
Returns:

The newly created icon.

Return type:

dagNode