Blender V4.3
Public Member Functions | Public Attributes | List of all members
ShaderNode Class Referenceabstract

#include <shader_graph.h>

Inherits Node.

Inherited by AddClosureNode, AmbientOcclusionNode, AttributeNode, BackgroundNode, BevelNode, BlackbodyNode, BrightContrastNode, BsdfBaseNode, BumpNode, CameraNode, ClampNode, ColorNode, CombineColorNode, CombineHSVNode, CombineRGBNode, CombineXYZNode, ConvertNode, CurvesNode, DisplacementNode, EmissionNode, FloatCurveNode, FresnelNode, GammaNode, GeometryNode, HSVNode, HairInfoNode, HoldoutNode, InvertNode, LayerWeightNode, LightFalloffNode, LightPathNode, MapRangeNode, MappingNode, MathNode, MixClosureNode, MixClosureWeightNode, MixColorNode, MixFloatNode, MixNode, MixVectorNode, MixVectorNonUniformNode, NormalMapNode, NormalNode, OSLNode, ObjectInfoNode, OutputAOVNode, OutputNode, ParticleInfoNode, PointDensityTextureNode, PointInfoNode, RGBRampNode, RGBToBWNode, SeparateColorNode, SeparateHSVNode, SeparateRGBNode, SeparateXYZNode, SetNormalNode, TangentNode, TextureCoordinateNode, TextureNode, UVMapNode, ValueNode, VectorDisplacementNode, VectorMapRangeNode, VectorMathNode, VectorRotateNode, VectorTransformNode, VertexColorNode, VolumeInfoNode, VolumeNode, WavelengthNode, WhiteNoiseTextureNode, and WireframeNode.

Public Member Functions

 ShaderNode (const NodeType *type)
virtual ~ShaderNode ()
void create_inputs_outputs (const NodeType *type)
void remove_input (ShaderInput *input)
ShaderInput * input (const char *name)
ShaderOutput * output (const char *name)
ShaderInput * input (ustring name)
ShaderOutput * output (ustring name)
virtual ShaderNode * clone (ShaderGraph *graph) const =0
virtual void attributes (Shader *shader, AttributeRequestSet *attributes)
virtual void compile (SVMCompiler &compiler)=0
virtual void compile (OSLCompiler &compiler)=0
virtual void expand (ShaderGraph *)
virtual void constant_fold (const ConstantFolder &)
virtual void simplify_settings (Scene *)
virtual bool has_surface_emission ()
virtual bool has_surface_transparent ()
virtual bool has_surface_bssrdf ()
virtual bool has_bump ()
virtual bool has_bssrdf_bump ()
virtual bool has_spatial_varying ()
virtual bool has_attribute_dependency ()
virtual bool has_volume_support ()
virtual int get_feature ()
virtual ClosureType get_closure_type ()
virtual bool equals (const ShaderNode &other)
Public Member Functions inherited from Node
 Node (const NodeType *type, ustring name=ustring())
virtual ~Node ()=0
void set (const SocketType &input, bool value)
void set (const SocketType &input, int value)
void set (const SocketType &input, uint value)
void set (const SocketType &input, uint64_t value)
void set (const SocketType &input, float value)
void set (const SocketType &input, float2 value)
void set (const SocketType &input, float3 value)
void set (const SocketType &input, const char *value)
void set (const SocketType &input, ustring value)
void set (const SocketType &input, const Transform &value)
void set (const SocketType &input, Node *value)
template<class ValueType, std::enable_if_t< std::is_enum_v< ValueType >, bool > = true>
void set (const SocketType &input, const ValueType &value)
void set (const SocketType &input, array< bool > &value)
void set (const SocketType &input, array< int > &value)
void set (const SocketType &input, array< float > &value)
void set (const SocketType &input, array< float2 > &value)
void set (const SocketType &input, array< float3 > &value)
void set (const SocketType &input, array< ustring > &value)
void set (const SocketType &input, array< Transform > &value)
void set (const SocketType &input, array< Node * > &value)
bool get_bool (const SocketType &input) const
int get_int (const SocketType &input) const
uint get_uint (const SocketType &input) const
uint64_t get_uint64 (const SocketType &input) const
float get_float (const SocketType &input) const
float2 get_float2 (const SocketType &input) const
float3 get_float3 (const SocketType &input) const
ustring get_string (const SocketType &input) const
Transform get_transform (const SocketType &input) const
Node * get_node (const SocketType &input) const
const array< bool > & get_bool_array (const SocketType &input) const
const array< int > & get_int_array (const SocketType &input) const
const array< float > & get_float_array (const SocketType &input) const
const array< float2 > & get_float2_array (const SocketType &input) const
const array< float3 > & get_float3_array (const SocketType &input) const
const array< ustring > & get_string_array (const SocketType &input) const
const array< Transform > & get_transform_array (const SocketType &input) const
const array< Node * > & get_node_array (const SocketType &input) const
bool has_default_value (const SocketType &input) const
void set_default_value (const SocketType &input)
bool equals_value (const Node &other, const SocketType &input) const
void copy_value (const SocketType &input, const Node &other, const SocketType &other_input)
void set_value (const SocketType &input, const Node &other, const SocketType &other_input)
bool equals (const Node &other) const
void hash (MD5Hash &md5)
size_t get_total_size_in_bytes () const
bool is_a (const NodeType *type)
bool socket_is_modified (const SocketType &input) const
bool is_modified () const
void tag_modified ()
void clear_modified ()
void print_modified_sockets () const
const NodeOwner * get_owner () const
void set_owner (const NodeOwner *owner_)
int reference_count () const
void reference ()
void dereference ()
void clear_reference_count ()

Public Attributes

vector< ShaderInput * > inputs
vector< ShaderOutput * > outputs
int id
ShaderBump bump
ShaderNodeSpecialType special_type
Public Attributes inherited from Node
ustring name
const NodeType * type
InternalNode internal
LeafNode leaf

Additional Inherited Members

Protected Member Functions inherited from Node
template<typename T>
void set_if_different (const SocketType &input, T value)
void set_if_different (const SocketType &input, Node *value)
template<typename T>
void set_if_different (const SocketType &input, array< T > &value)
void set_if_different (const SocketType &input, array< Node * > &value)
void dereference_all_used_nodes ()
Static Protected Member Functions inherited from Node
template<typename T>
static T & get_socket_value (const Node *node, const SocketType &socket)
Protected Attributes inherited from Node
const NodeOwner * owner
int ref_count {0}
SocketModifiedFlags socket_modified

Detailed Description

Definition at line 149 of file shader_graph.h.

Constructor & Destructor Documentation

◆ ShaderNode()

ShaderNode::ShaderNode ( const NodeType * type)
explicit

Definition at line 67 of file shader_graph.cpp.

References bump, create_inputs_outputs(), Node::name, Node::Node(), SHADER_BUMP_NONE, SHADER_SPECIAL_TYPE_NONE, special_type, and Node::type.

Referenced by BsdfBaseNode::BsdfBaseNode(), EnvironmentTextureNode::clone(), IESLightNode::clone(), ImageTextureNode::clone(), OSLNode::clone(), PointDensityTextureNode::clone(), clone(), ConvertNode::constant_fold(), ConvertNode::ConvertNode(), ConvertNode::ConvertNode(), ImageTextureNode::cull_tiles(), CurvesNode::CurvesNode(), BsdfBaseNode::equals(), EnvironmentTextureNode::equals(), ImageSlotTextureNode::equals(), ImageTextureNode::equals(), OSLNode::equals(), OutputAOVNode::equals(), OutputNode::equals(), PointDensityTextureNode::equals(), equals(), VolumeNode::equals(), TextureNode::TextureNode(), and VolumeNode::VolumeNode().

◆ ~ShaderNode()

ShaderNode::~ShaderNode ( )
virtual

Definition at line 77 of file shader_graph.cpp.

References inputs, and outputs.

Member Function Documentation

◆ attributes()

void ShaderNode::attributes ( Shader * shader,
AttributeRequestSet * attributes )
virtual

