mmSolver.tools.createlens#

Create a lens on a camera.

Tools#

The Create Lens tool.

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

Create a new lens on the selected camera.

Library#

Library functions for creating and modifying Lenses.

Use Case:

  1. Select a camera.

  2. Add a Lens node to the camera.

    • This will convert the image plane(s) to polygons.

    • This will convert the markers to be undistorted.

  3. Solve the lens distortion.

  4. Select Camera, switch to ‘distorted’ mode.

    • The Markers under the camera are now distorted.

    • When solving a lens node, the lens model is always turned on before solving.

  5. Change the Marker positions however needed.

  6. Solve the lens distortion.

    • Lens distortion is automatically turned on before solving.

mmSolver.tools.createlens.lib.create_marker_connections(cam)#

Create connections between the camera and markers.

Adds a special lens attribute to the camera. This dynamic lens attribute will fan-out and connect to each Marker as needed.

mmSolver.tools.createlens.lib.create_lens_on_camera(cam, force_create_new=None)#

Create a lens node and connect it to the given camera.

Parameters:

  • cam (mmSolver.api.Camera) – The camera to create a lens for.

  • force_create_new (bool or None) – Should the function create a new lens node, even if a node already exists?

Return type:

mmSolver.api.Lens

mmSolver.tools.createlens.lib.add_lens_layer_on_camera(cam)#

Create a new lens node as a ‘layer’ on the the given camera.

Parameters:

cam (mmSolver.api.Camera) – The camera to create a lens for.

Return type:

mmSolver.api.Lens

Constants#

Contains constant values for the Create Lens tool.