Reference Cinema 4D Cinema 4D Visualize, Broadcast, Studio Sketch and Toon Sketch and Toon Material
Function available in CINEMA 4D Visualize, Studio
Sketch Mat

Basic Main Strokes Adjust Distort Color Thickness Opacity Render Clone Animate Assign

Thickness

These three tabs give you complete control over the color, thickness and opacity of lines. They enable you to create any type of line effect, from simple lines that fade out to complex brush effects. Each tab works in a similar way:

With a few exceptions, each tab has the same modifier options. For example, the Along Stroke modifier is present on all three tabs.

Thickness [0..10000]

Thin out and fade the lines as they get further away from the object or polygon selection.

 Modifiers

Distance
Position
Scale
Illumination
Vertex Map
Texture Map
Screen Texture
Along Stroke
Total Length
Facing Angle
Join Angle
Screen Angle
Noise
Python

Activate the desired modifier here:

 Python

Tip:
C.O.F.F.E.E. scripts in older Projects are no longer supported.

Tip
In order to use this very powerful modifier, you should have a good command of Python, which is one of the script languages implemented by Cinema 4D. For details about the Python programming language, visit http://developers.maxon.net.

The Python modifier lets you create virtually any medium or style, from a simple pencil to a complex brush.

Strength [0..10000%]

Defines the strength of the effect - 0% = no effect; 100% = full effect.

Script

Enter your Python script into the Script field.

Editor...

Enter a script into the Script box or click the Expresson Editor button and enter the script into Cinema 4D’s script editor.

Command

This acts as a quick reference to look up the names of the commands. It has no other purpose. It does not insert commands.

sPosition [Real]

Position along a line in pixels (screen space).

sNormalisedP [Real]

Normalized position along a line (0 to 1).

ToLine [Real]

Distance to the line from the current render point (which is within the line’s thickness). Values range from - Thickness to 0 to Thickness.

Thickness [Real]

The line’s thickness as set on the [Thickness] tab.

StrokeLength [Real]

The total length of the stroke being rendered.

ScnPnt [Vector]

The render point in screen space (with Z).

LineOff [Real]

The offset (0 to 1) along the line segment being rendered.

wPnt [Vector]

The world coordinates for the point being rendered.

Time [Real]

Current document time in seconds.

Frame [Real]

Current frame.

FPS [Long]

Frames per second.

LineStart [Vector]

The screen space coordinates for the start of the line (LineOff = 0 at the LineStart, 1 at LineEnd).

LineEnd [Vector]

Screen space for line segment’s end point.

JoinAngleA [Real]

Join angle to the line segment at LineStart (if available, or 0.0).

JoinAngleB [Real]

Join angle (0 to 2*pi) to the line segment at LineEnd.

LineNormal [Vector]

The line normal in screen space (2D, Z=0).

EdgeNormal [Vector]

The normal from the edge that created the original line segment.

LinePosA [Real]

The line segment’s position along the stroke in pixels (A means LineStart, B LineEnd).

LinePosB [Real]

The position along the stroke in screen space for the line segment being rendered.

PntA [Long]

The index number of the object point or spline point that created the start of the line segment (or -1 if not available).

PntB [Long]

The point index that created the LineEnd (or -1).

PolyA [Long]

The polygon index that created the line segment (or -1 if not available, like a spline).

PolyB [Long]

The polygon index that shared the edge (or -1 if not available).

RayBits [Long]

This passes in the raybits from the Cinema 4D render. See the Cinema 4D SDK.

CosC [Real]

The angle between the ray and normal on the surface.

Normal [Vector]

The normal from the surface (if PolyHit is not 0, which says it hit an object).

BumpNormal [Vector]

Bumped surface normal.

Dist [Real]

Distance to the point hit on the surface (if one was hit).

PolyHit [Long]

Really only useful to know if an object was hit by a ray, which means the value is not 0.

RayPos [Vector]

World position for the ray’s starting point.

RayDirn [Vector]

Direction of the ray (the ray is from Cinema 4D).

SurfPnt [Vector]

The world coordinates for the point hit (if one was hit).

RendLeft [Real]

The render image left pixel.

RendTop [Real]

Render top pixel (left, top usually 0, but not always, e.g render region).

RendRight [Real]

Right pixel (width = right-left+1).

RendBottom [Real]

Bottom pixel (height = bottom - top +1).

ObjLeft [Real]

Object’s left screen bounds pixel. This is for the object that the line came from. This is not necessarily the object hit by the Cinema 4D ray.

ObjTop [Real]

Object’s top screen bounds pixel.

ObjRight [Real]

Object’s right screen bounds pixel.

ObjBottom [Real]

Object’s bottom screen bounds pixel.

Color [Vector]

The color set in the [Color] tab (Color parameter only).

 Distance

Original, color, thickness, opacity, all three

