OMC::Deformation Class Reference

Detailed Description

Provides a wrapper for a deformation applied by a node.

Deformations applied by a node are provided via the transformation of the outport of that node. This deformation is propagated downwards to all attached nodes. This wrapper allows one to transform a point based on the transformation applied by the deformation module.

With a Curve Deformation, Apply the equivalent transform to a peg at its pivot's position

from ToonBoom import harmony
sess = harmony.session()
proj = sess.project
scene = proj.scene
top = scene.top



#Disconnected node, we'll apply a transform to match an unrelated deformer.
at_frame = 1
disconnected_peg = scene.nodes["Top/Peg"]
disconnected_peg_piv = disconnected_peg.pivot(at_frame)
disconnected_peg_piv = scene.unit_converter.to_ogl(disconnected_peg_piv)


#The Deformation is propagated by the outport of a deformation node.
curveNode = scene.nodes["Top/Deformation-Drawing/Curve"]
curvePort = curveNode.ports_out[0]


#Get the overall transformation applied by the curve.
curveTransform = curvePort.transformation(at_frame)


#Check to see if the transformation offers a deformartion.
if curveTransform.deformation_valid:
  deform = curveTransform.deformation
  #Transform a point by the provided deformation.
  result = deform.transform( disconnected_peg_piv )
  delta_matrix = harmony.Matrix()
  delta_matrix.translate( [result.x - disconnected_peg_piv.x, result.y - disconnected_peg_piv.y] )
  disconnected_peg.set_matrix( 1, delta_matrix )

Public Member Functions
OMC::Point3d *	transform (const OMC::Point3d *point_to_deform, bool drawing_units=false)
	Deforms the point provided with the deformation. More...

Member Function Documentation

transform()

OMC::Point3d* OMC::Deformation::transform	(	const OMC::Point3d *	point_to_deform,
		bool	drawing_units = false
	)

Deforms the point provided with the deformation.

Deforms the provided point with the deformation system, returning the resulting point. The point provided should be in OGL units when drawing_units is false. If drawing_units is set to true, the deformation is applied in the drawing units and the conversion is ignored.

Returns

Returns the modified point.

Inheritance diagram for OMC::Deformation:

Collaboration diagram for OMC::Deformation: