HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Types | Public Member Functions | List of all members
SdrOslParserPlugin Class Reference

#include <oslParser.h>

+ Inheritance diagram for SdrOslParserPlugin:

Public Types

typedef HOSL::OSLQuery::Parameter OslParameter
 

Public Member Functions

SDROSL_API SdrOslParserPlugin ()
 
SDROSL_API ~SdrOslParserPlugin ()
 
SDROSL_API SdrShaderNodeUniquePtr ParseShaderNode (const SdrShaderNodeDiscoveryResult &discoveryResult) override
 
SDROSL_API const SdrTokenVec & GetDiscoveryTypes () const override
 
SDROSL_API const TfToken & GetShadingSystem () const override
 Returns the shading system that this parser operates in. More...
 
- Public Member Functions inherited from SdrParserPlugin
SDR_API SdrParserPlugin ()
 
virtual SDR_API ~SdrParserPlugin ()
 
virtual SDR_API const TfToken & GetSourceType () const
 
- Public Member Functions inherited from TfWeakBase
 TfWeakBase ()
 
 TfWeakBase (const TfWeakBase &)
 
const TfWeakBase & __GetTfWeakBase__ () const
 
const TfWeakBase & operator= (const TfWeakBase &)
 
void EnableNotification2 () const
 
TF_API void const * GetUniqueIdentifier () const
 

Additional Inherited Members

- Static Public Member Functions inherited from SdrParserPlugin
static SDR_API
SdrShaderNodeUniquePtr 		GetInvalidShaderNode (const SdrShaderNodeDiscoveryResult &dr)
 
- Protected Member Functions inherited from TfWeakBase
 ~TfWeakBase ()
 
TfRefPtr< Tf_Remnant > _Register () const
 
template<class T >
TfRefPtr< Tf_Remnant > _Register (T *tempRmnt) const
 
bool _HasRemnant () const
 

Detailed Description

Parses OSL nodes. For more information on parser plugins, see the documentation for SdrParserPlugin.

Metadata Schema

The following metadata is pulled out of the shader and available on the destination as outlined below.

Node Metadata

OSL Metadata Key Destination
category GetCategory()
departments GetDepartments()
help GetHelp()
label GetLabel()
primvars GetPrimvars(), GetAdditionalPrimvarProperties()
_everything else_ GetMetadata()

Property Metadata

OSL Metadata Key Destination
connectable IsConnectable()
sdrDefinitionName renames parameter, sends original osl param name to

| SdrShaderProperty::GetImplementationName() page | GetPage() help | GetHelp() label | GetLabel() isDynamicArray | IsDynamicArray() options | GetOptions() vstructMemberName | GetVStructMemberName() vstructMemberOf | GetVStructMemberOf() everything else | GetMetadata()

Options Format

Multiple options are separated with the pipe '|' character; options can be specified in one of two ways:

  • key1|key2|key3|...
  • key1:value1|key2:value2|...

In the first case, where the values are not specified, the value of the option will be available on the node as an empty string.

Primvar Format

Multiple primvars are separated with the pipe '|' character; primvars can be specified in one of two ways:

  • A string not prefixed with a '$'; this indicates a normal primvar
  • A string prefixed with '$'; the part after the '$' indicates the name of a string-typed input on the node whose value contains additional primvars

Definition at line 94 of file oslParser.h.

Member Typedef Documentation

typedef HOSL::OSLQuery::Parameter SdrOslParserPlugin::OslParameter

Definition at line 97 of file oslParser.h.

Constructor & Destructor Documentation

SDROSL_API SdrOslParserPlugin::SdrOslParserPlugin ( )
SDROSL_API SdrOslParserPlugin::~SdrOslParserPlugin ( )

Member Function Documentation

SDROSL_API const SdrTokenVec& SdrOslParserPlugin::GetDiscoveryTypes ( ) const
overridevirtual

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 SdrShaderNodeDiscoveryResult to its parser plugin; this value is not exposed in the node's API.

Implements SdrParserPlugin.

SDROSL_API const TfToken& SdrOslParserPlugin::GetShadingSystem ( ) const
overridevirtual

Returns the shading system that this parser operates in.

Reimplemented from SdrParserPlugin.

SDROSL_API SdrShaderNodeUniquePtr SdrOslParserPlugin::ParseShaderNode ( const SdrShaderNodeDiscoveryResult &  discoveryResult)
overridevirtual

Takes the specified SdrShaderNodeDiscoveryResult instance, which was a result of the discovery process, and generates a new SdrShaderNode. The node's name, shading system, and function must match.

Implements SdrParserPlugin.

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