Reimplemented in AttributeNode, EnvironmentTextureNode, GeometryNode, GlossyBsdfNode, HairInfoNode, ImageTextureNode, MetallicBsdfNode, NormalMapNode, ParticleInfoNode, PointDensityTextureNode, PointInfoNode, PrincipledBsdfNode, PrincipledHairBsdfNode, PrincipledVolumeNode, TangentNode, TextureCoordinateNode, UVMapNode, VectorDisplacementNode, VertexColorNode, and VolumeInfoNode.

Definition at line 148 of file shader_graph.cpp.

References ATTR_STD_GENERATED, ATTR_STD_GENERATED_TRANSFORM, ATTR_STD_UV, attributes(), Shader::has_surface_link(), Shader::has_volume, input(), inputs, SocketType::LINK_TEXTURE_GENERATED, and SocketType::LINK_TEXTURE_UV.

Referenced by AttributeNode::attributes(), EnvironmentTextureNode::attributes(), GeometryNode::attributes(), GlossyBsdfNode::attributes(), HairInfoNode::attributes(), ImageTextureNode::attributes(), MetallicBsdfNode::attributes(), NormalMapNode::attributes(), ParticleInfoNode::attributes(), PointDensityTextureNode::attributes(), PointInfoNode::attributes(), PrincipledBsdfNode::attributes(), PrincipledHairBsdfNode::attributes(), PrincipledVolumeNode::attributes(), attributes(), TangentNode::attributes(), TextureCoordinateNode::attributes(), UVMapNode::attributes(), VectorDisplacementNode::attributes(), VertexColorNode::attributes(), VolumeInfoNode::attributes(), clone(), and Shader::tag_update().

◆ clone()

virtual ShaderNode * ShaderNode::clone ( ShaderGraph * graph) const
pure virtual

Implemented in EnvironmentTextureNode, IESLightNode, ImageTextureNode, OSLNode, and PointDensityTextureNode.

References attributes(), and ShaderNode().

Referenced by ShaderGraph::copy_nodes().

◆ compile() [1/2]

virtual void ShaderNode::compile ( OSLCompiler & compiler)
pure virtual

◆ compile() [2/2]

virtual void ShaderNode::compile ( SVMCompiler & compiler)
pure virtual

Referenced by SVMCompiler::generate_node().

◆ constant_fold()

virtual void ShaderNode::constant_fold ( const ConstantFolder & )
inlinevirtual

Reimplemented in AddClosureNode, BackgroundNode, BlackbodyNode, BrightContrastNode, BumpNode, ClampNode, ColorNode, CombineColorNode, CombineHSVNode, CombineRGBNode, CombineXYZNode, ConvertNode, CurvesNode, DisplacementNode, EmissionNode, FloatCurveNode, GammaNode, InvertNode, MappingNode, MathNode, MixClosureNode, MixColorNode, MixFloatNode, MixNode, MixVectorNode, MixVectorNonUniformNode, RGBCurvesNode, RGBRampNode, RGBToBWNode, SeparateColorNode, SeparateHSVNode, SeparateRGBNode, SeparateXYZNode, ValueNode, VectorCurvesNode, VectorDisplacementNode, and VectorMathNode.

Definition at line 172 of file shader_graph.h.

Referenced by ShaderGraph::constant_fold().

◆ create_inputs_outputs()

void ShaderNode::create_inputs_outputs ( const NodeType * type)

Definition at line 86 of file shader_graph.cpp.

References SocketType::flags, inputs, SocketType::LINKABLE, outputs, and Node::type.

Referenced by ShaderGraph::copy_nodes(), and ShaderNode().

◆ equals()

bool ShaderNode::equals ( const ShaderNode & other)
virtual

Reimplemented in BsdfBaseNode, EnvironmentTextureNode, ImageSlotTextureNode, ImageTextureNode, OSLNode, OutputAOVNode, OutputNode, PointDensityTextureNode, and VolumeNode.

Definition at line 169 of file shader_graph.cpp.

References bump, Node::equals_value(), SocketType::flags, inputs, ShaderInput::link, SocketType::LINKABLE, NULL, ShaderNode(), ShaderInput::socket_type, and Node::type.

Referenced by ShaderGraph::deduplicate_nodes(), and PointDensityTextureNode::equals().

◆ expand()

virtual void ShaderNode::expand ( ShaderGraph * )
inlinevirtual

Reimplemented in MapRangeNode, MathNode, VectorMapRangeNode, and VolumeInfoNode.

Definition at line 168 of file shader_graph.h.

Referenced by ShaderGraph::expand().

◆ get_closure_type()

virtual ClosureType ShaderNode::get_closure_type ( )
inlinevirtual

Reimplemented in BsdfBaseNode, GlassBsdfNode, GlossyBsdfNode, HairBsdfNode, HoldoutNode, MetallicBsdfNode, RefractionBsdfNode, SheenBsdfNode, SubsurfaceScatteringNode, and VolumeNode.

Definition at line 235 of file shader_graph.h.

References CLOSURE_NONE_ID.

Referenced by ShaderGraph::get_num_closures().

◆ get_feature()

virtual int ShaderNode::get_feature ( )
inlinevirtual

Reimplemented in AmbientOcclusionNode, BackgroundNode, BevelNode, BsdfBaseNode, BumpNode, DisplacementNode, EmissionNode, OSLNode, PrincipledHairBsdfNode, VectorDisplacementNode, VolumeNode, and VoronoiTextureNode.

Definition at line 229 of file shader_graph.h.

References bump, KERNEL_FEATURE_NODE_BUMP, and SHADER_BUMP_NONE.

Referenced by SVMCompiler::generate_closure_node(), SVMCompiler::generate_node(), BackgroundNode::get_feature(), BsdfBaseNode::get_feature(), EmissionNode::get_feature(), OSLNode::get_feature(), PrincipledHairBsdfNode::get_feature(), VolumeNode::get_feature(), VoronoiTextureNode::get_feature(), and ShaderManager::get_graph_kernel_features().

◆ has_attribute_dependency()

virtual bool ShaderNode::has_attribute_dependency ( )
inlinevirtual

Reimplemented in AttributeNode, EnvironmentTextureNode, GeometryNode, GlossyBsdfNode, HairInfoNode, ImageTextureNode, MetallicBsdfNode, NormalMapNode, ParticleInfoNode, PointDensityTextureNode, PointInfoNode, PrincipledBsdfNode, PrincipledVolumeNode, TangentNode, TextureCoordinateNode, UVMapNode, VectorDisplacementNode, VertexColorNode, and VolumeInfoNode.

Definition at line 203 of file shader_graph.h.

Referenced by SVMCompiler::generate_node().

◆ has_bssrdf_bump()

virtual bool ShaderNode::has_bssrdf_bump ( )
inlinevirtual

Reimplemented in PrincipledBsdfNode, and SubsurfaceScatteringNode.

Definition at line 195 of file shader_graph.h.

◆ has_bump()

virtual bool ShaderNode::has_bump ( )
inlinevirtual

Reimplemented in BsdfBaseNode.

Definition at line 191 of file shader_graph.h.

◆ has_spatial_varying()

virtual bool ShaderNode::has_spatial_varying ( )
inlinevirtual

Reimplemented in AmbientOcclusionNode, AttributeNode, BevelNode, BsdfBaseNode, BumpNode, CameraNode, FresnelNode, GeometryNode, HairInfoNode, LayerWeightNode, LightFalloffNode, NormalMapNode, OSLNode, PointDensityTextureNode, PointInfoNode, TangentNode, TextureCoordinateNode, UVMapNode, VertexColorNode, VolumeInfoNode, and WireframeNode.

Definition at line 199 of file shader_graph.h.

Referenced by SVMCompiler::generate_node().

◆ has_surface_bssrdf()

virtual bool ShaderNode::has_surface_bssrdf ( )
inlinevirtual

Reimplemented in PrincipledBsdfNode, and SubsurfaceScatteringNode.

Definition at line 187 of file shader_graph.h.

Referenced by ShaderManager::get_graph_kernel_features().

◆ has_surface_emission()

virtual bool ShaderNode::has_surface_emission ( )
inlinevirtual

Reimplemented in EmissionNode, OSLNode, and PrincipledBsdfNode.

Definition at line 179 of file shader_graph.h.

Referenced by output_estimate_emission().

◆ has_surface_transparent()

virtual bool ShaderNode::has_surface_transparent ( )
inlinevirtual

Reimplemented in PrincipledBsdfNode, PrincipledHairBsdfNode, RayPortalBsdfNode, and TransparentBsdfNode.

Definition at line 183 of file shader_graph.h.

Referenced by ShaderManager::get_graph_kernel_features().

◆ has_volume_support()

virtual bool ShaderNode::has_volume_support ( )
inlinevirtual

Reimplemented in EmissionNode, OSLNode, and VolumeNode.

Definition at line 207 of file shader_graph.h.

Referenced by ShaderGraph::verify_volume_output().

◆ input() [1/2]

ShaderInput * ShaderNode::input ( const char * name)

Definition at line 99 of file shader_graph.cpp.

References inputs, Node::name, ShaderInput::name(), and NULL.

Referenced by ShaderManager::add_default(), GlossyBsdfNode::attributes(), MetallicBsdfNode::attributes(), PrincipledBsdfNode::attributes(), PrincipledHairBsdfNode::attributes(), PrincipledVolumeNode::attributes(), attributes(), ShaderGraph::bump_from_displacement(), BsdfNode::compile(), CurvesNode::compile(), VolumeNode::compile(), ShaderGraph::compute_displacement_hash(), AddClosureNode::constant_fold(), BackgroundNode::constant_fold(), BumpNode::constant_fold(), CurvesNode::constant_fold(), EmissionNode::constant_fold(), FloatCurveNode::constant_fold(), GammaNode::constant_fold(), InvertNode::constant_fold(), MixClosureNode::constant_fold(), RGBCurvesNode::constant_fold(), ShaderGraph::constant_fold(), VectorCurvesNode::constant_fold(), ShaderGraph::copy_nodes(), ImageTextureNode::cull_tiles(), ShaderGraph::default_inputs(), LightManager::device_update_background(), MapRangeNode::expand(), MathNode::expand(), ShaderGraph::finalize(), SVMCompiler::generate_multi_closure(), ShaderManager::get_kernel_features(), SubsurfaceScatteringNode::has_bssrdf_bump(), BsdfBaseNode::has_bump(), PrincipledBsdfNode::has_surface_bssrdf(), PrincipledBsdfNode::has_surface_emission(), PrincipledBsdfNode::has_surface_transparent(), PrincipledHairBsdfNode::has_surface_transparent(), GlossyBsdfNode::is_isotropic(), MetallicBsdfNode::is_isotropic(), node_find_input_by_name(), output_estimate_emission(), ShaderGraph::refine_bump_nodes(), remove_input(), GlossyBsdfNode::simplify_settings(), MetallicBsdfNode::simplify_settings(), OutputAOVNode::simplify_settings(), PrincipledBsdfNode::simplify_settings(), ShaderGraph::transform_multi_closure(), and ShaderGraph::verify_volume_output().

◆ input() [2/2]

ShaderInput * ShaderNode::input ( ustring name)

Definition at line 120 of file shader_graph.cpp.

References inputs, Node::name, ShaderInput::name(), and NULL.

◆ output() [1/2]

ShaderOutput * ShaderNode::output ( const char * name)

Definition at line 110 of file shader_graph.cpp.

References Node::name, ShaderOutput::name(), NULL, and outputs.

Referenced by CCL_NAMESPACE_BEGIN::ShaderGraphBuilder::add_connection(), ShaderManager::add_default(), VertexColorNode::attributes(), ShaderGraph::bump_from_displacement(), BumpNode::constant_fold(), RGBRampNode::constant_fold(), ShaderGraph::constant_fold(), VectorMathNode::constant_fold(), ShaderGraph::copy_nodes(), ImageTextureNode::cull_tiles(), ShaderGraph::default_inputs(), LightManager::device_update_background(), MapRangeNode::expand(), MathNode::expand(), VolumeInfoNode::expand(), node_find_output_by_name(), Shader::tag_update(), and ShaderGraph::transform_multi_closure().

◆ output() [2/2]

ShaderOutput * ShaderNode::output ( ustring name)

Definition at line 131 of file shader_graph.cpp.

References Node::name, ShaderOutput::name(), NULL, and outputs.

◆ remove_input()

