SuperTools
==========
Introduction to SuperTools
--------------------------
TBD

Using SuperTools in the NetworkMaterial Node Graph Context
----------------------------------------------------------
In order to allow your SuperTool to be used in the NetworkMaterial Context, and
to expose it in the Node Graph tab's layered menus, you must apply the
context's Node Flavor::

    >>> NodegraphAPI.AddNodeFlavor(<SuperToolTypeName>, NodegraphAPI.Context.NetworkMaterial)

Additionally if your SuperTool should only be used in association with a
particular renderer, you should also add the following Node Flavor::

    >>> NodegraphAPI.AddNodeFlavor(<SuperToolTypeName>, <rendererName>)

If this flavor is added, it will only appear in the Node Graph tab's
layered menu when the renderer set in the context matches that of
the SuperTool.

Alternatively, if your SuperTool can be used with all shading nodes types,
you should add the following Node Flavor::

    >>> NodegraphAPI.AddNodeFlavor(<SuperToolTypeName>, NodegraphAPI.Flavor.Predefined.RendererAgnostic)

.. py:currentmodule:: NodegraphAPI

.. autofunction:: RegisterSuperTool
.. autoclass:: SuperTool