diff --git a/source/blender/nodes/shader/nodes/node_shader_background.cc b/source/blender/nodes/shader/nodes/node_shader_background.cc index 10e92cbb0d5..acfd462611f 100644 --- a/source/blender/nodes/shader/nodes/node_shader_background.cc +++ b/source/blender/nodes/shader/nodes/node_shader_background.cc @@ -8,8 +8,14 @@ namespace blender::nodes::node_shader_background_cc { static void node_declare(NodeDeclarationBuilder &b) { - b.add_input("Color").default_value({0.8f, 0.8f, 0.8f, 1.0f}); - b.add_input("Strength").default_value(1.0f).min(0.0f).max(1000000.0f); + b.add_input("Color") + .default_value({0.8f, 0.8f, 0.8f, 1.0f}) + .description("Color of the emitted light"); + b.add_input("Strength") + .default_value(1.0f) + .min(0.0f) + .max(1000000.0f) + .description("Strength of the emitted light"); b.add_input("Weight").unavailable(); b.add_output("Background"); } diff --git a/source/blender/nodes/shader/nodes/node_shader_bsdf_principled.cc b/source/blender/nodes/shader/nodes/node_shader_bsdf_principled.cc index 06229e4ba85..7fb9f097903 100644 --- a/source/blender/nodes/shader/nodes/node_shader_bsdf_principled.cc +++ b/source/blender/nodes/shader/nodes/node_shader_bsdf_principled.cc @@ -52,7 +52,7 @@ static void node_declare(NodeDeclarationBuilder &b) " (0.0 is a perfect mirror reflection, 1.0 is completely rough)"); #define SOCK_ROUGHNESS_ID 2 b.add_input("IOR").default_value(1.5f).min(1.0f).max(1000.0f).description( - "Index of refraction for specular reflection and transmission. " + "Index of Refraction (IOR) for specular reflection and transmission. " "For most materials, the IOR is between 1.0 (vacuum and air) and 4.0 (germanium). " "The default value of 1.5 is a good approximation for glass"); #define SOCK_IOR_ID 3 @@ -106,7 +106,7 @@ static void node_declare(NodeDeclarationBuilder &b) .max(3.8f) .subtype(PROP_FACTOR) .short_label("IOR") - .description("Index of refraction used for rays that enter the subsurface component"); + .description("Index of Refraction (IOR) used for rays that enter the subsurface component"); #define SOCK_SUBSURFACE_IOR_ID 10 sss.add_input("Subsurface Anisotropy") .default_value(0.0f) @@ -115,9 +115,9 @@ static void node_declare(NodeDeclarationBuilder &b) .subtype(PROP_FACTOR) .short_label("Anisotropy") .description( - "Directionanltiy of volume scattering within the subsurface medium. " + "Directionality of volume scattering within the subsurface medium. " "Zero scatters uniformly in all directions, with higher values " - "scattering more strongly forward. For example skin has been measured " + "scattering more strongly forward. For example, skin has been measured " "to have an anisotropy of 0.8"); #define SOCK_SUBSURFACE_ANISOTROPY_ID 11 @@ -135,7 +135,7 @@ static void node_declare(NodeDeclarationBuilder &b) .subtype(PROP_FACTOR) .short_label("IOR Level") .description( - "Adjustment to the IOR to increase or decrease specular intensity " + "Adjustment to the Index of Refraction (IOR) to increase or decrease specular intensity " "(0.5 means no adjustment, 0 removes all reflections, 1 doubles them at normal " "incidence)"); #define SOCK_SPECULAR_ID 12 @@ -165,7 +165,7 @@ static void node_declare(NodeDeclarationBuilder &b) .description("Rotates the direction of anisotropy, with 1.0 going full circle"); #define SOCK_ANISOTROPIC_ROTATION_ID 15 spec.add_input("Tangent").hide_value().description( - "Controls the tangent line for the Anisotropic layer"); + "Controls the tangent direction for anisotropy"); #define SOCK_TANGENT_ID 16 /* Panel for Transmission settings. */ @@ -205,7 +205,7 @@ static void node_declare(NodeDeclarationBuilder &b) .max(4.0f) .short_label("IOR") .description( - "The index of refraction of the coat layer " + "The Index of Refraction (IOR) of the coat layer " "(affects its reflectivity as well as the falloff of coat tinting)"); #define SOCK_COAT_IOR_ID 20 coat.add_input("Coat Tint") @@ -255,7 +255,7 @@ static void node_declare(NodeDeclarationBuilder &b) .max(1000000.0f) .short_label("Strength") .description( - "Strength of the emitted light. A value of 1.0 will ensure " + "Strength of the emitted light. A value of 1.0 ensures " "that the object in the image has the exact same color as the Emission Color"); #define SOCK_EMISSION_STRENGTH_ID 27 } diff --git a/source/blender/nodes/shader/nodes/node_shader_bump.cc b/source/blender/nodes/shader/nodes/node_shader_bump.cc index 655ebc9513f..9aaea4438b0 100644 --- a/source/blender/nodes/shader/nodes/node_shader_bump.cc +++ b/source/blender/nodes/shader/nodes/node_shader_bump.cc @@ -21,8 +21,16 @@ static void node_declare(NodeDeclarationBuilder &b) .default_value(1.0f) .min(0.0f) .max(1.0f) - .subtype(PROP_FACTOR); - b.add_input("Distance").default_value(1.0f).min(0.0f).max(1000.0f); + .subtype(PROP_FACTOR) + .description( + "Strength of the bump mapping effect, interpolating between " + "no bump mapping and full bump mapping"); + b.add_input("Distance") + .default_value(1.0f) + .min(0.0f) + .max(1000.0f) + .description( + "Multiplier for the height value to control the overall distance for bump mapping"); b.add_input("Height").default_value(1.0f).min(-1000.0f).max(1000.0f).hide_value(); b.add_input("Normal").min(-1.0f).max(1.0f).hide_value(); b.add_output("Normal"); diff --git a/source/blender/nodes/shader/nodes/node_shader_color_ramp.cc b/source/blender/nodes/shader/nodes/node_shader_color_ramp.cc index 6be99a77a78..d5e8c460eb8 100644 --- a/source/blender/nodes/shader/nodes/node_shader_color_ramp.cc +++ b/source/blender/nodes/shader/nodes/node_shader_color_ramp.cc @@ -22,7 +22,14 @@ namespace blender::nodes::node_shader_color_ramp_cc { static void sh_node_valtorgb_declare(NodeDeclarationBuilder &b) { b.is_function_node(); - b.add_input("Fac").default_value(0.5f).min(0.0f).max(1.0f).subtype(PROP_FACTOR); + b.add_input("Fac") + .default_value(0.5f) + .min(0.0f) + .max(1.0f) + .subtype(PROP_FACTOR) + .description( + "The value used to map onto the color gradient. 0.0 results in the leftmost color, " + "while 1.0 results in the rightmost"); b.add_output("Color"); b.add_output("Alpha"); } diff --git a/source/blender/nodes/shader/nodes/node_shader_mix_shader.cc b/source/blender/nodes/shader/nodes/node_shader_mix_shader.cc index f73efb8394a..bfdd6699885 100644 --- a/source/blender/nodes/shader/nodes/node_shader_mix_shader.cc +++ b/source/blender/nodes/shader/nodes/node_shader_mix_shader.cc @@ -8,7 +8,14 @@ namespace blender::nodes::node_shader_mix_shader_cc { static void node_declare(NodeDeclarationBuilder &b) { - b.add_input("Fac").default_value(0.5f).min(0.0f).max(1.0f).subtype(PROP_FACTOR); + b.add_input("Fac") + .default_value(0.5f) + .min(0.0f) + .max(1.0f) + .subtype(PROP_FACTOR) + .description( + "Blend weight to use for mixing two shaders. " + "At zero it uses the first shader entirely and at one the second shader"); b.add_input("Shader"); b.add_input("Shader", "Shader_001"); b.add_output("Shader"); diff --git a/source/blender/nodes/shader/nodes/node_shader_tex_noise.cc b/source/blender/nodes/shader/nodes/node_shader_tex_noise.cc index 9cd56d411eb..a2076dc012b 100644 --- a/source/blender/nodes/shader/nodes/node_shader_tex_noise.cc +++ b/source/blender/nodes/shader/nodes/node_shader_tex_noise.cc @@ -28,23 +28,45 @@ static void sh_node_tex_noise_declare(NodeDeclarationBuilder &b) /* Default to 1 instead of 4, because it is much faster. */ node_storage(node).dimensions = 1; }); - b.add_input("Scale").min(-1000.0f).max(1000.0f).default_value(5.0f); - b.add_input("Detail").min(0.0f).max(15.0f).default_value(2.0f); + b.add_input("Scale").min(-1000.0f).max(1000.0f).default_value(5.0f).description( + "Scale of the base noise octave"); + b.add_input("Detail").min(0.0f).max(15.0f).default_value(2.0f).description( + "The number of noise octaves. Higher values give more detailed noise but increase render " + "time"); b.add_input("Roughness") .min(0.0f) .max(1.0f) .default_value(0.5f) - .subtype(PROP_FACTOR); + .subtype(PROP_FACTOR) + .description( + "Blend factor between an octave and its previous one. A value of zero corresponds to " + "zero detail"); b.add_input("Lacunarity") .min(0.0f) .max(1000.0f) .default_value(2.0f) - .description("The scale of a Perlin noise octave relative to that of the previous octave"); - b.add_input("Offset").min(-1000.0f).max(1000.0f).default_value(0.0f).make_available( - [](bNode &node) { node_storage(node).type = SHD_NOISE_RIDGED_MULTIFRACTAL; }); - b.add_input("Gain").min(0.0f).max(1000.0f).default_value(1.0f).make_available( - [](bNode &node) { node_storage(node).type = SHD_NOISE_RIDGED_MULTIFRACTAL; }); - b.add_input("Distortion").min(-1000.0f).max(1000.0f).default_value(0.0f); + .description( + "The difference between the scale of each two consecutive octaves. Larger values " + "corresponds to larger scale for higher octaves"); + b.add_input("Offset") + .min(-1000.0f) + .max(1000.0f) + .default_value(0.0f) + .make_available([](bNode &node) { node_storage(node).type = SHD_NOISE_RIDGED_MULTIFRACTAL; }) + .description( + "An added offset to each octave, determines the level where the highest octave will " + "appear"); + b.add_input("Gain") + .min(0.0f) + .max(1000.0f) + .default_value(1.0f) + .make_available([](bNode &node) { node_storage(node).type = SHD_NOISE_RIDGED_MULTIFRACTAL; }) + .description("An extra multiplier to tune the magnitude of octaves"); + b.add_input("Distortion") + .min(-1000.0f) + .max(1000.0f) + .default_value(0.0f) + .description("Amount of distortion"); b.add_output("Fac").no_muted_links(); b.add_output("Color").no_muted_links(); }