void ShaderNode::remove_input ( ShaderInput * input)

Definition at line 141 of file shader_graph.cpp.

References input(), inputs, and NULL.

◆ simplify_settings()

virtual void ShaderNode::simplify_settings ( Scene * )
inlinevirtual

Reimplemented in GlossyBsdfNode, MetallicBsdfNode, OutputAOVNode, PrincipledBsdfNode, and SkyTextureNode.

Definition at line 177 of file shader_graph.h.

Referenced by ShaderGraph::simplify_settings().

Member Data Documentation

◆ bump

ShaderBump ShaderNode::bump

Definition at line 215 of file shader_graph.h.

Referenced by ShaderGraph::dump_graph(), equals(), get_feature(), ShaderGraph::refine_bump_nodes(), and ShaderNode().

◆ id

int ShaderNode::id

Definition at line 214 of file shader_graph.h.

Referenced by ShaderGraph::add(), ShaderGraph::break_cycles(), ShaderGraph::clean(), SVMCompiler::CompilerState::CompilerState(), ShaderGraph::compute_displacement_hash(), SVMCompiler::generate_multi_closure(), SVMCompiler::generate_svm_nodes(), ShaderNodeIDComparator::operator()(), and ShaderGraph::remove_proxy_nodes().

◆ inputs

vector<ShaderInput *> ShaderNode::inputs

Definition at line 211 of file shader_graph.h.

Referenced by add_nodes(), attributes(), ShaderGraph::break_cycles(), ShaderGraph::clean(), OSLNode::clone(), SVMCompiler::compile_type(), ShaderGraph::compute_displacement_hash(), ConvertNode::constant_fold(), ShaderGraph::copy_nodes(), create_inputs_outputs(), ShaderGraph::default_inputs(), ShaderGraph::dump_graph(), equals(), SVMCompiler::find_aov_nodes_and_dependencies(), ShaderGraph::find_dependencies(), SVMCompiler::find_dependencies(), SVMCompiler::generate_multi_closure(), SVMCompiler::generate_svm_nodes(), SVMCompiler::generated_shared_closure_nodes(), input(), input(), output_estimate_emission(), ShaderGraph::relink(), remove_input(), ShaderGraph::remove_proxy_nodes(), SVMCompiler::stack_clear_temporary(), SVMCompiler::stack_clear_users(), Shader::tag_update(), ShaderGraph::verify_volume_output(), and ~ShaderNode().

◆ outputs

vector<ShaderOutput *> ShaderNode::outputs

Definition at line 212 of file shader_graph.h.

Referenced by add_nodes(), SVMCompiler::compile_type(), SeparateColorNode::constant_fold(), SeparateHSVNode::constant_fold(), SeparateRGBNode::constant_fold(), SeparateXYZNode::constant_fold(), ShaderGraph::constant_fold(), ShaderGraph::copy_nodes(), create_inputs_outputs(), ShaderGraph::deduplicate_nodes(), ShaderGraph::dump_graph(), output(), output(), ShaderGraph::remove_proxy_nodes(), xml_read_shader_graph(), and ~ShaderNode().

◆ special_type

ShaderNodeSpecialType ShaderNode::special_type

Definition at line 217 of file shader_graph.h.

Referenced by BsdfBaseNode::BsdfBaseNode(), ShaderGraph::clean(), ShaderGraph::compute_displacement_hash(), ConvertNode::constant_fold(), ConvertNode::ConvertNode(), GeometryManager::device_update_displacement_images(), Shader::estimate_emission(), SVMCompiler::find_aov_nodes_and_dependencies(), SVMCompiler::generate_multi_closure(), ShaderManager::get_graph_kernel_features(), SubsurfaceScatteringNode::has_bssrdf_bump(), BsdfBaseNode::has_bump(), ImageSlotTextureNode::ImageSlotTextureNode(), node_use_modified_socket_name(), ShaderGraph::refine_bump_nodes(), ShaderGraph::remove_proxy_nodes(), ShaderNode(), Shader::tag_update(), and ShaderGraph::transform_multi_closure().

The documentation for this class was generated from the following files:
Generated on Sat Oct 4 2025 05:32:23 for Blender by  doxygen 1.14.0