This document is for a version of USD that is under development. See this page for the current release.
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
NdrParserPlugin Class Referenceabstract

Interface for parser plugins. More...

#include <parserPlugin.h>

+ Inheritance diagram for NdrParserPlugin:

Public Member Functions

virtual NDR_API NdrNodeUniquePtr Parse (const NdrNodeDiscoveryResult &discoveryResult)=0
 Takes the specified NdrNodeDiscoveryResult instance, which was a result of the discovery process, and generates a new NdrNode.
 
virtual NDR_API const NdrTokenVec & GetDiscoveryTypes () const =0
 Returns the types of nodes that this plugin can parse.
 
virtual NDR_API const TfTokenGetSourceType () const =0
 Returns the source type that this parser operates on.
 
- Public Member Functions inherited from TfWeakBase
 TfWeakBase (const TfWeakBase &)
 
const TfWeakBase__GetTfWeakBase__ () const
 
const TfWeakBaseoperator= (const TfWeakBase &)
 
void EnableNotification2 () const
 
TF_API void const * GetUniqueIdentifier () const
 

Static Public Member Functions

static NDR_API NdrNodeUniquePtr GetInvalidNode (const NdrNodeDiscoveryResult &dr)
 Gets an invalid node based on the discovery result provided.
 

Additional Inherited Members

- Protected Member Functions inherited from TfWeakBase
TfRefPtr< Tf_Remnant > _Register () const
 
template<class T >
TfRefPtr< Tf_Remnant > _Register (T *tempRmnt) const
 
bool _HasRemnant () const
 

Detailed Description

Interface for parser plugins.

Parser plugins take a NdrNodeDiscoveryResult from the discovery process and creates a full NdrNode instance (or, in the case of a real-world scenario, a specialized node that derives from NdrNode). The parser that is selected to run is ultimately decided by the registry, and depends on the NdrNodeDiscoveryResult's discoveryType member. A parser plugin's GetDiscoveryTypes() method is how this link is made. If a discovery result has a discoveryType of 'foo', and SomeParserPlugin has 'foo' included in its GetDiscoveryTypes() return value, SomeParserPlugin will parse that discovery result.

Another kind of 'type' within the parser plugin is the 'source type'. The discovery type simply acts as a way to link a discovery result to a parser plugin. On the other hand, a 'source type' acts as an umbrella type that groups all of the discovery types together. For example, if a plugin handled discovery types 'foo', 'bar', and 'baz' (which are all related because they are all handled by the same parser), they may all be grouped under one unifying source type. This type is available on the node via NdrNode::GetSourceType().

How to Create a Discovery Plugin

There are three steps to creating a parser plugin:

  • Implement the parser plugin interface. An example parser plugin is available in the plugin folder under sdrOsl. The Parse() method should return the specialized node that derives from NdrNode (and this node should also be constructed with its specialized properties). Examples of a specialized node and property class are SdrShaderNode and SdrShaderProperty.
  • Register your new plugin with the registry. The registration macro must be called in your plugin's implementation file:
    NDR_REGISTER_PARSER_PLUGIN(<YOUR_PARSER_PLUGIN_CLASS_NAME>)
    #define NDR_REGISTER_PARSER_PLUGIN(ParserPluginClass)
    Register a parser plugin with the plugin system.
    Definition: parserPlugin.h:26
    This macro is available in parserPlugin.h.
  • In the same folder as your plugin, create a plugInfo.json file. This file must be formatted like so, substituting YOUR_LIBRARY_NAME, YOUR_CLASS_NAME, and YOUR_DISPLAY_NAME:

    {
    "Plugins": [{
    "Type": "library",
    "Name": "YOUR_LIBRARY_NAME",
    "Root": "@PLUG_INFO_ROOT@",
    "LibraryPath": "@PLUG_INFO_LIBRARY_PATH@",
    "ResourcePath": "@PLUG_INFO_RESOURCE_PATH@",
    "Info": {
    "Types": {
    "YOUR_CLASS_NAME" : {
    "bases": ["NdrParserPlugin"],
    "displayName": "YOUR_DISPLAY_NAME"
    }
    }
    }
    }]
    }

    The SDR ships with one parser plugin, the SdrOslParserPlugin. Take a look at its plugInfo.json file for example values for YOUR_LIBRARY_NAME, YOUR_CLASS_NAME, and YOUR_DISPLAY_NAME. If multiple parser plugins exist in the same folder, you can continue adding additional plugins under the Types key in the JSON. More detailed information about the plugInfo.json format can be found in the documentation for the plug library (in pxr/base).

Definition at line 108 of file parserPlugin.h.

Member Function Documentation

◆ GetDiscoveryTypes()

virtual NDR_API const NdrTokenVec & GetDiscoveryTypes ( ) const
pure virtual

Returns the types of nodes that this plugin can parse.

"Type" here is the discovery type (in the case of files, this will probably be the file extension, but in other systems will be data that can be determined during discovery). This type should only be used to match up a NdrNodeDiscoveryResult to its parser plugin; this value is not exposed in the node's API.

Implemented in UsdShadeShaderDefParserPlugin.

◆ GetInvalidNode()

static NDR_API NdrNodeUniquePtr GetInvalidNode ( const NdrNodeDiscoveryResult dr)
static

Gets an invalid node based on the discovery result provided.

An invalid node is a node that has no properties, but may have basic data found during discovery.

◆ GetSourceType()

virtual NDR_API const TfToken & GetSourceType ( ) const
pure virtual

Returns the source type that this parser operates on.

A source type is the most general type for a node. The parser plugin is responsible for parsing all discovery results that have the types declared under GetDiscoveryTypes(), and those types are collectively identified as one "source type".

Implemented in UsdShadeShaderDefParserPlugin.

◆ Parse()

virtual NDR_API NdrNodeUniquePtr Parse ( const NdrNodeDiscoveryResult discoveryResult)
pure virtual

Takes the specified NdrNodeDiscoveryResult instance, which was a result of the discovery process, and generates a new NdrNode.

The node's name, source type, and family must match.

Implemented in UsdShadeShaderDefParserPlugin.


The documentation for this class was generated from the following file: