Edge

When turned off, the edge detection is disabled (enabled by default). 

  • To view the toon_edge, you must change the filter_type (sampling settings) to contour.
  • Increasing the contour_filter_width (sampling settings) value will increase render times.
Enabled (default). Requires 'Contour' Filter enabled.
Disabled (Emission only).

The Contour Filter can be found in the Filter settings of the Render Settings window.

Edge Color

The color of the toon edge. The line style can be controlled with a texture here.

Red
Stylized edge with ramp

Edge Tonemap

Connect a ramp node here to change the Edge Color based on the shading result of the Base.

Default (nothing connected)
Gradient ramp

The direct diffuse shading contribution is mapped into the UVs. So in the example below, the back of the sphere (which has the darkest direct diffuse) is blue and the part of the sphere hit directly by the directional light is green. This then becomes yellow as the exposure of the lighting is increased.

Light Exposure: 0
Light Exposure: 0.5
Light Exposure: 1

In the example below, the edge_color (yellow) is multiplied by the blue ramp color (connected to edge_tonemap) to give green.

Blue ramp -> Edge Tonemap. Edge Color: White
Blue ramp -> Edge Tonemap. Edge Color: Yellow

Edge Opacity

Controls the transparency of the edge.


0.1
0.5
1 (default)
  

Width Scaling

The maximum width of the contour lines is determined by the width parameter of the contour filter. The actual width is the multiplication of it and this parameter. The line style can be controlled by combining this with a texture.

To increase the edge_width_scale above 1, you will need to increase the contour filter width. However, this will increase render times.

0.1
0.3
1 (default)

You can avoid edge 'cluttering' in the center by connecting a facing_ratio shader to width_scale. 

Without Facing Ratio shader
Facing Ratio (inverted) -> Width Scale

The width_scale can be used to control the edge depending on the distance from the camera.

You may notice flickering in animations using width_scale values below 1. Enabling lock_sampling_pattern (sampling render settings) should fix this issue.

Edge Detection

ID Difference

If enabled, edge detection uses the difference of IDs from neighboring pixels.

Enabled (default)
Disabled



Enabled (default). Rollover image for disabled.

Curve, Point, and Shape IDs
ID Difference draws edges on curves, points, and shapes. Points also have a different ID for each point. A sphere is covered in particles (as spheres) that use the same toon shader. Emission_rolor = Utility shader with Color = Uniform ID (the ID used by the Toon shader). The particles have edges because each sphere is a point with a different ID. The large sphere is a shape, so the Toon shader uses the name as the ID (otherwise every primitive e.g. polygon would have an edge). For curves, every curve has a different ID, so ID Difference enabled vs disabled would look like the images below.
Enabled (default)
Disabled
Particles have Edges, polygons do not.

Shader Difference

Detects the difference of shaders of neighboring samples. This is useful when multiple shaders are assigned to a single polymesh, for example.

Enabled for all RGB shaders (default)
Green & blue: disabled
Red: disabled (ID Difference: disabled)

Ensure that the angle_threshold is low enough, otherwise, you may not notice a difference.


Mask Color

The edge is detected when the mask color of neighboring pixels is different. The mask_color is assumed to have a texture connected to draw an arbitrary shape by detecting color differences. With this parameter, lines can be drawn anywhere (the filter draws lines where the color of the mask changes).

Stylistic effects achieved by connecting different shaders to mask_color

The Shade Modes of the Utility shader can be used to add more detail to the edge when connected to mask_color.

Utility shader -> mask_color

A tutorial that covers how to use the Edge Mask Color can be found here.

UV Threshold

If enabled, edge detection uses the difference of UVs from neighboring pixels.

0 (default)
0.1

Angle Threshold

When less than 180, the edge detection uses the difference of the angle between neighboring pixels.

180 (default)
50
10


Angle_threshold keyframed from 180 to 10

Edge Detection

The normal used in the edge detection. Choose from: Shading Normal, Smoothed Normal, and Geometric Normal.

Shading Normal (default) with bump.
Smoothed Normal
Geometric Normal


Smoothed Normal. Rollover image to view Geometric Normal.

Advanced Edge Control

Priority

Changes the sorting priority of the edge.
0 (all objects).

Red sphere 1.

Rollover image for red sphere 0, green sphere 1.
Blue plane 1 (both spheres 0).

Lips: 0. Skin: 1
Lips: 1. Skin: 0

Ignore Throughput

By default, the contour color is affected by ray throughput. If a specific color is required for a reflected/refracted object, enable this and use a ray_switch shader.

Disabled (default)
Enabled

Use Toon ID

Edge detection can be controlled using a STRING type user data called Toon ID. Otherwise, the detected edges will be driven by the object's own name as a toon-specific ID. This allows for grouping of objects, where Toon ID specifies which objects belong together regarding edge detection.

'Use Toon ID' disabled (default). 'Shader Difference' disabled.
'Use Toon ID' enabled. Toon ID '1' added to left sphere shape.
Cross Hatching 

Displacing the surface with a texture can help to create a crosshatch effect with Toon Edge shading. 

Teapot displaced with noise shader

 

 

 

 

 

Pepe model by Daniel M. Lara (Pepeland).

  • No labels