Docs - Improve docs for Maya commands.

Author: david-cattermole

docs/source/commands.rst

@@ -1,10 +1,13 @@
 Commands
 ========
 
-Custom commands in `mmSolver` are used to perform many tasks, such as
-solving the scene, modifying the scene, or calculating values.
+mmSolver provides a set of custom Maya commands (MEL / Python) for
+performing solves, querying scene information, processing animation
+curves, working with images, and more. These commands are the
+low-level building blocks that the high-level Python API and tools
+build upon; advanced users can call them directly from scripts.
 
-You can see the nodes split into categories below:
+Commands are split into the following categories:
 
 .. toctree::
     :maxdepth: 4

docs/source/commands_display.rst

@@ -1,10 +1,134 @@
 Display Commands
 ================
 
-*To be written.*
+Display commands control mmSolver's custom Viewport 2.0 renderers.
+Two renderers are provided — MM Standard Renderer and MM Silhouette
+Renderer — each registered as a Viewport 2.0 override and documented
+in detail in :ref:`Viewport Renderers <renderer-ref>`.
 
-``mmRenderer`` Command
-++++++++++++++++++++++
+Each renderer exposes a thin Maya command that forces a refresh of the
+active 3D view. Settings for the Silhouette Renderer are stored on the
+``mmRenderGlobalsSilhouette`` node and adjusted via ``setAttr``.
 
-The ``mmRenderer`` command is unfinished and is disabled in the C++
-build by default.
+
+``mmRendererStandard`` Command
+++++++++++++++++++++++++++++++
+
+``mmRendererStandard`` triggers a forced refresh of the active Viewport
+2.0 panel when the MM Standard Renderer is active. It supports
+``-query`` mode (no flags beyond enabling query are defined). The
+command is not undoable.
+
+See :ref:`renderer-ref` for how to activate and use the MM Standard
+Renderer.
+
+Flags
+-----
+
+The command accepts ``-query`` mode only. No additional flags are
+defined; calling the command refreshes the active view.
+
+Return
+------
+
+Returns nothing.
+
+Example
+-------
+
+Python Example:
+
+.. code:: python
+
+   import maya.cmds
+
+   # Force a refresh of the active view.
+   maya.cmds.mmRendererStandard()
+
+MEL Example:
+
+.. code:: text
+
+   mmRendererStandard;
+
+
+``mmRendererSilhouette`` Command
++++++++++++++++++++++++++++++++++
+
+``mmRendererSilhouette`` triggers a forced refresh of the active
+Viewport 2.0 panel when the MM Silhouette Renderer is active. It
+supports ``-query`` mode (no flags beyond enabling query are defined).
+The command is not undoable.
+
+The silhouette effect is configured through the
+``mmRenderGlobalsSilhouette`` node, which is created automatically when
+the renderer is first activated. Use ``setAttr`` to change the
+settings described below.
+
+See :ref:`renderer-silhouette-ref` for full usage instructions and a
+description of each setting.
+
+Flags
+-----
+
+The command accepts ``-query`` mode only. No additional flags are
+defined; calling the command refreshes the active view.
+
+``mmRenderGlobalsSilhouette`` Node Attributes
+---------------------------------------------
+
+The silhouette settings live on the ``mmRenderGlobalsSilhouette`` node.
+
+======================== ========= =============== =========================================================
+Attribute                Type      Default         Description
+======================== ========= =============== =========================================================
+``enable``               bool      ``true``        Toggle the silhouette effect on or off.
+``overrideColor``        bool      ``true``        Use the ``color`` attribute for all objects.
+``depthOffset``          float     ``-1.0``        Depth separation between solid and wireframe geometry.
+``width``                float     ``2.0``         Width of silhouette lines.
+``color``                float3    ``0, 1, 0``     Silhouette line colour (green by default).
+``alpha``                float     ``1.0``         Opacity of silhouette lines.
+``cullFace``             enum      ``Back``        Back-face culling; ``Back``, ``Front``, ``FrontAndBack``.
+``operationNum``         uint8     ``255`` (all)   Limit rendering to the first N operations (debug).
+======================== ========= =============== =========================================================
+
+Return
+------
+
+Returns nothing.
+
+Example
+-------
+
+Python Example:
+
+.. code:: python
+
+   import maya.cmds
+
+   # Force a refresh of the active view.
+   maya.cmds.mmRendererSilhouette()
+
+   # Change the silhouette colour to red.
+   maya.cmds.setAttr('mmRenderGlobalsSilhouette.color', 1, 0, 0, type='double3')
+
+   # Increase line width.
+   maya.cmds.setAttr('mmRenderGlobalsSilhouette.width', 3.0)
+
+   # Disable the effect temporarily.
+   maya.cmds.setAttr('mmRenderGlobalsSilhouette.enable', False)
+
+MEL Example:
+
+.. code:: text
+
+   mmRendererSilhouette;
+
+   // Change silhouette colour to red.
+   setAttr mmRenderGlobalsSilhouette.color -type double3 1 0 0;
+
+   // Increase line width.
+   setAttr mmRenderGlobalsSilhouette.width 3.0;
+
+   // Disable the effect temporarily.
+   setAttr mmRenderGlobalsSilhouette.enable false;