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

Color

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:

Color

Use this setting to define the common color.

Brightness [0..10000%]

Use this setting to define overall brightness.

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

 Modifiers

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

Activate the desired modifier here:

RELEASE 16

TIP:
C.O.F.F.E.E. scripts from older Projects (prior to R16) will no longer be supported.

 Python

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, using the powerful Python programming language.

Material Editor settings

Blend

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Script

Enter your Python script into the Script field.

Editor...

Enter a script into the Script box or click the Expression Editor button and enter the script into Cinema 4D’s Python 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 modifies the color, thickness or opacity based on distance from the camera.

Material Editor settings

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

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.

Blend

For details on using gradients, see here.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Gradient

Control the shading using a gradient.

Min [0..+∞m]

See Range.

Max [0..+∞m]

See Range.

 Position

Original, Color, Thickness, Opacity, All three

The Position modifier modifies the color, thickness or opacity based on the object’s position along the camera’s X, Y or Z axis.

Material Editor settings

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Axis

The Axis is which 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.

Blend

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Min [0..+∞m]

See Axis.

Max [0..+∞m]

See Axis.

Gradient

Control the shading using a gradient.

 Scale

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

Original, Color, Thickness, Opacity, All three

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

Material Editor settings

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Axis

The Axis setting is which axis to use: X, Y or Z.

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.

Min [0..+∞]

Note:

Use the Min and Max settings to define a color range for the Color tab

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..+∞]

See Min.

Gradient

Control the shading using a gradient.

 Along Stroke

Original, Color, Thickness, Opacity, all three.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Range

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

Line

This range is from the start to end of each stroke (or line segment if strokes are disabled).

Custom

The Custom mode lets you specify the start and end of the range (Min and Max) along the stroke in pixels and the number of times the range is looped (Loop).

Blend

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Min [0..+∞]

See Range.

Max [0..+∞]

See Range.

Loop [0..2147483647]

Defines how often a given line should be repeated.

Gradient

Control the shading using a gradient.

 Facing Angle

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

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Gradient

Control the shading using a gradient.

 Total Length

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

Original, Color, Thickness, Opacity, All three

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

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Min [0..+∞]

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

Max [0..+∞]

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

Gradient

Control the shading using a gradient.

 Join Angle

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

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Ends

The Ends mode controls what happens at the ends of the stroke.

No Change

The very start and end of the stroke use the parameter’s full value. For example, if you are using the Join Angle modifier on the Thickness tab and Thickness is set to 12 pixels, the start and end of the stroke will be 12 pixels thick.

Minimum Angle
Zero Angle
Maximum Angle

Depending on which of these modes you select, the ends are treated as if they are joints of the minimum or maximum angle or of zero angle.

Gradient

Control the shading using a gradient.

 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

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Gradient

Control the shading using a gradient.

Rotate [-360..360°]

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

 From Line

This modifier is available on the Color and Opacity tabs only.

Original, Color, Opacity, Color + Opacity

The From Line modifier modifies the color or opacity based on distance from the line’s edge.

Material Editor settings

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Gradient

Control the shading using a gradient.

 Illumination

Original lighting, 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.

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Mode

Intensity

This mode ignores the gradient and gives you grayscale lines whose brightness depends on the intensity of light falling onto the line. Use the Brightness value to darken or brighten the effect.

Color

The Color mode uses the gradient’s colors. See the example above.

Brightness [0..10000%]

See Mode.

Gradient

Control the shading using a gradient.

Mode

Normally, all lights in a scene will be taken into account. Use the include or exclude modes in the light box to use only selected lights.

Lighting

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

Invert

This inverts the modifier’s effect.

Lights

Here you can choose which lights are used for the illumination. All lights in the scene are used by default. To include or exclude specific lights, set Mode to Include or Exclude and Drag & drop the lights into the Lights box.

 Texture

This modifier is available on the Color and Opacity tabs only.

With the exception of the Python modifier, this is the most powerful modifier in Sketch and Toon. It offers considerable control over the rendering of the lines and enables you to create countless brush effects.

Making a brush with the Texture modifier

Figure 1.

Figure 2.

Figure 3.

Figure 4.

For finishing touches, try fading out the thickness and opacity at the ends of the stroke using the Along Stroke modifier on the Thickness and Opacity tabs (Figure 4, right line).

Material Editor settings

Blend

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Load Brush...

These buttons enable you to load and save the Texture settings for brush-style presets.

Save Brush...

These buttons enable you to load and save the Texture settings for brush-style presets.

Texture

Texture & alpha, Original line, Texture, Texture & Alpha

Here you can choose the main texture and apply an alpha to it.

Alpha

The alpha is available on the Color tab only. Use a normal image for the alpha, not an alpha channel.

Offset U [-100..100%]

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

