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

Opacity

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:

Opacity [0..10000%]

Use this setting to define the overall opacity.

Link to Thickness

The Opacity tab has a Link To Thickness option which enables you to use the same modifier settings for thickness and opacity. Instead of setting the modifiers on both tabs, set them on the Thickness tab only and enable the Link To Thickness option on the Opacity tab.

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

Vertex Map

Texture Map

Screen Texture

Along Stroke

Total Length

Facing Angle

Join Angle

Screen Angle

From Line

Python

Noise

Activate the desired modifier here:

 Python

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

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 C.O.F.F.E.E. modifier enables you to create virtually any medium or style, from a simple pencil to a complex brush, using the powerful C.O.F.F.E.E. programming language.

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

Mode

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

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

See alsoMode.

Min [0..+∞m]

See Mode.

Max [0..+∞m]

See Mode.

Spline

See Mode.

 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

Defines which camera axis should be used.

Mode

See Distance / Mode.

Invert

See Distance / Mode.

Min [0..+∞m]

The Min and Max values define the range over which the parameter will be modified. If, for example, the Z axis was selected and Min and Max were set to 500 and 1000 respectively, the range will span from 500 to 1000 units along the camera’s Z axis.

Max [0..+∞m]

Spline

See Distance / Mode.

 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

Strength [0..10000%]

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

Axis

The Axis setting determines which axis will be used: X, Y or Z. 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.

Coordinates

See ”Axis".

Range

(only in thickness and opacity tabs)

Note
A color tab always used an individual range. Define the range using the min. and max. values.

This is the scale of the range over which a parameter is modified. If range is set to scale the scale range will stretch from 0 to 1. In order to define an individual range, select the manual setting and set enter a value for min. and max. ranges.

Mode

See Distance / Mode.

Invert

Enable this option to invert the effect.

Min [0..+∞]

See Range.

Max [0..+∞]

See Range.

Spline

See Distance / Mode.

 Along Stroke

Original, Color, Thickness, Opacity, All three

The Along Stroke modifier modifies the color, thickness or opacity based on position along the stroke.

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.

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.

Line

This setting rages from start to end of a given stroke. If stroke is deactivated, this range will apply to the length of a stroke segment)

Mode

See Distance / Mode.

Invert

See Distance / Mode.

Min [0..+∞]

See ”Range".

Max [0..+∞]

See ”Range".

Spline

See Distance / Mode.

 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

Strength [0..10000%]

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

Min [0..+∞]

Use the min. and max. settings to define the minimum and maximum stroke length, in pixels, along which a parameter should be modified.

Max [0..+∞]

See ”Min".

Spline

See Distance / Mode.

 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

Strength [0..10000%]

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

Spline

See Distance / Mode.

 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

Strength [0..10000%]

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

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

See Distance / Mode.

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

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

Spline

See Distance / Mode.

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

Strength [0..10000%]

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

Spline

See Distance / Mode.

 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.

Material Editor settings

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.

Strength [0..10000%]

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

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.

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

Count [0..100]

See ”Scatter U", ”Scatter V", ”Count".

Variation [0..100%]

Use this setting to define the degree of deviation allowed from the set value (0%=no deviation; 100%=maximum deviation).

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.

Invert

The texture (left) and Invert disabled (center) and enabled (right).

Enable the Invert option to invert the texture’s effect. Transparent parts become opaque and vice versa.

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.

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

 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

Texture

Select a Screen Texture here.

Strength [0..10000%]

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

Offset X [-∞..+∞%]

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

Offset Y [-∞..+∞%]

See ”Offset X".

Length X [-∞..+∞%]

See ”Offset X".

Length Y [-∞..+∞%]

See ”Offset Y".

 Vertex Map

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

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

 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.

Strength [0..100%]

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

Texture

Load the texture that should affect the strokes here.

Projection

Note:
Please refer to your Cinema 4D reference manual for details concerning the various projection modes.

Use this setting to define the type of projection for your texture, e.g., UVW, flat or spherical.

Offset U [-∞..+∞%]

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

Offset V [-∞..+∞%]

See ”Offset U".

Length U [-∞..+∞%]

See ”Offset U".

Length V [-∞..+∞%]

See ”Offset U".

 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.

Spline

Using the spline, the strength of opacity can be adjusted via the illumination intensity.

Mode

Use this setting to define (per drag & drop) which lights should be used. Normally, all lights in a scene will be used. In order to use only selected lights or to exclude lights, use the include or exclude modes accordingly.

Lighting

Use this setting to define whether the modification should use lighting, its shadow or both.

Invert

Enable this option to invert a given effect.

Strength [0..10000%]

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

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

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

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

This setting shows the noise’s global expanse. The scale X and scale Y values are the noise’s relative scale values in the X and Y directions.

Scale X [0..10000%]

See ”Scale".

Scale Y [0..10000%]

See Scale.

Anim Speed [0..+∞]

Use this setting to define, in cycles per second, the speed with which the noise cycles should move.

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

Use this setting to define lowest the point at which the noise will be cut off. All lesser values will be set to 0.

High Clip [0..100%]

Use this setting to define the highest point at which the noise will reach its maximum effect (100%).

Brightness [-100..100%]

Use this setting to adjust the brightness of the noise. A value greater than 0 will increase the brightness, a value of less than 0 will lessen the brightness.

Contrast [-100..100%]

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

Absolute

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

Invert

Activate this option to invert the noise.