The Distance modifier changes the color, thickness or opacity of lines in relation to their distance from the camera.

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Range

The Range setting defines the range over which the color, thickness or opacity is modified.

Object

This range is from the part of the object nearest the camera to the part furthest away.

Camera

This uses the camera’s Front Blur End and Rear Blur End values (Depth tab) when you enable them. If the options are disabled then Sketch and Toon will use the Target Distance in place of Rear Blur End and the Camera in place of Front Blur End.

Custom

When you select the Custom range, you will see the Min and Max boxes appear. These define the start and end of the range as distances from the camera.

Mode

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

Invert
Spline

Min [0..+∞m]
Max [0..+∞m]

 Position

From left to right: Original, color. thickness, opacity, all three

The Position modifier modifies the color, thickness or opacity based on the object’s scale along an axis.

Material Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Axis

Axis represents the camera axis to use. The Min and Max values define range over which the parameter is modified. For example, if Axis is set to Z and Min and Max are set to 500 m and 1000 m respectively, the range is from 500 m to 1000 m along the camera’s Z axis.

Mode

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

Invert
Spline

Min [0..+∞m]

See axis.

Max [0..+∞m]

 Scale

The Scale modifier modifies the color, thickness or opacity based on the object’s scale along an axis.

From left to right and top to bottom: Original, color, thickness, opacity, all three

This modifier is based on the scale — not the size — of the objects!

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Axis

Defines which axis (X, Y or z Z) should be used.

Coordinates

The Coordinates setting lets you choose whether this axis is an object axis (Local) or world axis (World). For example, if you set Axis to Y and Coordinates to Local, the lines will be modified based on the scale of the object’s Y axis.

Range

Tip:
A custom range is always used on the Color tab. Set the range using the Min and Max boxes.

This is the range of scales over which the parameter is modified. If Range is set to Scale, the range is from a scale of 0 to 1. To define your own range, set Range to Custom and enter the minimum and maximum scale into the Min and Max boxes.

Mode

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

Invert
Spline

Min [0..+∞]

This is the area over which the setting will be modified. If the area is set to Size the range will be from 0 to 1. To define an area manually, select Manual and define the area accordingly. Max [0..+∞]

 Along Stroke

Original, color, thickness, opacity, all three.

This modifier modifies color and the thickness and/or opacity based on their position along the strokes.

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Range

The Range setting defines the range over which the color, thickness or opacity is modified.

Line

The range runs from the beginning to the end of the stroke or segment.

Custom

When you select the Custom range, you will see the Min and Max boxes appear. These define the start and end of the range as distances from the camera.

Mode

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

Invert
Spline

Min [0..+∞]

See Range / Custom.

Max [0..+∞]

Loop [0..2147483647]

Defines how often a given line should be repeated.

 Total Length

From left to right and top to bottom:

Original, color, thickness, opacity, all three.

These define the minimum and maximum line length in pixels over which the parameter is modified.

The Total Length modifier modifiers the color, thickness or opacity based on the length of each stroke (or line segment if strokes are disabled).

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Min [0..+∞]

Use this setting to define the minimum line length in pixels over which the setting should be modified.

Max [0..+∞]

Use the Max setting to define the maximum line length in pixels over which the parameter should be modified.

Spline

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

 Facing Angle

From left to right and top to bottom:

Original, color, thickness, opacity, all three.

The Facing Angle modifier modifies the color, thickness or opacity based on the direction in which the lines are facing relative to the camera. Hidden lines are also affected if shown.

Blue visible lines and red hidden lines via the Facing Angle modifier.

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Spline

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

 Join Angle

Tip:
This modifier works with strokes only.

(Original), color, thickness, opacity, all three

The Join Angle modifier modifies the color, thickness or opacity based on the angle of the joints in the stroke.

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Ends

Use this setting to define the look of the line tips.

No Change

When in this mode, the parameter’s values will remain unchanged at both start and end of a given line. For example, if Thickness is set to 12 pixels in the Thickness tab the line will be 12 pixels thick at its start and at its end.

Minimum Angle
Zero Angle
Maximum Angle

Depending on the option selected, the line ends will reflect minimum, maximum or zero angle.

Spline

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

 Screen Angle

Original, color, thickness, opacity, all three.

The Screen Angle modifier modifies the color, thickness or opacity based on the line’s direction on the computer screen.

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Spline

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

Rotate [-360..360°]

The Rotate setting lets you rotate the modifier’s effect.

 Vertex Map

Tip:
This modifier is available on the Thickness and Opacity tabs only.

Original, thickness, opacity

The Vertex Map modifier modifies the thickness or opacity based on a vertex map. To choose which vertex map is used, assign a Sketch Style tag to the object if it does not have one already and set the map on the tag’s Maps tab (Drag & drop the tag into the Thickness Map or Opacity Map box).

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

 Texture Map

