MaterialNormal

MaterialNormal#

(Normal)

Category: /Material
Default object name: normal
Inherits from: ProjectItem > Material

Description#

A material that displays the normals of objects with colors.

Public Attributes#

Type	Name	Visual Hint	Description
`bool`	`double_sided`	`VISUAL_HINT_DEFAULT`	Flip the normal if needed in order to always face the point of view.
`long`	`normal_mode`	`VISUAL_HINT_DEFAULT`	Define which geometric normal to use for the shading.
`double`	`normal_input`	`VISUAL_HINT_PERCENTAGE`	Override the shading normal by the one given as input. The value controls the blending with the original normal.
`long`	`project`	`VISUAL_HINT_DEFAULT`	Define if the normal has to be expressed in world coordinates or camera coordinates before being converted into a color.

Inherited Public Attributes#

Type	Name	Visual Hint	Description
`bool`	`export_aovs`	`VISUAL_HINT_DEFAULT`	Compute and write Aovs defined in the shading graph
`reference` (`AovStore`)	`arbitrary_output_variables`	`VISUAL_HINT_DEFAULT`	Set the list of extra channels to write to the image.

CID#

class "MaterialNormal" "Material" {
    #version 0.91
    icon "../icons/object_icons/material_normal.iconrc"
    category "/Material"
    doc "A material that displays the normals of objects with colors."
    attribute_group "normal" {
        bool "double_sided" {
            doc "Flip the normal if needed in order to always face the point of view."
            animatable yes
            value yes
        }
        long "normal_mode" {
            doc "Define which geometric normal to use for the shading."
            preset "Flat" "0"
            preset "Smooth" "1"
            value 1
        }
        percentage "normal_input" {
            doc "Override the shading normal by the one given as input. The value controls the blending with the original normal."
            texturable yes
            animatable yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 1
        }
    }
    attribute_group "normal>advanced" {
        collapsed yes
        ui_weight 1000
        long "project" {
            doc "Define if the normal has to be expressed in world coordinates or camera coordinates before being converted into a color."
            preset "World" "0"
            preset "Camera Space" "1"
            value 0
        }
        bool "reflection_normals" {
            hidden yes
            animatable yes
            value no
        }
    }
}