mmSolver.tools.triangulatebundle#

Calculate a 3D position of a bundle, based on the camera and 2D marker.

Tools#

Triangulate a 3D Bundle from a 2D Marker.

mmSolver.tools.triangulatebundle.tool.main()#

Triangulate Bundle using camera and Marker.

Usage:

  1. Select markers or bundles (or both).

  2. Run tool.

  3. Bundles are triangulated in TX, TY and TZ.

Library#

Position Bundle under the Marker, using multiple frames.

mmSolver.tools.triangulatebundle.lib.triangulate_bundle(bnd, relock=None, max_distance=None, direction_tolerance=None)#

Triangulate a 3D bundle position.

Deprecated: Please use ‘mmSolver.api.triangulate_bundle()’ instead.

Parameters:

  • bnd (Bundle) – Bundle to be triangulated.

  • relock (bool or None) – If True any bundle translate attributes will be unlocked, changed then relocked.

  • max_distance (float or None) – Defines the maximum distance the bundle can be positioned away from camera until the value is clamped.

  • direction_tolerance (float or None) – Determines the tolerance used to consider if a triangulated point is valid or not. It’s not clear what the units are for this tolerance value. This value is used by OpenMaya.MVector.isEquivalent() and the Maya documentation doesn’t really explain the units. The default value (if not given) is 1.0.

Returns:

True if the bundle successfully triangulated, False if the bundle could not accurately be triangulated. For example if the bundle was computed to behind the camera this would be considered a failure.

Return type:

bool