Offset V [-100..100%]

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

Scale U [0..1000%]

These values offset and scale the texturing in the U and V directions.

Scale V [0..1000%]

These values offset and scale the texturing in the U and V directions.

Spacing [1..1000%]

From left to right: Spacing set to 100%, 200% and 50%.

The default Spacing value of 100% places one texture tile directly after another. Use a higher or lower value to move the tiles apart or overlap them.

Scatter U [0..1000%]

Original, Scatter U, Scatter V, Scatter U & V, Count = 8

The Scatter values scatter the tiles in the U and V directions. 0% means no variation, 100% means maximum variation.

Scatter V [0..1000%]

The Scatter values scatter the tiles in the U and V directions. 0% means no variation, 100% means maximum variation.

To mix in extra tiles, increase the Count value. For example, change the Count value from 1 to 3 for three times as many tiles.

Parts of the texture that are not on the line will be cut off. See the middle line below.

Count [0..100]

See Scatter U, Scatter V, Count.

Variation [0..100%]

Varies the count value.

Size [1..1000%]

From left to right: Size set to 100%, 50% and 25%.

The Size controls the scale of the tiles. The Variation value lets you vary the size of each tile from 0% (no variation) to 100% (maximum variation).

Variation [0..100%]

See Size.

Roundness [1..1000%]

From left to right: Roundness set to 100%, 35% and 200%.

The Roundness value squashes (less than 100%) or stretches (greater than 100%) the tiles in the line’s U direction. The Variation value varies the roundness of each tile from 0% (no variation) to 100% (maximum variation).

Variation [0..100%]

See Roundness.

Angle [0..360°]

This value rotates each tile.

Variation [0..100%]

The Variation value varies the angle of each tile from 0% (no variation) to 100% (maximum variation).

Aspect

Aspect disabled (left) and enabled (right).

If the Aspect option is disabled, the texture tile is stretched to fit the whole line. Enable the option to use the texture’s width to height ratio instead.

Tile

Tile disabled (left) and enabled (right).

To tile the texture, enable the Tile option and ensure the Aspect option is disabled.

Bend

Bend disabled (left) and enabled (right).

Enable the Bend option if you want the tiles rotate to follow the direction of the line.

 From Surface

This modifier is available on the Color tab only.

Original, Normal lines, From Surface enabled

The From Surface modifier modifies the color of the line based on the color of the surface.

Material Editor settings

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Brightness [0..10000%]

33%, 66%, 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.

Illumination

These options control whether illumination and shadows are included when the surface is sampled.

Note that this and the next option only work if the Sketch and Toon render settings’ Object setting is set to Off.

Shadows

Use this setting to determine whether or not shadows should be included when using a surface to define a color.

 Texture Map

The object must have a Texture tag with a material assigned for this modifier to have an effect.

The 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.

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Texture

This is the texture used to modify the lines.

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.

 Screen Texture

The 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

Blend

For details on using gradients, see your Cinema 4D reference manual.

The Blend setting defines which blend mode is used to mix the gradient with the main color: Add, Subtract or Multiply. If you want the result to be the same color as the gradient, set the main color to black and the Blend mode to Add.

With Color set to black and Mode set to Add, the gradient’s colors are applied directly to the line.

For details on the blend modes, look up blend modes.

Strength [0..10000%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

Texture

Here you can choose the screen texture.

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.

 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%]

This is the strength of the modifier’s effect, from 0% (no effect) to 100% (full effect).

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.

Mapping

The Mapping drop-down list controls which coordinates are used to generate the noise. This can affect how the noise looks, how it changes as the object or camera moves and whether the noise is continuous over line segments if strokes are disabled.

Line 1D
Line 2D

Strokes disabled (left) and enabled (right).

The position along the line is used. 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 is 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.

Mode

The Mode setting defines whether the noise uses the RGB color system or the HSV color system to modify the color. The three boxes below the Mode setting define how strongly the noise affects each color component (R,G and B or H, S and V depending on the mode).

R [0..100%]

See Mode.

G [0..100%]

See Mode.

B [0..100%]

See Mode.

H [0..100%]

See Mode.

S [0..100%]

See Mode.

V [0..100%]

See Mode.

Anim Speed [0..+∞]

The rate at which the noise animates, in cycles per second.

Octaves [1..20]

The octaves of detail in the noise.

Scale [0..10000%]

The Scale value is the global size of the noise, the Scale X and Scale Y values are the relative scale of the noise in the X and Y directions.

Scale X [0..10000%]

See Scale.

Scale Y [0..10000%]

See Scale.

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%]

These settings control the overall brightness and contrast of the noise. Values above zero increase brightness or contrast, values below zero decrease brightness or contrast.

Contrast [-100..100%]

See Brightness.

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.