Skip to content

mayaMatchMoveSolver-v0.4.0.alpha6

Pre-release
Pre-release

Choose a tag to compare

@david-cattermole david-cattermole released this 22 May 09:30
· 1940 commits to develop since this release

DO NOT USE THIS IN PRODUCTION!!!
This version of mmSolver is for testing only!

This is a feature incomplete and buggy release of the upcoming v0.4.0 release of mmSolver.

The alpha 6 release focuses on usability of various tools and features in mmSolver, including the mmSolver image plane (mmImagePlane), the "MM Scene Graph", the "Camera Context Menu", and other improvements and fixes (see below).


Load mmSolver in Maya 2022

To load mmSolver on Maya 2022 you must run the following MEL command:

mmsolver_load

This will load the mmSolver plug-in, and allow you to automatically load the mmSolver plug-in and will ensure it is loaded each time Maya is started.

If you wish to unload mmSolver so it will not be loaded at Maya start-up run the following MEL command:

mmsolver_unload

These new commands were added to work-around the new Maya 2022+ Security preferences and ensure mmSolver will be loaded when it's needed.

Additionally the Python module mmSolver.startup was added, and allows pipelines to manually load mmSolver with the Python commands:

import mmSolver.startup
mmSolver.startup.mmsolver_startup()

Features / Changes

The main changes in this release:

  • (#173) mmImagePlane
    • Add first frame attribute to control frame offset.
    • Image frame cache uses a minimum size of 99.
    • Add exposure, gamma, color gain, and alpha gain attributes to control the image color correction.
    • Add 'image load enable' attribute to disable loading images.
    • Add 'camera size' HUD to image plane.
    • Add Visible in Camera Only checkbox, to force the image plane to hide when not looking through the camera.
    • Performance improvement to stop image plane triggering refresh when it`s not needed.
    • Fix bug when more than one image plane is created.
    • Add multiple image sequence attribute 'slots' to allow proxy images to be switched between quickly.
    • Default image plane depth is now much farther from camera by default.
    • General usability improvements.
  • Solver UI
    • Fix Per-Marker and Span-Frames not being 'remembered' when re-opening the UI.
    • Detects when the mmSceneGraph cannot be used and errors before a solve can start.
  • Improve 'Camera Context Menu' usability.
    • Rename Node Context Menu to Camera Context Menu.
    • Add icon to Camera Context Menu.
  • MM Lines can now be subdivided to any level of detail and subdivision uses the user's Marker selection for selective refinement.
  • 'Camera Calibration' tool-set now uses mmImagePlane (not Maya image plane)
  • (#241) Fix 'unlink bundle from Marker' when called more than once.
  • Add new node types to 'Remove Solver Nodes' tool.
  • Fix unparenting of objects when the object has no keyframes (mmSolver > General Tools > Unparent to World tool).
  • Fix build/install issue with cminpack library symlink (Linux only).

Developer (low-level) changes:

  • Add mmSolver.api.filter_image_plane_nodes() function.
  • Add mmSolverSceneGraph command to detect an invalid scene graph with the use of mmSceneGraph.
  • Add mmLensEvaluate hash output value.
    • Used to uniquely define when lens distortion is unique or has changed.
  • Printing the same messages to the viewport is reduced to avoid spamming the user and slowing down the Maya refresh-rate.
  • Add mmSolver.utils.imageseq module to evaluate image sequences.
  • Add mmImagePlanes to mmSolver.api.get_object_type() function.
  • Add lenses to mmSolver.api.get_object_type() function.
  • Upgrade Lens Distortion Plug-in Kit from v2.4 to v2.7 - no visible changes will occur to users.

Known Problems

  • The Solver acts strangely and doesn't solve correctly when the camera's "Film Fit" is set to anything other than "Horizontal".
  • Compatibility with Maya scenes with mmSolver v0.3.x nodes may not work as expected - please report issues.
  • The Viewport 2 "MM Renderer"
    • Aliasing problems and does not allow changing the "mode" of the viewport.
    • The mmImagePlaneShape does not work the same as Maya native image planes with the useBackground/hold out options in Viewport 2.0.
  • Marker shape nodes change size when the marker depth or camera focal length is adjusted.

Please report any bugs or suggestions you find in this release here and clearly state the version of mmSolver you are testing.