Texture, color, thickness, opacity, all three

The Texture Map modifier modifies the color, thickness or opacity based on a texture map.

Material Editor Settings

Color tab.

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Texture

Load the texture that should affect the strokes here.

Projection

This is the projection to use for the texture map, such as UVW, Flat or Spherical.

Offset U [-∞..+∞%]

Use this setting to offset scale and texturing in the U direction.

Offset V [-∞..+∞%]

Use this setting to offset scale and texturing in the V direction.

Length U [-∞..+∞%]

Use this setting to offset scale and texturing in the U direction.

Length V [-∞..+∞%]

Use this setting to offset scale and texturing in the V direction.

 Illumination

From left to right and top to bottom: Original illumination, color, thickness, opacity, all three.

The Illumination modifier modifies the color, thickness or opacity based on the illumination falling onto the line.

Material Editor Settings

On the Color tab you can use the modifier in two modes: Intensity and Color.

Spline

Tip
Not all modifiers offer different modes from which to select.

A Distance modifier set to Linear mode in the Thickness tab. The graph controls the thickness of the line in relation to its distance from the camera.

Spline mode for the Thickness Tab’s Distance modifier. In the image above, the graph defines the thickness of the line in accordance with its distance from the camera.

Use this mode to define how thickness or opacity should influence a particular area. The Linear mode mixes line thickness or opacity evenly over a given area. The Invert option will reverse the direction of the mixing. If, on the other hand, you set Mode to Spline, a spline graph will appear in which you can draw a gradient that will influence thickness and opacity. The X axis represents the area from start to end of a given line, the Y axis represents its thickness or opacity.

Invert

Mode

Use this field to define whether the lights placed into this field should be included or excluded from a given effect.

Lighting

Use Lighting to choose whether the lighting, shadows or both are used to modify the parameter.

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Lights

Drag lights that should be included in rendering into this field.

 Noise

Original, color, thickness, opacity, all three.

The Noise modifier modifies the color, thickness or opacity based on a noise pattern.

Material Editor Settings

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Type

Choose from 30 types of noise such as Blistered Turbulence, Dents and Wavy Turbulence. These are the same types that are available for Cinema 4D’s Noise shader. Read more here.

Mapping

This selection menu defines the coordinates that will be used to generate the noise. This can affect to the look of the noise, how it changes according to the camera’s movement or whether or not it continues in line segments once Strokes has been deactivated.

Line, Line 1D, Line 2D

Strokes disabled (left) and enabled (right).

This modifier uses the position along the line. Avoid using this type if strokes are disabled, otherwise poor results are likely (see left cylinder above).

Screen

The noise is calculated in the space of the screen. The noise will change as the object’s position on the screen changes.

Object

The noise is calculated in object space and remains the same regardless of object and camera moves.

World

The noise is calculated in world coordinates. The noise remains the same if you move the camera but changes if you move the object.

Octaves [1..20]

Controls the number of octaves over which the noise will span.

Scale [0..10000%]

Use this setting to adjust the global expanse of the noise.

Anim Speed [0..+∞]

Use this setting to define the speed of the noise loops in loops per second.

Detail [0..+∞%]

Used for antialiasing. In general, leave the value set to the default of 100% but if the line texture flickers when you animate, try increasing the value. Or if you are rendering a high-res still and you want crisp detail, set the value lower.

Low Clip [0..100%]

The Low Clip value controls the bottom clipping value of the noise; all values below Low Clip will be clipped to zero.

High Clip [0..100%]

The High Clip value controls the top clipping value of the noise; all values above High Clip will be clipped to 100%.

Brightness [-100..100%]

This controls the brightness of the lines as a percentage of the color sampled from the surface. In other words, the higher you set this value, the brighter the lines and the more they blend in with the image.

Contrast [-100..100%]

Use this setting to adjust the overall contrast of the noise. Values greater than 0 will increase contrast, values less than 0 will reduce contrast.

Absolute

If this option is enabled, the noise is absolute, causing it to fold about its midpoint.

Invert

Enable this option to invert the effect.

 Screen Texture

From top to bottom and left to right: Texture, color, thickness, opacity, all three.

The Screen Texture modifier modifies the color, thickness or opacity based on a texture map placed over the entire rendered image (the screen). If the object covers only part of the screen, it will receive only part of the texture.

Material Editor Settings

Texture

Strength [0..10000%]

Defines the strength of the effect. 0% = no influence, 100% = maximum influence.

Offset X [-∞..+∞%]

Use this setting to offset the text origin along the x axis on the screen.

Offset Y [-∞..+∞%]

Use this setting to offset the text origin along the Y axis on the screen.

Length X [-∞..+∞%]

Use this setting to offset scale and texturing in the X direction.

Length Y [-∞..+∞%]

Use this setting to offset scale and texturing in the Y direction.